Traefik

Supported OS Linux Mac OS Windows

Intégrationv1.0.0

Présentation

Envoyez des métriques, logs et traces Traefik à Datadog pour surveiller vos services Traefik.

Configuration

Le check Traefik n’est pas inclus avec le package de l’Agent Datadog : vous devez donc l’installer.

Installation

Pour l’Agent v7.21+/6.21+, suivez les instructions ci-dessous afin d’installer le check Traefik sur votre host. Consultez la section Utiliser les intégrations de la communauté pour effectuer une installation avec l’Agent Docker ou avec des versions antérieures de l’Agent.

  1. Exécutez la commande suivante pour installer l’intégration de l’Agent :

    datadog-agent integration install -t datadog-traefik==<INTEGRATION_VERSION>
    
  2. Configurez votre intégration comme une intégration de base.

Procédure à suivre

À propos de la v2

Pour en savoir plus sur les modifications apportées entre la v1 et la v2, consultez le guide de migration de Traefik. Pour en savoir plus sur la dernière version, consultez la documentation de Traefik (en anglais).

Collecte de métriques

Pour envoyer des métriques Traefik à Datadog, consultez la documentation de Traefik.

Collecte de logs

Disponible à partir des versions > 6.0 de l’Agent

Par défaut, les logs Traefik sont envoyés à stdout. Nous vous déconseillons de modifier ce paramètre avec la version conteneurisée, car l’Agent Datadog peut recueillir directement les logs à partir du conteneur stdout/stderr.

  1. Si vous souhaitez configurer Traefik pour que les logs soient écrits dans un fichier, ajoutez le code suivant dans le fichier de configuration de Traefik :

     log:
       filePath: "/path/to/traefik.log"
    

    Le format Apache Access standard est utilisé par défaut et pris en charge par cette intégration.

  2. La collecte de logs est désactivée par défaut dans l’Agent Datadog. Vous devez l’activer dans datadog.yaml avec :

    logs_enabled: true
    
  3. Ajoutez ce bloc de configuration à votre fichier traefik.d/conf.yaml à la racine du répertoire de configuration de votre Agent pour commencer à recueillir vos logs Traefik :

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

    Modifiez les valeurs des paramètres path et service et configurez-les pour votre environnement.

  4. Redémarrez l’Agent.

Collecte de traces

  1. Si besoin, activez l’APM pour Datadog.
  2. Pour envoyer des traces à Datadog, consultez la documentation de Traefik.

À propos de la v1

Pour en savoir plus sur la v1, consultez la documentation de Traefik. Pour en savoir plus sur les modifications apportées entre la v1 et la v2, consultez le guide de migration de Traefik.

Collecte de métriques

  1. Pour recueillir des métriques Traefik, ouvrez le fichier traefik.d/conf.yaml dans le dossier conf.d/ à la racine du répertoire de configuration de votre Agent.

  2. Ajoutez cette configuration à votre fichier traefik.d/conf.yaml pour commencer à recueillir vos métriques :

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

    Options de configuration :

    • host : l’endpoint de Traefik à interroger. Obligatoire
    • port : l’écouteur d’API de l’endpoint Traefik. Valeur par défaut : 8080. Facultatif
    • path : chemin de l’endpoint pour le check de santé de Traefik. Par défaut : /health. Facultatif
    • scheme : schéma de l’endpoint pour le check de santé de Traefik. Valeur par défaut : http. Facultatif
  3. Redémarrez l’Agent pour commencer à envoyer vos métriques Traefik à Datadog.

Consultez le fichier d’exemple traefik.d/conf.yaml pour découvrir toutes les options de configuration disponibles.

Collecte de logs

Disponible à partir des versions > 6.0 de l’Agent

Par défaut, les logs Traefik sont envoyés à stdout. Nous vous déconseillons de modifier ce paramètre avec la version conteneurisée, car l’Agent Datadog peut recueillir directement les logs à partir du conteneur stdout/stderr.

  1. Si vous souhaitez configurer Traefik pour que les logs soient écrits dans un fichier, ajoutez le code suivant dans le fichier de configuration de Traefik :

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

    Le format Apache Access standard est utilisé par défaut et pris en charge par cette intégration.

  2. La collecte de logs est désactivée par défaut dans l’Agent Datadog. Vous devez l’activer dans datadog.yaml avec :

    logs_enabled: true
    
  3. Ajoutez ce bloc de configuration à votre fichier traefik.d/conf.yaml à la racine du répertoire de configuration de votre Agent pour commencer à recueillir vos logs Traefik :

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

    Modifiez les valeurs des paramètres path et service et configurez-les pour votre environnement.

  4. Redémarrez l’Agent.

Collecte de traces

Disponible pour Traefik v1.7+

  1. Si besoin, activez l’APM pour Datadog.
  2. Pour envoyer des traces à Datadog, consultez la documentation de Traefik.

Validation

Lancez la sous-commande status de l’Agent et cherchez traefik dans la section Checks.

Compatibilité

Ce check est compatible avec toutes les principales plateformes.

Métriques

Pour la v2, consultez la liste des métriques Traefik envoyées à Datadog.

Pour la v1, consultez la liste des métriques fournies par l’intégration.

Données collectées

Métriques

traefik.total_status_code_count
(gauge)
total count for each returned status code
traefik.total_count
(gauge)
count total number of requests

Événements

Le check Traefik n’inclut aucun événement.

Checks de service

traefik.check
Returns ok if the Traefik is up, critical when down and unknown when unknown exception occurred.
Statuses: ok, critical, unknown

Dépannage

Besoin d’aide ? Contactez l’assistance Datadog.