Surveillance de Traefik
Le capteur Traefik est automatiquement déployé et installé une fois que vous avez installé l'agent Instana.
Instana a la capacité de collecter à la fois les métriques et les traces distribuées de demandes qui passent par Traefik.
Informations de support
Pour vous assurer que le capteur Traefik est compatible avec votre configuration actuelle, consultez les sections d'informations d'assistance suivantes :
Versions prises en charge et politique d'assistance
Le tableau suivant présente la dernière version prise en charge et la politique d'assistance :
| Technologie | Politique de support | Dernière version technologique | Dernière version prise en charge |
|---|---|---|---|
| Traefik | A la demande | 3.4.1 | 3.4 |
Pour plus d'informations sur la politique d'assistance, consultez la section « Stratégie d'assistance pour les capteurs ».
Configuration d'agent
Vous pouvez configurer les champs suivants dans le fichier de configuration de l'agent :
com.instana.plugin.traefik:
enabled: true
poll_rate: 1 # seconds
Configuration
Collecte des métriques
Pour consulter les métriques, sélectionnez « Infrastructure » dans la barre latérale de l'interface utilisateur d' Instana, cliquez sur un hôte surveillé spécifique, puis vous verrez s'afficher un tableau de bord de l'hôte contenant toutes les métriques collectées et les processus surveillés.
Données de configuration
- PID
- Version
- Heure de début
Métriques de performance
| Métrique | Description | Granularité |
|---|---|---|
| Demandes HTTP par seconde | Demandes HTTP par seconde | 1 seconde |
| Succès du dernier rechargement de la configuration | Heure du dernier rechargement de la configuration réussi | 1 seconde |
| Nombre de rechargements de configuration | Nombre de rechargements de configuration par seconde | 1 seconde |
| Points d'entrée | Demandes HTTP par seconde par point d'entrée | 1 seconde |
Activation de la collecte des métriques
Pour activer la collecte de mesures à partir de l'application Traefik, elle doit exposer un noeud final avec des mesures Prometheus. Il existe plusieurs façons de le faire :
- Utilisation d'un fichier de configuration (format YAML ou TOML)
- définition des variables d'environnement
- Ajout d'arguments de ligne de commande
Par exemple, les lignes suivantes du fichier de configuration exposeront les métriques sur :8888/metrics:
#config.yaml
entryPoints:
metrics:
address: ":8888"
metrics:
prometheus:
entryPoint: metrics
Le noeud final de mesures doit être accessible à partir de l'agent Instana.
D'autres exemples sont disponibles sur le site Webde Traefik.
Activation du traçage
Pour activer le traçage dans l'application Traefik, il doit être configuré. Il existe plusieurs façons de le faire :
- Utilisation d'un fichier de configuration (format YAML ou TOML)
- définition des variables d'environnement
- Ajout d'arguments de ligne de commande
Par exemple :
#config.yaml
tracing:
instana: {}
L'agent Instana doit être accessible à partir de l'application Traefik.
D'autres exemples sont disponibles sur le site Web de Traefik [ site Web ]https://doc.traefik.io/traefik-enterprise/operations/metrics/instana/).
Tableau des versions de Traefik Helm
Pour utiliser le graphique officiel « Helm » de Traefik Proxy, vous devez définir explicitement une configuration permettant d'activer le traçage de l' Instana et d'exposer les métriques « Prometheus » de Traefik, comme suit :
helm install \
--set="additionalArguments={--tracing.instana=true}" \
--set ports.metrics.port=8080 \
--set ports.metrics.exposedPort=8080 \
traefik \
traefik/traefik
Traitement des incidents
Type de problème de surveillance : traefik_metrics_api_not_accessible
Pour résoudre ce problème, reportez-vous aux étapes décrites dans la rubrique Activation de la collecte de métriques pour savoir comment configurer l'application Traefik afin d'exposer le noeud final de métriques.
Type de problème de surveillance : traefik_metrics_api_not_enabled
Pour résoudre ce problème, reportez-vous aux étapes décrites dans la rubrique Activation de la collecte de métriques pour savoir comment configurer l'application Traefik afin d'exposer le noeud final de métriques.
Type de problème de surveillance : traefik_tracing_not_enabled
Pour résoudre ce problème, reportez-vous aux étapes décrites dans Activation de la fonction de trace pour savoir comment activer la fonction de trace dans l'application Traefik.