Configuración de los archivos de registro recogidos por el agente

Al desplegar o actualizar el agente de Logging, puede configurar el archivo logs-values.yaml para incluir y excluir el conjunto de logs que debe procesar el agente. Por defecto, el agente recopilará los registros de /var/log/containers/*.log e ignorará /var/log/at/*.

Después de modificar el logs-values.yaml, puede Actualizar el agente o seguir modificando el archivo antes de aplicar todos los cambios.

Configuración de archivos de registro personalizados

Se pueden proporcionar las siguientes variables adicionales para incluir y excluir el conjunto de logs a procesar por el agente:

excludeLogSourcePaths: Lista de ficheros que el agente está configurado para ignorar. El valor predeterminado es ignorar /var/log/at/*
selectedLogSourcePaths: Lista de ficheros que el agente recoge y envía a IBM Cloud Logs. El valor predeterminado se establece en /var/log/containers/*.log. Puede definir varias rutas utilizando una lista separada por comas, por ejemplo /var/log/abc/*.log,/var/log/xyz/*.log.

La entrada en el archivo logs-values.yaml tiene el siguiente aspecto:

# comma separated list, for example “/var/log/abc/*.log,/var/log/xyz/*.log”
excludeLogSourcePaths: ""
selectedLogSourcePaths: ""

Configuración de los registros de los componentes del sistema

Los registros de los componentes del sistema registran los eventos que se producen en el clúster. Existen dos tipos de componentes del sistema: los componentes del sistema que se ejecutan en un contenedor y los componentes del sistema que intervienen directamente en la ejecución de los contenedores. Por ejemplo, el kubelet y el tiempo de ejecución del contenedor no se ejecutan en contenedores. El programador Kubernetes, el gestor de controladores y el servidor API se ejecutan dentro de pods. Si su clúster utiliza kube-proxy, normalmente lo ejecutará como DaemonSet.

Utilice la opción systemLogs para habilitar el procesamiento de los registros de los componentes del sistema que se encuentran en el directorio /var/log. Los registros del sistema en /var/log/containers/ se recopilan automáticamente a menos que los excluya en la sección excludeLogSourcePaths.

La entrada en el archivo logs-values.yaml tiene el siguiente aspecto:

systemLogs:
  - /var/log/kube-apiserver.log. # Logs generated by the API server.
  - /var/log/kube-scheduler.log # Logs generated by the scheduler. This component is responsible for making scheduling decisions.
  - /var/log/kube-controller-manager.log # Logs generated by the Kube controller manager that runs most Kubernetes built-in controllers.
  - /var/log/kube-proxy.log  # Logs generated by the kube-proxy. This component is responsible for directing traffic to Service endpoints.
  - /var/log/kubelet.log  # Logs generated by the kubelet. This component is responsible for running containers on the node.
  - /var/log/syslog

Por defecto, se utiliza el analizador kube_syslog.

Algunos de los clústeres clásicos de Kubernetes pueden requerir que systemLogsParser se establezca en kube_syslog_classic para que coincida con el formato de fecha y hora de esos sistemas. Puede utilizar la opción systemLogsParser para considerar un analizador sintáctico diferente. La entrada en el archivo logs-values.yaml tiene el siguiente aspecto:

systemLogsParser: "kube_syslog_classic"
systemLogs:
  - /var/log/syslog