Schéma JSON des widgets

Pour en savoir plus sur l’éditeur visuel, consultez la documentation sur l’éditeur de graphiques.

Schéma de l’axe des ordonnées

Grâce aux commandes de l’axe des ordonnées de Datadog, vous pouvez :

  • Régler l’axe des ordonnées sur un intervalle donné
  • Filtrer les séries en spécifiant un pourcentage ou une valeur absolue
  • Changer l’échelle de l’axe des ordonnées afin de passer d’une échelle linéaire à une échelle logarithmique, racine carrée ou puissance

Le schéma est :

AXIS_SCHEMA = {
    "type": "object",
    "properties": {
        "scale":        {"type": "string"},
        "min":          {"type": "string"},
        "max":          {"type": "string"},
        "include_zero": {"type": "boolean"}
    },
    "additionalProperties": false
}
ParamètreTypeDescriptionValeur par défaut
scalechaîneSpécifie le type d’échelle. Valeurs autorisées : linear, log, sqrt, pow## (par exemple : pow2, pow0.5.)linear
minchaîneSpécifie la valeur minimale à afficher sur l’axe des ordonnées. Indiquez un nombre ou auto pour le comportement par défaut.auto
maxchaîneSpécifie la valeur maximale à afficher sur l’axe des ordonnées. Indiquez un nombre ou auto pour le comportement par défaut.auto
include_zeroBooléen

Schéma des événements

Vous pouvez superposer n’importe quel événement de Datadog. Le format général pour events est comme suit :

EVENTS_SCHEMA = {
    "type": "array",
    "items": {
        "type": "object",
        "properties": {
            "q": {"type": "string"},
        },
        "required": ["q"],
        "additionalProperties": false
    }
}

Consultez la documentation relative au flux d’événements pour en savoir plus sur la syntaxe des requêtes.

Exemples

Par exemple, pour indiquer que vous souhaitez afficher les événements du host X et du tag Y :

"events": [
  {
    "q": "host:X tags:Y"
  }
]

ou si vous cherchez à afficher toutes les erreurs :

"events": [
  {
    "q": "status:error"
  }
]

Schéma des marqueurs

Les marqueurs vous permettent d’ajouter une mise en forme conditionnelle visuelle pour vos graphiques. Le format pour markers est le suivant :

MARKERS_SCHEMA = {
    "type": "array",
    "items": {
        "type": "object",
        "properties": {
            "value":        {"type": "string"},
            "display_type": {"type": "string"},
            "label":        {"type": "string"}
        },
        "required": ["value"],
        "additionalProperties": false
    }
}
ParamètreTypeDescription
valuechaîneValeur à appliquer. Peut être une valeur unique y = 15 ou une plage de valeurs 0 < y < 10
display_typechaîneCombinaison des éléments suivants :
- Un niveau de gravité error, warning, ok ou info
- Un type de ligne dashed, solid ou bold
labelchaîneLibellé à afficher sur le marqueur.

Exemple :

Les marqueurs suivants :

Marqueurs

sont appliqués avec la configuration suivante :

{ (...)
  "widgets": [
    {
      "definition": {
        "markers": [
          {
            "display_type": "ok dashed",
            "label": "OK",
            "value": "0 < y < 50"
          },
          {
            "display_type": "error dashed",
            "label": "ALERT",
            "value": "y > 80"
          },
          {
            "display_type": "warning dashed",
            "label": "WARNING",
            "value": "50 < y < 80"
          }
        ],
        "requests": [(...)],
        "title": "CPU with markers",
        "type": "timeseries"
      },
(...)
},

Schéma des formats conditionnels

Les formats conditionnels vous permettent de définir la couleur du contenu ou de l’arrière-plan de votre widget, en fonction d’une règle appliquée à vos données.

CONDITIONAL_FORMATS_SCHEMA = {
    "type": "array",
    "items": {
        "type": "object",
        "properties": {
            "comparator":      {"enum": [">", ">=", "<", "<="]},
            "value":           {"type": "number"},
            "palette":         {"enum": ["blue","custom_bg","custom_image","custom_text","gray_on_white","green","green_on_white","grey","orange","red","red_on_white","white_on_gray","white_on_green","white_on_red","white_on_yellow","yellow_on_white",
            ]},
            "custom_bg_color": {"type": "string"},
            "custom_fg_color": {"type": "string"},
            "image_url":       {"type": "string", "format": "uri"},
        },
        "required": ["comparator", "value", "palette"],
        "additionalProperties": false
    }
}
ParamètreTypeDescription
comparatorenumComparateur à appliquer. Valeurs autorisées : >, >=, < ou <=
valuedoubleValeur pour le comparateur.
palettechaînePalette de couleurs à appliquer. Valeurs autorisées :blue, custom_bg, custom_image, custom_text, gray_on_white, green, green_on_white, grey, orange, red, red_on_white, white_on_gray, white_on_green, white_on_red, white_on_yellow ou yellow_on_white
custom_bg_colorchaînePalette de couleurs à appliquer à l’arrière-plan. Les valeurs autorisées sont les mêmes que pour palette.
custom_fg_colorchaînePalette de couleurs à appliquer au premier plan. Les valeurs autorisées sont les mêmes que pour palette.
image_urlchaîneAffiche une image en tant qu’arrière-plan.

Schéma des intervalles

Les intervalles de temps disponibles dépendent du widget que vous utilisez. Voici néanmoins le format général pour time :

TIME_SCHEMA = {
    "type": "object",
    "properties": {
        "live_span": {"enum": [
            '1m',
            '5m',
            '10m',
            '15m',
            '30m',
            '1h',
            '4h',
            '1d',
            '2d',
            '1w',
            '1mo',
            '3mo',
            '6mo',
            '1y',
            'alert'
        ]}
    },
    "additionalProperties": false
}
ParamètreTypeDescription
live_spanchaîneNom court pour représenter une valeur d’intervalle de temps. Valeurs acceptées :
-1m : 1 minute
-5m : 5 minutes
-10m : 10 minutes
-15m : 15 minutes
-30m : 30 minutes
-1h : 1 heure
-4h : 4 heures
-1d : 1 jour
-2d : 2 jours
-1w : 1 semaine
-1mo : 1 mois
-3mo : 3 mois
-6mo : 6 mois
-1y : 1 an
-alert : utilisée uniquement dans le widget alert_graph

Exemple

Par exemple, pour indiquer que vous souhaitez afficher un intervalle de temps de 10 minutes, utilisez ce qui suit :

"time": {
  "live_span": "10m"
}

Pour aller plus loin

Documentation, liens et articles supplémentaires utiles: