Traefik
Rapport de recherche Datadog : Bilan sur l'adoption de l'informatique sans serveur Rapport : Bilan sur l'adoption de l'informatique sans serveur

Traefik

Agent Check Check de l'Agent

Supported OS: Linux Mac OS Windows

Présentation

Cette intégration recueille les données de Traefik afin de vérifier sa santé et de surveiller :

  • Les logs d’erreurs (codes 4xx, codes 5xx)
  • Le nombre de requêtes
  • Le nombre d’octets échangés

Implémentation

Installation

Si vous utilisez la version 6.8 ou ultérieure de l’Agent, suivez les instructions ci-dessous pour installer le check Traefik sur votre host. Consultez notre guide relatif à l’installation d’intégrations développées par la communauté pour installer des checks avec une version < 6.8 de l’Agent ou avec l’Agent Docker :

  1. Installez le kit de développement.
  2. Clonez le dépôt integrations-extras :

    git clone https://github.com/DataDog/integrations-extras.git.
  3. Mettez à jour votre configuration ddev avec le chemin integrations-extras/ :

    ddev config set extras ./integrations-extras
  4. Pour générer le paquet traefik, exécutez :

    ddev -e release build traefik
  5. Téléchargez et lancez l’Agent Datadog.

  6. Exécutez la commande suivante pour installer le wheel de l’intégration à l’aide de l’Agent :

    datadog-agent integration install -w <PATH_OF_TRAEFIK_ARTIFACT_>/<TRAEFIK_ARTIFACT_NAME>.whl
  7. Configurez votre intégration comme n’importe quelle autre intégration du paquet.

Configuration

  1. Modifiez le fichier traefik.d/conf.yaml dans le dossier conf.d/ à la racine du répertoire de configuration de votre Agent pour commencer à recueillir vos métriques et logs Traefik. Consultez le fichier d’exemple traefik.d/conf.yaml pour découvrir toutes les options de configuration disponibles.

  2. Redémarrez l’Agent.

Collecte de métriques

Ajoutez cette configuration à votre fichier traefik.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.

Collecte de logs

Disponible à partir des versions > 6.0 de l’Agent

Par défaut, les logs Traefik sont envoyés à stdout. Nous déconseillons de passer à la version conteneurisée, car l’Agent Datadog peut recueillir directement les logs à partir des stdout/stderr du conteneur.

Pour configurer Traefik et activer l’écriture des logs dans un fichier, ajoutez le code suivant dans le fichier de configuration de Traefik :

[traefikLog]
  filePath = "/chemin/vers/traefik.log"

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

  1. 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
  2. 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.

  3. Redémarrez l’Agent.

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.

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

Lorsque vous interrogez Traefik, le code de statut renvoyé doit être 200.

Développement

Consultez la documentation principale sur les outils de développement pour découvrir comment tester et développer des intégrations reposant sur l’Agent.