Nota: El check de Docker Daemon todavía se mantiene, pero solo funciona con el Agent v5.

Información general

Configura este check del Agent para obtener métricas del servicio de Docker_daemon en tiempo real para lo siguiente:

• Visualizar y monitoritorizar los estados de Docker_daemon.
• Recibir notificaciones sobre las conmutaciones por error y eventos de Docker_daemon.

Configuración

Instalación

Para recopilar métricas de Docker sobre todos tus contenedores, ejecuta un Datadog Agent en cada host. Hay dos formas de ejecutar el Agent: directamente en cada host o en un contenedor de docker-dd-agent (recomendado).

Para cualquiera de las opciones, tus hosts necesitan una gestión de memoria de grupo activada para que el check de Docker tenga éxito. Consulta el repositorio docker-dd-agent para saber cómo activarla.

Instalación del host

1. Asegúrate de que Docker se esté ejecutando en el host.
2. Instala el Agent tal y como se describe en las instrucciones de instalación del Agent para tu sistema operativo del host.
3. Activa el ícono de integración de Docker en la aplicación.
4. Añade el usuario del Agent al grupo Docker: usermod -a -G docker dd-agent
5. Crea un archivo docker_daemon.yaml copiando el archivo de ejemplo en el directorio Agent conf.d. Si tienes una instalación estándar de Docker en tu host, no debería haber nada que necesites cambiar para que la integración funcione.
6. Para activar otras integraciones, utiliza docker ps para identificar los puertos utilizados por las aplicaciones correspondientes.

Instalación del contenedor

1. Asegúrate de que Docker se esté ejecutando en el host.

2. Según las instrucciones de instalación del contenedor de Docker, ejecuta lo siguiente:

    docker run -d --name dd-agent \
      -v /var/run/docker.sock:/var/run/docker.sock:ro \
      -v /proc/:/host/proc/:ro \
      -v /sys/fs/cgroup/:/host/sys/fs/cgroup:ro \
      -e API_KEY={YOUR_DD_API_KEY} \
      datadog/docker-dd-agent:latest
   

En el comando anterior, puedes pasar tu clave de la API al Datadog Agent utilizando la marca de la variable de entorno -e de Docker. Otras variables son:

Nota: Añade --restart=unless-stopped si quieres que tu Agent sea resistente a los reinicios.

Ejecutar el contenedor del Agent en Amazon Linux

Para ejecutar el contenedor del Datadog Agent en Amazon Linux, haz este cambio en la localización de montaje de volumen cgroup:

docker run -d --name dd-agent \
  -v /var/run/docker.sock:/var/run/docker.sock:ro \
  -v /proc/:/host/proc/:ro \
  -v /cgroup/:/host/sys/fs/cgroup:ro \
  -e API_KEY={YOUR API KEY} \
  datadog/docker-dd-agent:latest

Contenedor basado en Alpine Linux

La imagen estándar de Docker está basada en Debian Linux, pero a partir del Datadog Agent v5.7, existe una imagen basada en Alpine Linux. La imagen Alpine Linux es considerablemente más pequeña que la imagen tradicional basada en Debian. También hereda el diseño orientado a la seguridad de Alpine.

Para utilizar la imagen de Alpine Linux, añade -alpine a la etiqueta (tag) de la versión. Por ejemplo:

docker run -d --name dd-agent \
  -v /var/run/docker.sock:/var/run/docker.sock:ro \
  -v /proc/:/host/proc/:ro \
  -v /sys/fs/cgroup/:/host/sys/fs/cgroup:ro \
  -e API_KEY={YOUR API KEY} \
  datadog/docker-dd-agent:latest-alpine

Versión de imágenes

A partir de la versión 5.5.0 del Datadog Agent, la imagen de Docker sigue un nuevo patrón de versión. Esto permite a Datadog publicar cambios en la imagen de Docker del Datadog Agent, pero con la misma versión del Agent.

La versión de la imagen de Docker tiene el siguiente patrón: X.Y.Z donde X es la versión principal de la imagen de Docker, Y es la versión secundaria y Z representa la versión del Agent.

