Linkerd

Agent Check Check de l'Agent

Supported OS Linux Mac OS Windows

Integrationv3.1.0

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

Host

Pour configurer ce check lorsque l’Agent est exécuté sur un host :

  1. Modifiez le fichier linkerd.d/conf.yaml dans le dossier conf.d/ à la racine du répertoire de configuration de votre Agent. Consultez le fichier d’exemple linkerd.d/conf.yaml pour découvrir toutes les options de configuration disponibles. 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.

  2. Redémarrez l’Agent.

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ètreValeur
<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ètreValeur
<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 avec Kubernetes.

ParamètreValeur
<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.