Connect à une source de données Datadog

La source de données Datadog vous permet de visualiser les métriques issues du service de surveillance Datadog dans Amazon Managed Grafana.

Note

Cette source de données est réservée à Grafana Enterprise. Pour plus d’informations, consultez Gérer l'accès aux plug-ins d'entreprise.

En outre, dans les espaces de travail qui prennent en charge la version 9 ou une version plus récente, cette source de données peut nécessiter l'installation du plug-in approprié. Pour plus d’informations, consultez Étendez votre espace de travail avec des plugins.

Utilisation

Mise en cache

Pour les grands tableaux de bord qui génèrent de nombreuses requêtes, il est possible que le débit soit limité par l'API Datadog (atteignez le nombre maximum d'appels d'API par heure autorisé par l'API Datadog). La fonctionnalité de mise en cache met en cache les requêtes uniques pendant 60 secondes. Cet intervalle peut être modifié pour être plus ou moins long sur la page de configuration.

Éditeur de requête

C'est simple : sélectionnez l'agrégation et la métrique. Si vous souhaitez filtrer les résultats, sélectionnez une ou plusieurs balises.

La source de données Datadog prend en charge toutes les fonctions avancées prises en charge par l'éditeur de requêtes Datadog. Sélectionnez-la dans la liste déroulante et organisez-la en choisissant un nom de fonction.

Possibilités d'utilisation d'alias par champ :

• Entrez l'alias dans le champ « Alias par ».

• Utilisez des variables délimitées :

  • $__metric= remplacé par le nom de la métrique

  • $__display_name= remplacé par le nom de la métrique

  • $__expression= remplacé par une expression métrique complète

  • $__aggr= remplacé par une fonction d'agrégation métrique (par exemple, avg, max, min, sum)

  • $__scope= remplacé par une portée métrique (par exemple, région, site, environnement, hôte)

• Utilisez des expressions régulières :

  • Entrez votre expression régulière dans le champ RegExp « Alias » au /you regexp here/flags format.

  • Si le champ « Alias par » est vide, RegExp les résultats seront joints en utilisant. Exemple avec expression métrique = avg:system.load.5{*} : Entrée de champ « Alias par » : entrée de champ «" "Alias RegExp » : avg:(.+)\.(\d) Résultat : system.load, 5

  • Utilisez $<group_number> des variables dans le champ « Alias par ». Exemple avec expression métrique = avg:system.load.5{*} : Entrée de champ « Alias par » : entrée de champ $1: $2 seconds RegExp « Alias » : avg:(.+)\.(\d) Résultat : system.load: 5 seconds

  • $0À utiliser pour obtenir l'expression complète. Exemple avec expression métrique = datadog.dogstatsd.packet.count{*} : Entrée de champ « Alias par » : entrée de champ Expression: $0 RegExp « Alias » : DOGstatsd\.(.*)\.(.*){\*}/i Résultat : Expression: datadog.dogstatsd.packet.count{*}

  Remarque : vous obtiendrez un message d'erreur en utilisant un numéro de groupe inexistant.

Arithmétique métrique

Pour utiliser l'arithmétique métrique, définissez le type de requête sur Arithmétique. Créez un lien vers la métrique de votre choix en utilisant le # signe. Par exemple, #A * 2 doublera le résultat de la requêteA. L'arithmétique entre deux mesures fonctionne de la même manière : ajoutez des requêtes contenant les résultats que vous souhaitez utiliser pour le calcul, puis créez un lien vers ces métriques dans la troisième requête, par exemple#A / #B.

Annotations

Une annotation est un événement superposé au-dessus des graphiques. Un déploiement ou une panne en sont un exemple. Cette source de données vous permet de récupérer des événements depuis Datadog et de les superposer à des graphiques dans Amazon Managed Grafana. Les événements d'annotations peuvent être filtrés par source, balise ou priorité.

Création de modèles

Il existe quelques options pour obtenir les valeurs d'une variable de modèle : métriques et tags. Pour récupérer la liste des métriques disponibles, spécifiez * dans le champ Requête.

Pour renvoyer toutes les balises, utilisez la valeur : tag ouscope.

Pour renvoyer des balises pour un groupe de balises spécifié, utilisez l'une des valeurs de catégorie par défaut suivantes :

• host

• device

• env

• region

• site

• status

• version

Pour les groupes de balises personnalisés, entrez simplement le nom du groupe de balises. Par exemple, si le nom de votre groupe de balises personnalisé estsubscription_name, saisissez-le dans le champ Requête.

Filtrez les résultats à l'aide du champ Regex. Les variables à valeurs multiples sont prises en charge lors de l'utilisation de balises : plusieurs valeurs de balises sélectionnées seront converties en une liste de balises séparées par des virgules.

Filtres ad hoc

Il existe un nouveau type spécial de variable de modèle dans Grafana appelé filtres ad hoc. Cette variable s'appliquera à toutes les requêtes Datadog d'un tableau de bord. Cela permet de l'utiliser comme un filtre rapide. Une variable ad hoc pour Datadog récupère toutes les paires clé-valeur des balises, par exempleregion:east, region:west, et les utilise comme balises de requête. Pour créer cette variable, sélectionnez le type de filtre ad hoc et choisissez votre source de données Datadog. Vous pouvez définir n'importe quel nom pour cette variable.