Traefik

Supported OS Linux Windows Mac OS

Integration version1.1.0

Información general

Envía métricas, logs y trazas (traces) de Traefik a Datadog para monitorizar tus servicios de Traefik.

Configuración

El check de Traefik no está incluido en el paquete del Datadog Agent, por lo que es necesario instalarlo.

Instalación

Para Agent v7.21+/v6.21+, sigue las instrucciones a continuación para instalar el check de Traefik en tu host. Consulta Uso de integraciones de la comunidad para instalar con el Docker Agent o versiones anteriores del Agent.

  1. Ejecuta el siguiente comando para instalar la integración del Agent:

    datadog-agent integration install -t datadog-traefik==<INTEGRATION_VERSION>
    
  2. Configura tu integración como si fuese una integración de base.

Configuración

Acerca de v2

Para obtener información sobre los cambios de la v1 a la v2, consulta la Guía de migración de Traefik. Para obtener información sobre la última versión, consulta la documentación de Traefik.

Recopilación de métricas

Sigue la documentación de Traefik para enviar métricas de Traefik a Datadog.

APM

Disponible para el Agent >6.0

Por defecto, los logs de Traefik se envían a stdout. Esto no debe cambiarse para la versión en contenedores, porque el Datadog Agent puede recopilar logs directamente desde el contenedor stdout/stderr.

  1. Para configurar Traefik para loguear en un archivo, añade lo siguiente en el archivo de configuración de Traefik:

    [traefikLog]
      filePath = "/path/to/traefik.log"
      format   = "json"
    

    El formato común de Apache Access se utiliza por defecto y es compatible con esta integración.

  2. La recopilación de logs está desactivada por defecto en el Datadog Agent . Habilítala en tu archivo datadog.yaml con:

    logs_enabled: true
    
  3. Añade este bloque de configuración a tu archivo traefik.d/conf.yaml en la raíz de tu directorio de configuración del Agent para empezar a recopilar tus logs de Traefik:

    logs:
      - type: file
        path: /path/to/traefik.log
        source: traefik
        service: traefik
    

    Cambia los valores de los parámetros path y service y configúralos para tu entorno.

  4. Reiniciar el Agent

Recopilación de trazas

  1. Activa APM para Datadog, si es necesario.
  2. Sigue la documentación de Traefik para enviar trazas (traces) a Datadog.

Acerca de v1

Consulta la documentación de Traefik para obtener información sobre v1. Para obtener información sobre los cambios de v1 a v2, consulta la guía de migración de Traefik.

Recopilación de métricas

  1. Para recopilar métricas de Traefik, abre el archivo traefik.d/conf.yaml en la carpeta conf.d/ en la raíz de tu directorio de configuración del Agent.

  2. Añade esta configuración a tu archivo traefik.d/conf.yaml para empezar a recopilar tus métricas:

    init_config:
    
    instances:
      - host: 10.1.2.3
        port: "8080"
        path: "/health"
        scheme: "http"
    

    Opciones de configuración:

    • host: endpoint de Traefik para consultar. Obligatorio
    • puerto: oyente de API del endpoint de Traefik. Valor por defecto 8080. Opcional
    • ruta: ruta del endpoint del check de estado de Traefik. Por defecto /health. Opcional
    • esquema: esquema del endpoint del check de estado de Traefik. Por defecto http. Opcional
  3. Reinicia el Agent para empezar a enviar métricas de Traefik a Datadog.

Consulta el traefik.d/conf.yaml de ejemplo para conocer todas las opciones disponibles de configuración.

APM

Disponible para el Agent >6.0

Por defecto, los logs de Traefik se envían a stdout. Esto no debe cambiarse para la versión en contenedores, porque el Datadog Agent puede recopilar logs directamente desde el contenedor stdout/stderr.

  1. Para configurar Traefik para loguear en un archivo, añade lo siguiente en el archivo de configuración de Traefik:

    [traefikLog]
      filePath = "/path/to/traefik.log"
      format   = "json"
    

    El formato común de Apache Access se utiliza por defecto y es compatible con esta integración.

  2. La recopilación de logs está desactivada por defecto en el Datadog Agent . Habilítala en tu archivo datadog.yaml con:

    logs_enabled: true
    
  3. Añade este bloque de configuración a tu archivo traefik.d/conf.yaml en la raíz de tu directorio de configuración del Agent para empezar a recopilar tus logs de Traefik:

    logs:
      - type: file
        path: /path/to/traefik.log
        source: traefik
        service: traefik
    

    Cambia los valores de los parámetros path y service y configúralos para tu entorno.

  4. Reiniciar el Agent

Recopilación de trazas

Disponible para Traefik v1.7+

  1. Activa APM para Datadog, si es necesario.
  2. Sigue la documentación de Traefik para enviar trazas a Datadog.

Validación

Ejecuta el subcomando status del Agent y busca traefik en la sección Checks.

Compatibilidad

El check es compatible con las principales plataformas.

Métricas

Para v2, consulta la lista de métricas de Traefik enviadas a Datadog.

Para la v1, consulta la lista de métricas proporcionadas por la integración.

Datos recopilados

Métricas

Eventos

El check de Traefik no incluye ningún evento.

Checks de servicio

Resolución de problemas

¿Necesitas ayuda? Ponte en contacto con el servicio de asistencia de Datadog.