Por ejemplo, la primera versión de la imagen de Docker que incluye el Datadog Agent 5.5.0 es: 10.0.550

Contenedores personalizados e información adicional

Para obtener más información sobre la creación de contenedores personalizados de Docker con el Datadog Agent, la imagen basada en Alpine Linux, el control de versiones, etc., consulta el proyecto docker-dd-agent en Github.

Validación

Ejecuta el subcomando de estado del Agent y busca docker_daemon en la sección Checks.

Agent v6

El último check de Docker se denomina docker y está escrito en Go para aprovechar la nueva arquitectura interna. A partir de la versión 6.0, el Agent ya no carga la el check docker_daemon, aunque siga disponible y se mantenga para el Agent v5. Todas las funciones se portan en la versión >6.0, excepto las obsoletas siguientes:

• Las opciones url, api_version y tags* están obsoletas. Se fomenta el uso directo de las variables de entorno estándar de Docker.
• Las opciones ecs_tags, performance_tags y container_tags están obsoletas. Cada etiquetar relevante se recopila de modo predeterminado.
• La opción collect_container_count para activar la métricadocker.container.count no es compatible. Deben utilizarse docker.containers.running y .stopped.

Algunas opciones se han movido de docker_daemon.yaml al archivo datadog.yaml principal:

• collect_labels_as_tags ha pasado a llamarse docker_labels_as_tags y admite etiquetas (tags) de cardinalidad alta. Conslta los detalles en datadog.yaml.example.
• exclude y include han pasado a denominarse ac_include y ac_exclude. Para que el filtrado sea coherente en todos los componentes del Agent, se ha suprimido el filtrado en etiquetas (tags) arbitrario. Los únicos filtros admitidos en etiquetas (tags) son image (nombre de la imagen) y name (nombre del contenedor). El filtrado de expresiones regulares sigue estando disponible; consulta datadog.yaml.example para ver ejemplos.
• La opción docker_root se ha dividido en dos opciones: container_cgroup_root y container_proc_root.
• exclude_pause_container se ha añadido para excluir los contenedores en pausa en Kubernetes y Openshift (el valor predeterminado es true). Esto evita eliminarlos de la lista por error.

Cambios adicionales:

• La variable de entorno TAGS ha pasado a llamarse DD_TAGS.
• El repositorio de Docker Hub ha cambiado de datadog/docker-dd-agent a datadog/agent.

El comando import convierte el antiguo docker_daemon.yaml en el nuevo docker.yaml. El comando también traslada las configuraciones necesarias de docker_daemon.yaml a datadog.yaml.

Datos recopilados

Métricas

Eventos

La integración de Docker produce los siguientes eventos:

• Eliminar imagen
• Expirar
• Error
• Fallo
• Terminar
• Sin memoria (oom)
• Pausa
• Reiniciar el contenedor
• Reiniciar el Daemon
• Actualización

Checks de servicio

docker.service_up
Returns CRITICAL if the Agent is unable to collect the list of containers from the Docker daemon. Returns OK otherwise.
Statuses: ok, critical

docker.container_health
Returns CRITICAL if a container is unhealthy. Returns OK otherwise or UNKNOWN if the health is unknown.
Statuses: ok, critical, unknown

docker.exit
Returns CRITICAL if a container exited with a non-zero exit code. Returns OK otherwise.
Statuses: ok, critical

Nota: Para utilizar docker.exit, añade collect_exit_codes: true en tu archivo Docker YAML y reinicia el Agent.

Solucionar problemas

¿Necesitas ayuda? Ponte en contacto con soporte técnico de Datadog.

Referencias adicionales

• Compose y el Datadog Agent
• DogStatsD y Docker
• El problema de la monitorización de Docker (serie)
• Cómo monitorizar métricas de recursos de Docker
• Cómo recopilar métricas de Docker
• 8 Datos sorprendentes sobre la adopción de Real Docker
• Monitorizar Docker en AWS ECS
• Adaptar Datadog a Docker
• Monitorizar Docker con Datadog