Linkerd

Agent Check Check de l'Agent

Supported OS Linux Mac OS Windows

Integrationv3.1.0
docs>integrations>Linkerd

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.