Datadog de surveillance (version préliminaire publique)

Avec l' Instana, vous pouvez surveiller la plateforme Datadog, qui assure la surveillance de votre infrastructure informatique.

Une fois l'agent hôte Instana installé, le capteur Instana Datadog est automatiquement installé. Vous pouvez consulter les hôtes surveillés par Datadog et leurs métriques associées dans l'interface utilisateur d' Instana, une fois que vous l'avez configuré comme indiqué dans la section « Configuration du capteur Datadog ».

Configuration du capteur « Datadog »

Vous devez configurer le capteur Datadog en indiquant les clés « endpoint » et « API » de l'instance Datadog à laquelle vous souhaitez vous connecter. Le fragment de code suivant montre les zones que vous devez configurer dans le fichier de configuration de l'agent <agent_install_dir>/etc/instana/configuration.yaml:

com.instana.plugin.datadog:
  enabled: true
  endpoint: 'https://api.datadoghq.com'
  api_key: 'redacted'
  application_key: 'redacted'
  poll_rate: 30

Le tableau suivant contient les options de configuration prises en charge:

Nom Type Obligatoire Par défaut Description
enabled booléen Oui false Variable qui contrôle si le détecteur est activé ou non.
endpoint chaîne Oui ND Le point de terminaison du serveur Datadog : API.
api_key chaîne Oui ND La clé « API » utilisée pour se connecter au serveur Datadog.
application_key chaîne Oui ND La clé d'application utilisée pour se connecter au serveur Datadog.
poll_rate entier Non 30 Nombre de secondes entre les requêtes de métrique. Cette durée peut nécessiter un ajustement pour tenir compte des limites de débit imposées par votre noeud final.
target_zone chaîne Non ND Le nom de la zone générique dans laquelle s'affichent les hôtes surveillés par Datadog sur la carte de l'infrastructure d' Instana. S'il n'est pas spécifié, les hôtes sont affichés dans Undefined Zone.

Datadog point de terminaison

Le capteur Instana Datadog utilise l' Datadog API pour collecter des informations sur les hôtes surveillés par Datadog. Le point de terminaison Datadog API est nécessaire pour communiquer avec Datadog. Généralement, le noeud final est https://api.datadoghq.com, mais si, pour une raison quelconque, vous devez vous connecter à une adresse différente, vous pouvez le modifier dans le fichier configuration.yaml .

Datadog API touches

Deux clés d' API s sont nécessaires pour s'authentifier auprès de l' Datadog API. Pour plus d'informations sur la création de la clé d' API et de la clé d'application, consultez la documentation d' Datadog.

Lorsque vous créez votre clé d'application, assurez-vous qu'elle contient les portées suivantes:

  • events_read
  • metrics_read
  • timeseries_query

Affichage des mesures

Pour afficher les métriques, procédez comme suit:

  1. Dans le menu de navigation de l'interface utilisateur d' Instana, sélectionnez « Infrastructure ».
  2. Cliquez sur un hôte surveillé spécifique.

Ensuite, vous pouvez voir un tableau de bord d'hôte distant avec toutes les métriques collectées.

Données de configuration

  • Système d'exploitation (nom, version, architecture et distribution)
  • UC (nombre et type)
  • Mémoire totale
  • Nom d'hôte et nom de domaine complet
  • Capacité du système de fichiers

Métriques de performance

  • % d'utilisation de l'unité centrale
  • Charge UC
  • Utilisation de la mémoire
  • Permutation utilisée (Linux uniquement)
  • Utilisation du système de fichiers utilisé et de l'Inode
  • Octets RX et TX du réseau

Affichage d'événements

Datadog Les événements sont des événements ponctuels, qui n'ont pas de durée. Chaque événement a une gravité d'erreur, d'avertissement ou d'information. Ces événements sont importés dans Instana sous forme de « Issues » (erreurs et avertissements) ou de « Changes » (informations), en fonction de leur gravité.

Pour afficher les événements, procédez comme suit:

  1. Dans le menu de navigation de l'interface utilisateur d' Instana, sélectionnez Événements.
  2. Pour filtrer les événements d'un type spécifique, sélectionnez Changements ou Problèmes.
  3. Pour filtrer les événements importés depuis Datadog, saisissez la requête suivante dans le champ de recherche : entity.remote.host.source:Datadog

Vous verrez alors la liste des événements importés depuis Datadog.

Traitement des incidents

Problèmes liés à la surveillance des agents

Si le capteur Datadog ne parvient pas à communiquer avec le serveur Datadog API, un incident de surveillance de l'agent est créé. Le problème décrit le paramètre de configuration qui peut être incorrect. Par exemple, si le capteur reçoit une erreur 401 ou 403 du type « HTTP » de la part du serveur Datadog, il se peut que la clé API ou la clé d'application soit incorrecte ou ait expiré. Les paramètres de configuration suivants peuvent entraîner des problèmes de surveillance de l'agent:

  • endpoint
  • api_key ou application_key (erreurs HTTP, 401 ou 403)
  • poll_rate ( HTTP 429)

Agent OutOfMemoryError

Si vous êtes connecté à un serveur Datadog qui surveille de nombreux hôtes, il peut être nécessaire d'augmenter la taille du tas JVM de l'agent Instana. Si vous constatez cela OutOfMemoryError dans le journal de l'agent, envisagez d'augmenter la taille maximale du tas de l'agent Instana. Pour plus d'informations, consultez la variable JAVA_OPTS d'environnement dans la référence des variables d'environnement.