Pour en savoir plus sur l’éditeur visuel, consultez la documentation sur l'éditeur de graphiques.
Grâce aux commandes de l’axe des ordonnées de Datadog, vous pouvez :
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ètre | Type | Description | Valeur par défaut |
---|---|---|---|
scale | chaîne | Spécifie le type d’échelle. Valeurs autorisées : linear , log , sqrt , pow## (par exemple : pow2 , pow0.5 .) | linear |
min | chaîne | Spécifie la valeur minimale à afficher sur l’axe des ordonnées. Indiquez un nombre ou auto pour le comportement par défaut. | auto |
max | chaîne | Spécifie la valeur maximale à afficher sur l’axe des ordonnées. Indiquez un nombre ou auto pour le comportement par défaut. | auto |
include_zero | Booléen |
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>
.
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"
}
]
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ètre | Type | Description |
---|---|---|
value | chaîne | Valeur à appliquer. Peut être une valeur unique y = 15 ou une plage de valeurs 0 < y < 10 |
display_type | chaîne | Combinaison des éléments suivants : - Un niveau de gravité error , warning , ok ou info - Un type de ligne dashed , solid ou bold |
label | chaîne | Libellé à afficher sur le marqueur. |
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"
},
(...)
},
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ètre | Type | Description |
---|---|---|
comparator | enum | Comparateur à appliquer. Valeurs autorisées : > , >= , < ou <= |
value | double | Valeur pour le comparateur. |
palette | chaîne | Palette 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_color | chaîne | Palette de couleurs à appliquer à l’arrière-plan. Les valeurs autorisées sont les mêmes que pour palette. |
custom_fg_color | chaîne | Palette de couleurs à appliquer au premier plan. Les valeurs autorisées sont les mêmes que pour palette. |
image_url | chaîne | Affiche une image en tant qu’arrière-plan. |
Les intervalles de temps disponibles dépendent du widget que vous utilisez, mais le format général pour time
est le suivant :
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ètre | Type | Description |
---|---|---|
live_span | chaîne | Nom 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 |
Par exemple, pour indiquer que vous souhaitez afficher un intervalle de temps de 10 minutes, utilisez ce qui suit :
"time": {
"live_span": "10m"
}
Documentation, liens et articles supplémentaires utiles: