Nouvelles annonces sur les technologies sans serveur et réseau ainsi que sur le RUM (Real-User Monitoring) dévoilées à la conférence Dash ! Nouvelles annonces dévoilées à la conférence Dash !

Template Variables

Les Template Variables de dashboard servent à appliquer un nouveau contexte à un ou plusieurs widgets dans votre dashboard, vous permettant ainsi d’explorer de façon dynamique les métriques associées à différents ensembles de tags en utilisant des variables au lieu de tags spécifiques.

Définir une Template Variable

Une Template Variable sans clé est déjà appliquée sur les nouveaux dashboards. Cliquez sur l’icône en forme de crayon pour ouvrir l’éditeur de Template Variable :

Une fois dans l’éditeur, cliquez sur Add Variable + pour créer votre première Template Variable. Elle est définie par les paramètres suivants :

  • Name *(obligatoire)* : la valeur à afficher pour votre Template Variable dans vos requêtes de graphique.
  • Tag Group *(obligatoire)* : si vos tags respectent les recommandations relatives aux tags et utilisent le format key:value, le Tag Group correspond à la valeur key de vos tags.
  • Default Tag *(facultatif)* : la valeur par défaut pour le Tag Group de votre Template Variable.

Une fois votre Template Variable créée, vous remarquerez que l’interface affiche désormais des statistiques concernant son utilisation dans vos graphiques. Sur l’image ci-dessous, la Template Variable n’est utilisée dans aucun des graphiques du dashboard :

Vous pouvez ajouter cette Template Variable à tous vos widgets de graphique ou la supprimer en cliquant sur les boutons Remove From All et Add to All, respectivement.

Utiliser les Template Variables

Widgets

Une fois votre Template Variable définie, celle-ci apparaît dans les options affichées pour le champ from :

Une fois le graphique enregistré, la valeur de cette Template Variable est sélectionnée en haut de votre dashboard :

Template Variables avec requêtes d’APM et de log

Étant donné que les métriques, les logs et l’APM partagent les mêmes tags, les Template Variables peuvent être utilisées sur les widgets créés à partir de requêtes d’APM et de log. De plus, il est possible de définir des Template Variables de log/d’APM basées sur vos facettes de log ou d’APM. Ces Template Variables commencent par le caractère @.

Remarque : si vous utilisez le bouton Add to all, cette Template Variable sera uniquement ajoutée à l’ensemble des widgets de log/d’APM.

Widget de note

Même si le widget de note ne contient aucun graphique, vous pouvez afficher :

  • La Template Variable sélectionnée avec la syntaxe $<CLÉ_TEMPLATE_VARIABLE>.
  • La valeur de la Template Variable sélectionnée avec la syntaxe $<CLÉ_TEMPLATE_VARIABLE>.value.

Par exemple, si la configuration du widget de note est la suivante :

$env

$env.value

La sélection de la valeur dev pour la Template Variable $env se traduira par le résultat suivant :

Superposer des événements

La recherche d’événements à superposer vous permet de corréler des métriques avec des événements. Utilisez les Template Variables pour trouver des événements qui partagent certains tags avec les métriques de votre dashboard. Les événements à superposer sont appliqués à l’ensemble d’un graphique individuel.

Les valeurs des Template Variables de dashboard peuvent être directement recueillies en utilisant la syntaxe $<CLÉ_TEMPLATE_VARIABLE>.value dans le champ de recherche d’événement.

Remarque : les Template Variables de dashboard doivent être des tags de métrique ; les tags issus des événements ne peuvent pas être utilisés comme Template Variables de dashboard.

Template Variable unique

Par exemple, pour rechercher des événements partageant le même tag region, utilisez : tags:region:$region.value.

Dans l’exemple qui suit, la Template Variable correspond à tags:region:ap-south-1. Lorsque ces événements apparaissent dans le champ de recherche d’événements à superposer, leur occurrence est signalée par des barres roses sur les graphiques :

Template Variables multiples

Choisissez plusieurs Template Variables dans le champ de recherche pour afficher tous les événements tagués correspondants. L’exemple suivant utilise la requête : tags:role:$role.value,env:$env.value

Associer des Template Variables à d’autres tags

Utilisez la syntaxe $<CLÉ_TEMPLATE_VARIABLE>.value pour recueillir les données key:value d’une Template Variable spécifique et l’utiliser avec d’autres filtres.

L’exemple ci-dessous utilise les tags env avec le tag hosts dans la syntaxe de recherche tags:env:$env.value hosts:$host.value

Pour aller plus loin