Widget Valeur de requête
Rapport de recherche Datadog : Bilan sur l'adoption de l'informatique sans serveur Rapport : Bilan sur l'adoption de l'informatique sans serveur

Widget Valeur de requête

Les valeurs de requête affichent la valeur actuelle d’une requête de métrique, d’APM ou de log donnée. Elles disposent d’une mise en forme conditionnelle (comme un arrière-plan vert/jaune/rouge) pour indiquer si la valeur figure dans la plage attendue. Les valeurs affichées par une valeur de requête ne représentent pas nécessairement une mesure instantanée.

Le widget peut afficher la dernière valeur transmise, ou une agrégation calculée à partir de toutes les valeurs de requête de l’intervalle. Ces visualisations offrent un aperçu limité mais explicite de votre requête d’infrastructure.

Configuration

Configuration

  1. Choisissez les données à représenter :
  2. Choisissez les unités et la mise en forme.
  3. Facultatif : configurez une mise en forme conditionnelle en fonction de la valeur affichée.

Options

Intervalle global

Choisissez si votre widget doit afficher un intervalle personnalisé ou l’intervalle global du screenboard (disponible sur les screenboards uniquement).

Titre

Affichez un titre personnalisé pour votre widget en cochant la case Show a Title :

Définissez sa taille et son alignement si vous le souhaitez.

API

Le schéma JSON utilisé pour le widget Valeur de requête est le suivant :

QUERY_VALUE_SCHEMA = {
    "type": "object",
    "properties": {
        "type": {"enum": ["query_value"]},
        "requests": {
            "type":     "array",
            "items":    REQUEST_SCHEMA,
            "minItems": 1,
            "maxItems": 1
        },
        "autoscale":   {"type": "boolean"},
        "custom_unit": {"type": "string"},
        "precision":   {"type": "integer"},
        "text_align":  {"enum": ["center", "left", "right"]},
        "title":       {"type": "string"}
    },
    "required": ["type", "requests"],
    "additionalProperties": false
}
ParamètreTypeObligatoireDescription
typechaîneouiType de widget (utilisez query_value pour le widget Valeur de requête)
requeststableau d’objetsouiTableau d’un objet request à afficher dans le widget. Consultez la documentation relative au schéma JSON des requêtes pour apprendre à élaborer le REQUEST_SCHEMA.
autoscaleBooléennonIndique si la mise à l’échelle automatique doit être utilisée ou non.
custom_unitchaînenonAffichez une unité au choix sur le widget.
precisionnombre entiernonNombre de décimales à afficher. Si vous ne définissez pas ce paramètre, le widget utilise une valeur brute.
text_alignchaînenonAlignement de la valeur dans le widget. Valeurs disponibles : center, left ou right.
titlechaînenonTitre de votre widget.

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

{
    "conditional_formats": CONDITIONAL_FORMATS_SCHEMA,
    "aggregator": {"enum": ["avg", "last", "max", "min", "sum"]}
}
ParamètreTypeObligatoireDescription
conditional_formatsobjetnonOptions de commande de mise en forme conditionnelle. Consultez la documentation relative au schéma JSON de mise en forme conditionnelle pour apprendre à élaborer le CONDITIONAL_FORMATS_SCHEMA.
aggregatorenumnonAgrégateur utilisé pour la requête. Valeurs disponibles : avg, last, max, min ou sum.

Pour aller plus loin

Documentation, liens et articles supplémentaires utiles: