Utiliza el agente contenedor para rastrear logs del host
Datadog recomienda utilizar STDOUT/STDERR para recolectar logs del contenedor.
Los pods/contenedores no tienen acceso a los archivos del host por defecto, lo que también se aplica a los agentes. Si intentas configurar tu agente contenedor para que recolecte logs de los archivos del host, aparecerá un mensaje de error similar al que se muestra a continuación:
syslog
------
Type: file
Path: /var/log/messages
Status: Error: file /var/log/messages does not exist
Para que el agente contenedor tenga acceso a los archivos del host, monta el archivo o el directorio en agente contenedor. Revisa la lista de configuración de archivos y directorios del agente para saber qué archivo y directorio del host montar según tu sistema operativo.
Aquí hay algunos ejemplos para Kubernetes y Docker:
Para montar los archivos de logs de tu host en el agente contenedor, establece el directorio de logs del host en la sección de volúmenes del manifiesto del agente y el directorio de logs del contenedor en la sección volumeMounts
:
volumeMounts:
- name: customlogs
## El directorio de logs deseado dentro del agente contenedor:
mountPath: /container/var/test-dir/logs/
volumes:
- name: customlogs
hostPath:
## El directorio en el host que contiene los archivos de logs.
path: /var/test-dir/logs/
A continuación, configura el agente para que rastree los archivos para recolectar los logs. Para ello, puedes montar una configuración de logs personalizada en /conf.d/
. El nombre del archivo puede ser cualquier cosa, siempre que tenga una extensión .yaml
.
Es preferible utilizar un ConfigMap para almacenar configuraciones en lugar de montar directamente un archivo del host. Aquí tienes un manifiesto ConfigMap de ejemplo que tiene un archivo logs.yaml
:
kind: ConfigMap
apiVersion: v1
metadata:
name: ddagent-logs-configmap
namespace: default
data:
logs.yaml: |-
logs:
- type: file
service: syslog
source: os
## Utiliza el directorio de registro del contenedor que configuraste en el manifiesto del agente.
path: /container/var/test-dir/logs/*.log
Crea el objeto ConfigMap utilizando el comando:
kubectl create -f <configmap manifest>
A continuación, móntalo en /conf.d/
:
volumeMounts:
- name: cm-logs
mountPath: /conf.d/
volumes:
- name: cm-logs
configMap:
name: ddagent-logs-configmap
Para montar el archivo de log del host, añade un parámetro de volumen en el comando docker run
del agente:
-v /<host log directory>/:<container log directory>/
A continuación, crea localmente una configuración personalizada de logs:
logs:
- type: file
service: syslog
source: os
path: <container log path>/*.log
y móntala en /conf.d/
. El nombre del archivo puede ser cualquiera:
-v <absolute path>/logs.yaml:/conf.d/logs.yaml
Su el comando de instalación de Docker del agente debe tener este aspecto:
docker run -d --name datadog-agent \
--cgroupns host \
--pid host \
-e DD_API_KEY=<DATADOG_API_KEY> \
-e DD_LOGS_ENABLED=true \
-v /var/run/docker.sock:/var/run/docker.sock:ro \
-v /proc/:/host/proc/:ro \
-v /opt/datadog-agent/run:/opt/datadog-agent/run:rw \
-v /sys/fs/cgroup/:/host/sys/fs/cgroup:ro \
-v /<host log directory>/:<container log directory>/ \
-v /<config location>/logs.yaml:/conf.d/logs.yaml \
gcr.io/datadoghq/agent:latest
Verificación
Una vez configurado todo esto, puedes iniciar el agente. Deberías ver algo parecido a lo siguiente cuando lo ejecutes docker exec -it datadog-agent agent status
:
==========
Logs Agent
==========
Sending compressed logs in HTTPS to agent-http-intake.logs.datadoghq.com on port 443
BytesSent: 10605
EncodedBytesSent: 2144
LogsProcessed: 32
LogsSent: 31
logs
----
Type: file
Path: /container/var/test-dir/logs/*.log
Status: OK
1 files tailed out of 1 files matching
Inputs: /container/var/test-dir/logs/722bfb2cb35cc627-json.log
Additional helpful documentation, links, and articles: