Widget Tableau
Rapport de recherche Datadog : Bilan sur l'adoption de l'informatique sans serveur Rapport : Bilan sur l'adoption de l'informatique sans serveur

Widget Tableau

Présentation

La visualisation Tableau est disponible sur les timeboards et les screenboards. Elle permet d’afficher des métriques regroupées par clé de tag sous forme de colonnes. L’exemple suivant affiche les métriques system.cpu.system et system.cpu.user regroupées par service :

Configuration

Configuration

  • Choisissez les données à représenter (ajoutez des colonnes supplémentaires en fonction de vos besoins) :
  • Vous pouvez renommer les en-têtes de colonne en définissant des alias de métrique.
  • Pour les Rows (rangs), définissez l’option Group by sur la clé de tag à utiliser pour le regroupement. L’exemple ci-dessous affiche les rangs service.
  • Choisissez une limite pour le nombre de résultats (par défaut, 10).
  • Choisissez la métrique à utiliser pour trier le tableau (par défaut, il s’agit de la première colonne).
  • Facultatif : définissez une mise en forme conditionnelle en fonction des valeurs des cellules pour chaque colonne.

API

Le schéma JSON utilisé pour le widget Tableau est le suivant :

TOPLIST_SCHEMA = {
    "type": "object",
    "properties": {
        "type": {"enum": ["query_table"]},
        "requests": {
            "type":     "array",
            "items":    REQUEST_SCHEMA,
            "minItems": 1,
            "maxItems": 1
        },
        "title": {"type": "string"}
    },
    "required": ["type", "requests"],
    "additionalProperties": false
}
ParamètreTypeObligatoireDescription
typeChaîneOuiLe type de widget (utilisez query_table pour le widget Tableau).
requestsTableau d’objetsOuiTableau d’un objet request à afficher dans le widget. Consultez la documentation relative au schéma JSON des requêtes pour élaborer le REQUEST_SCHEMA.
titleChaîneNonTitre de votre widget

Requêtes

Propriétés supplémentaires autorisées dans un objet request :

{
   "alias": {"type": "string"},
   "aggregator": {"enum": ["avg", "last", "max", "min", "sum"]},
   "limit": {"type": "integer"},
   "order": {"enum": ["asc", "desc"]},
   "conditional_formats": CONDITIONAL_FORMATS_SCHEMA
}
ParamètreTypeObligatoireDescription
aliasChaîneNonLe nom de la colonne (par défaut, il s’agit du nom de la métrique)
aggregatorEnumOuiPour les requêtes de métriques, ce paramètre permet de déterminer la méthode à utiliser pour transformer les valeurs de l’intervalle de temps en valeur unique pour le tableau. Valeurs disponibles : avg, last, max, min ou sum.
limitNombre entierOuiPour les requêtes de métriques, le nombre de lignes à afficher dans le tableau. Seule une requête peut disposer de cette propriété.
orderEnumOuiPour les requêtes de métriques, l’ordre de tri des rangs. Ce paramètre doit être défini pour la même requête que limit. Valeurs disponibles : desc et asc.
conditional_formatsObjetNonOptions de commande de mise en forme conditionnelle. Consultez la documentation relative au schéma JSON de format conditionnel pour apprendre à élaborer le CONDITIONAL_FORMATS_SCHEMA.

Colonnes multiples

Afin d’obtenir des colonnes multiples pour une requête de métriques, vous devez spécifier plusieurs objets de requête (un objet par colonne). Pour les requêtes de logs, vous devez uniquement spécifier un objet de requête contenant un tableau multi_compute d’objets compute. Chaque objet compute fournit une colonne.

Pour aller plus loin