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.
Exécutez la commande suivante pour installer l’intégration de l’Agent :
datadog-agent integration install -t datadog-traefik==<INTEGRATION_VERSION>
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
.
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.
La collecte de logs est désactivée par défaut dans l’Agent Datadog. Vous devez l’activer dans datadog.yaml
avec :
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.
Redémarrez l’Agent.
Collecte de traces
- Si besoin, activez l’APM pour Datadog.
- 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
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.
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
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
.
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.
La collecte de logs est désactivée par défaut dans l’Agent Datadog. Vous devez l’activer dans datadog.yaml
avec :
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.
Redémarrez l’Agent.
Collecte de traces
Disponible pour Traefik v1.7+
- Si besoin, activez l’APM pour Datadog.
- 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
Événements
Le check Traefik n’inclut aucun événement.
Checks de service
Dépannage
Besoin d’aide ? Contactez l’assistance Datadog.