Présentation
Ce check recueille les métriques d’observation de systèmes distribués de Linkerd.
Configuration
Installation
Le check Linkerd est inclus avec le package de l’Agent Datadog : vous n’avez donc rien d’autre à installer sur votre serveur.
Configuration
Environnement conteneurisé
Consultez la documentation relative aux modèles d’intégration Autodiscovery pour découvrir comment appliquer les paramètres ci-dessous à un environnement conteneurisé.
Linkerd v1
| Paramètre | Valeur |
|---|
<NOM_INTÉGRATION> | linkerd |
<CONFIG_INIT> | vide ou {} |
<CONFIG_INSTANCE> | {"openmetrics_endpoint": "http://%%host%%:9990/admin/metrics/prometheus"} |
Remarque : il s’agit d’un nouvel exemple de check OpenMetrics par défaut. Si vous avez déjà implémenté cette intégration, consultez l’exemple pour l’ancienne version.
Linkerd v2
| Paramètre | Valeur |
|---|
<NOM_INTÉGRATION> | linkerd |
<CONFIG_INIT> | vide ou {} |
<CONFIG_INSTANCE> | {"openmetrics_endpoint": "http://%%host%%:4191/metrics"} |
Remarque : il s’agit d’un nouvel exemple de check OpenMetrics par défaut. Si vous avez déjà implémenté cette intégration, consultez l’exemple pour l’ancienne version.
Collecte de logs
La collecte des logs est désactivée par défaut dans l’Agent Datadog. Pour l’activer, consultez la section Collecte de logs Kubernetes.
| Paramètre | Valeur |
|---|
<CONFIG_LOG> | {"source": "linkerd", "service": "<NOM_SERVICE>"} |
Pour augmenter le niveau de détail des logs de plan de données, consultez la section Modification du niveau des logs de proxy (en anglais).
Validation
Lancez la sous-commande status de l’Agent et cherchez linkerd dans la section Checks.
Données collectées
Métriques
Consultez le fichier metadata.csv pour découvrir la liste des métriques fournies par cette intégration.
Pour Linkerd v1, consultez le guide sur les métriques finable (en anglais) et ce gist pour visualiser un exemple des métriques exposées par Linkerd.
Remarque : certaines métriques peuvent ne pas être exposées par Linkerd selon sa configuration.
Pour afficher la liste des métriques exposées par votre configuration actuelle, exécutez :
curl <endpoint_prometheus_linkerd>
linkerd_prometheus_endpoint correspond au endpoint Prometheus de Linkerd. Vous devez utiliser la même valeur que la clé de configuration prometheus_url dans votre fichier linkerd.yaml.
Si vous souhaitez utiliser une métrique qui n’est pas fournie par défaut, vous pouvez ajouter une entrée dans linkerd.yaml.
Suivez simplement les exemples fournis dans la configuration par défaut.
Checks de service
linkerd.prometheus.health
Returns CRITICAL if the agent fails to connect to the prometheus endpoint, otherwise OK.
Statuses: ok, critical
Dépannage
Besoin d’aide ? Contactez l’assistance Datadog.
