Widget Résumé des monitors

Le widget Résumé des monitors affiche une vue synthétique de tous vos monitors Datadog ou d’un sous-ensemble filtré selon une requête.

résumé des monitors

Configuration

Configuration du widget Résumé des monitors

Configuration

  1. Sélectionnez l’un des trois types de résumé : Monitor, Group ou Combined.

    • Le type de résumé Monitor répertorie les statuts et les noms des monitors correspondant à la requête de monitor. Les monitors à alertes multiples sont affichés sur une seule ligne dans la liste des résultats, et leur statut correspond au statut global du monitor à alertes multiples. Les nombres indiqués pour chaque statut représentent le nombre de monitors correspondant à chaque type de statut.
    Type de résumé Monitor
    • Le type de résumé Group répertorie les statuts, les noms et les groupes des monitors correspondant à la requête de monitor. Les monitors à alertes multiples sont affichés sur plusieurs lignes dans la liste des résultats, chaque ligne correspondant à un groupe et chaque statut correspondant à celui du groupe au sein du monitor à alertes multiples. Tout comme la page Triggered Monitors, le type de résumé Group prend également en charge les facettes group et group_status dans sa requête de monitor. Les nombres indiqués pour chaque statut représentent le nombre de groupes de monitors correspondant à chaque type de statut.
    Type de résumé Group
    • Le type de résumé Combined répertorie le nombre de statuts de groupe et les noms des monitors correspondant à la requête de monitor. Les monitors à alertes multiples s’affichent sur une seule ligne dans la liste des résultats, comme pour le type de résumé Monitor, mais la colonne dédiée aux groupes affiche le nombre de groupes correspondant à chaque type de statut au lieu d’afficher le statut global du monitor. Tout comme le type de résumé Group, le type de résumé Combined prend également en charge les facettes group et group_status dans sa requête de monitor. Dans la même logique que le type de résumé Monitor, les nombres indiqués pour chaque statut représentent le nombre total de monitors associés à chaque statut.
    Type de résumé Combined
  2. Saisissez une requête de monitor pour afficher un sous-ensemble de monitors sur le widget Résumé des monitors.

    Remarque : outre les facettes répertoriées dans le lien ci-dessus, les types de résumés Group et Combined prennent également en charge les facettes group et group_status pour les recherches au sein des groupes, de la même manière que la page Triggered Monitors.

Template variables

Pour utiliser des template variables créées dans votre dashboard dans la requête de recherche du widget Résumé des monitors, utilisez le même format de requête que pour la page Manage Monitor.

Exemple

  1. Appliquer au monitor un filtre scope avec une template variable $service

    Pour ajouter un filtre scope sur la page Manage Monitor ou Triggered Monitors, vous devez utiliser scope:service:web-store. Ainsi, vous devez spécifier scope:$service dans le widget, puis appliquer la valeur de la template variable au widget.

    Template variable scope
  2. Appliquer au monitor un filtre group avec une template variable $env

    Pour ajouter un filtre group sur la page Manage Monitor ou Triggered Monitors, vous devez utiliser group:env:prod. Ainsi, vous devez spécifier group:$env dans le widget, puis appliquer la valeur de la template variable au widget.

    Template variable group

Options

Préférences d’affichage

Choisissez parmi les options d’affichage suivantes : Count pour afficher le nombre de monitors par type de statut de monitor, List pour afficher une liste des monitors, ou Both pour afficher les deux. Les options Text et Background spécifient si les couleurs de statut doivent être appliquées au texte ou à l’arrière-plan des nombres de statuts. Lorsque l’option Hide empty Status Counts est sélectionnée, le nombre de monitors associés à un statut est uniquement affiché lorsque la liste des résultats contient au moins un monitor avec ce statut.

Préférences d'affichage

En activant l’option Show triggered column, vous pouvez filtrer les résultats de manière à afficher uniquement les monitors ou les groupes de monitors qui présentent un état déclenché (Alert, Warn ou No Data). Ceux-ci sont alors triés en fonction de leur date de déclenchement, de la plus récente à la plus éloignée. Une colonne supplémentaire indique alors le temps écoulé depuis le dernier déclenchement du monitor/groupe.

Préférences d'affichage

Titre

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

Titre du widget

Vous pouvez aussi définir sa taille et son alignement si vous le souhaitez.

API

Ce widget peut être utilisé avec l’API Dashboards. Consultez la documentation à ce sujet pour en savoir plus.

Le schéma JSON utilisé pour le widget Résumé des monitors est le suivant :

Expand All

Champ

Type

Description

color_preference

enum

Which color to use on the widget. Allowed enum values: background,text

count

int64

DEPRECATED: The number of monitors to display.

display_format

enum

What to display on the widget. Allowed enum values: counts,countsAndList,list

hide_zero_counts

boolean

Whether to show counts of 0 or not.

query [required]

string

Query to filter the monitors with.

show_last_triggered

boolean

Whether to show the time that has elapsed since the monitor/group triggered.

show_priority

boolean

Whether to show the priorities column.

sort

enum

Widget sorting methods. Allowed enum values: name,group,status,tags,triggered,group,asc,group,desc,name,asc,name,desc,status,asc,status,desc,tags,asc,tags,desc,triggered,asc,triggered,desc,priority,asc,priority,desc

start

int64

DEPRECATED: The start of the list. Typically 0.

summary_type

enum

Which summary type should be used. Allowed enum values: monitors,groups,combined

title

string

Title of the widget.

title_align

enum

How to align the text on the widget. Allowed enum values: center,left,right

title_size

string

Size of the title.

type [required]

enum

Type of the monitor summary widget. Allowed enum values: manage_status

default: manage_status

{
  "color_preference": "string",
  "count": "integer",
  "display_format": "string",
  "hide_zero_counts": false,
  "query": "",
  "show_last_triggered": false,
  "show_priority": false,
  "sort": "name,asc",
  "start": "integer",
  "summary_type": "string",
  "title": "string",
  "title_align": "string",
  "title_size": "string",
  "type": "manage_status"
}

Pour aller plus loin

Documentation, liens et articles supplémentaires utiles:

PREVIEWING: safchain/fix-custom-agent