Widget Série temporelle
Rapport de recherche Datadog : Bilan sur l'adoption de l'informatique sans serveur Rapport : Bilan sur l'adoption de l'informatique sans serveur

Widget Série temporelle

La visualisation de séries temporelles vous permet de consulter l’évolution de plusieurs métriques, événements de log ou spans analysées. La période affichée dépend des éléments sélectionnés sur le timeboard ou le screenboard :

Configuration

Configuration

  1. Choisissez les données à représenter :

  2. Personnalisez votre graphique avec les options disponibles.

Options

Graphiques linéaires

Les graphiques linéaires proposent deux paramètres supplémentaires :

ParamètreOptions
StyleSolid, Dashed, Dotted
StrokeNormal, Thin, Thick

Apparence

Vous pouvez créer des graphiques en aires, à barres ou linéaires. Pour tous les types de graphiques, Datadog propose de nombreuses options en matière de couleurs pour différencier les diverses métriques affichées sur un même graphique :

PaletteDescription
ClassicDes couleurs simples : bleu clair, bleu foncé, violet clair, violet, jaune clair et jaune (les couleurs se répètent).
CoolUn dégradé de couleurs composé de tons bleus et verts.
WarmUn dégradé de couleurs composé de tons jaunes et orange.
PurpleUn dégradé de couleurs composé de tons violets.
OrangeUn dégradé de couleurs composé de tons orange.
GrayUn dégradé de couleurs composé de tons gris.

Pour les graphiques linéaires, vous pouvez attribuer des palettes à différentes métriques en séparant les requêtes avec le format JSON.

Alias de métrique

Chaque requête ou formule peut avoir un alias. L’alias remplace le nom sur le graphique et la légende, ce qui est utile pour les longs noms de métrique. À la fin de la requête/formule, cliquez sur as…, puis saisissez votre alias de métrique :

Superposer des événements

Intégrez des événements de systèmes associés pour ajouter plus de contexte à votre graphique. Par exemple, vous pouvez ajouter des commits Github, des déploiements Jenkins ou des événements de création Docker. Développez la section Event Overlays et saisissez une requête pour afficher ces événements. Utilisez le même format de requête que pour le flux d’événements, par exemple :

RequêteDescription
sources:jenkinsAffiche tous les événements provenant de la source Jenkins.
tag:role:webAffiche tous les événements avec le tag role:web.
tags:$<TEMPLATE_VARIABLE>Affiche tous les événements provenant de la template variable sélectionnée.

Une fois activés, les événements s’affichent en superposition sur vos graphiques avec des barres rouges :

Commandes de l’axe des ordonnées

Les commandes de l’axe des ordonnées sont disponibles via l’interface utilisateur et l’éditeur JSON. Grâce à ces commandes, vous pouvez :

  • Régler l’axe des ordonnées sur un intervalle donné.
  • Changer automatiquement les limites de l’axe des ordonnées en définissant un pourcentage ou une valeur absolue. Une limite peut être appliquée à l’une des deux extrémités du graphique (inférieure ou supérieure) pour supprimer les singularités.
  • 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.

Changer l’échelle de l’axe des ordonnées en développant le bouton Y-Axis Controls.

Les options de configuration suivantes sont disponibles :

OptionObligatoireDescription
Min/MaxNonSpécifie la valeur minimale et/ou maximale à afficher sur l’axe des ordonnées. Indiquez un nombre ou Auto (la valeur par défaut).
ScaleNonSpécifie le type d’échelle. Valeurs autorisées :
- *linear* : une échelle linéaire (échelle par défaut).
- *log* : une échelle logarithmique
- *pow* : une échelle basée sur une puissance de 2. La valeur par défaut est 2, mais celle-ci peut être modifiée dans l’éditeur JSON.
- *sqrt* : une échelle basée sur la racine carrée.
Always include zeroNonIndique s’il faut toujours inclure le zéro ou ajuster l’axe à la plage de données. Par défaut, le zéro est toujours inclus.

Remarque : comme la fonction log mathématique n’accepte pas les valeurs négatives, notre échelle log ne fonctionne que si les valeurs ont le même signe (tout > 0 ou tout < 0). Si ce n’est pas le cas, un graphique vide s’affiche.

Plein écran

Outre les options de plein écran standard, vous pouvez appliquer des fonctions rapides, effectuer des comparaisons par rapport à des périodes précédentes, régler l’échelle de l’axe des ordonnées, enregistrer des modifications ou enregistrer un nouveau graphique.

Consultez l’article Explorer les données sous la forme d’un graphique en plein écran (en anglais) pour en savoir plus.

API

Le schéma JSON utilisé pour le widget Série temporelle est le suivant :

TIMESERIES_SCHEMA = {
    "type": "object",
    "properties": {
        "type": {"enum": ["timeseries"]},
        "requests": {
            "type":    "array",
            "items":   REQUEST_SCHEMA,
            "minItems": 1
        },
        "yaxis":   AXIS_SCHEMA,
        "events":  EVENTS_SCHEMA,
        "markers": MARKERS_SCHEMA,
        "title":   {"type": "string"},
        "show_legend": {"type": "boolean"}
    },
    "required": ["type", "requests"],
    "additionalProperties": false
}
ParamètreTypeObligatoireDescription
typechaîneouiType de widget (utilisez timeseries pour le widget Série temporelle).
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.
yaxisobjetnonOptions de commande de l’axe des ordonnées. Consultez la documentation relative au schéma JSON de l’axe des ordonnées pour apprendre à élaborer le AXIS_SCHEMA.
eventsobjetnonOptions de commande de superposition d’événements. Consultez la documentation relative au schéma JSON des événements pour apprendre à élaborer le EVENTS_SCHEMA.
markersobjetnonOptions de commande de superposition de marqueurs. Consultez la documentation relative au schéma JSON des marqueurs pour apprendre à élaborer le MARKERS_SCHEMA.
titlechaînenonTitre de votre widget.
show_legendbooléennonAfficher la légende pour ce widget (screenboard uniquement) 

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

{
  "style": {
    "type": "object",
    "properties": {
      "palette": {"type": "string"},
      "line_type": {"enum": ["dashed", "dotted", "solid"]},
      "line_width": {"enum": ["normal", "thick", "thin"]}
    },
    "additionalProperties": false
  },
  "metadata": {
    "type": "array",
    "items": {
      "type": "object",
      "properties": {
        "expression": {"type": "string"},
        "alias_name": {"type": "string"}
      },
      "required": ["expression"],
      "additionalProperties": false
    }
  },
  "display_type": {"enum": ["area", "bars", "line"]}
}
ParamètreTypeObligatoireDescription
style.palettechaînenonPalette de couleurs à appliquer au widget.
style.line_typechaînenonType des lignes affichées. Valeurs disponibles : dashed, dotted ou solid.
style.line_widthchaînenonLargeur des lignes affichées. Valeurs disponibles : normal, thick ou thin.
metadataobjetnonUtilisé pour définir des alias d’expression.
display_typechaînenonType d’affichage à utiliser pour la requête. Valeurs disponibles : area, bars ou line.

Pour aller plus loin