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 !

Schéma JSON des Widgets

Pour en savoir plus sur l’éditeur graphique, visitez la principale page Documentation sur les 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 à 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ètreTypeDescriptionPar défaut
scalestringSpécifie le type d’échelle. Voici les valeurs possibles : linear, log, sqrt, pow## (par exemple : pow2, pow0.5.)linear
minstringSpécifie la valeur minimale à afficher sur l’axe des ordonnées. Indiquez un nombre ou auto pour le comportement par défaut.auto
maxstringSpécifie la valeur maximale à afficher sur l’axe des ordonnées. Indiquez un nombre ou auto pour le comportement par défaut.auto
include_zeroBoolean

Schéma d’é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 <EVENT_QUERY>.

Exemples

Par exemple, pour indiquer que vous souhaitez 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 de marqueurs

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

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

Exemple :

Les marqueurs suivants :

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 de format conditionnel

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 ; choisissez parmi les valeurs suivantes : >, >=, < ou <=
valuedoubleValeur pour le comparateur.
palettestringPalette de couleurs à appliquer ; choisissez parmi les valeurs suivantes :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_colorstringPalette de couleurs à appliquer à l’arrière-plan ; choisissez parmi les mêmes valeurs qui sont disponibles dans palette.
custom_fg_colorstringPalette de couleurs à appliquer au premier plan ; choisissez parmi les mêmes valeurs qui sont disponibles dans palette.
image_urlstringAffiche une image en tant qu’arrière-plan.

Schéma de temps

Les intervalles de temps disponibles dépendent du widget que vous utilisez, mais le format général pour time est comme suit :

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_spanstringNom court pour représenter une valeur d’intervalle de temps. Voici les valeurs disponibles :
-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 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: