Les checks de service surveillent le statut actif ou inactif d’un service spécifique. Des alertes sont déclenchées lorsque l’Agent de surveillance ne parvient pas à se connecter au service lors d’un nombre défini de checks consécutifs. Le widget Check Status peut afficher visuellement une dégradation de service, des pannes de service, des problèmes à l’échelle du cluster, des baisses de débit ou des augmentations de latence dans votre dashboard. Pour plus d’informations, consultez la documentation sur les checks de service.
Le widget Statut de check affiche le statut actuel ou le nombre de résultats associés à n’importe quel check réalisé :
Configuration
Configuration
Sélectionnez un check de service créé précédemment.
Choisissez un intervalle de transmission. Cet intervalle est toujours basé sur l’heure actuelle. Vous pouvez donc choisir une option comme The past 10 minutes (les 10 dernières minutes) ou The past 1 day (le dernier jour) pour afficher un statut pour cet intervalle. Si vous choisissez l’option Global Time, l’utilisateur du dashboard peut sélectionner une plage à l’aide du sélecteur temporel en haut à droite, mais celle-ci doit également être basée sur l’heure actuelle (par exemple, les X dernières heures ou les X derniers jours), sans quoi le widget n’affiche aucune donnée.
Sélectionnez votre contexte :
- A single check : sélectionnez cette option si votre widget Statut de check est dédié à un élément en particulier, par exemple
host:<HOSTNAME> ou service:<NOM_SERVICE>. - A cluster of checks : sélectionnez cette option si votre widget Statut de check est dédié à un ensemble d’éléments, par exemple à l’ensemble des
host ou des service.
Terminez ensuite de définir le contexte de votre widget Statut de check en renseignant le champ Reported by.
Pour le périmètre A Cluster of checks, vous avez la possibilité de sélectionner un sous-ensemble avec le champ Group by. Remarque : le statut du check ne vous indique pas le nombre de checks par groupe, mais le nombre de groupes exécutant le check. Par exemple, si vous surveillez Agent Up, groupé par env, le statut du check vous indique le nombre d’env correspondant à vos configurations de périmètre et exécutant l’Agent, et non le nombre d’Agents dans un environnement.
API
Ce widget peut être utilisé avec l’API Dashboards. Le tableau ci-dessous définit le schéma JSON du widget :
Expand All
Name of the check to use in the widget.
Group reporting a single check.
List of tag prefixes to group by in the case of a cluster check.
The kind of grouping to use.
Allowed enum values: check,cluster
List of tags used to filter the groups reporting a cluster check.
Time setting for the widget.
hide_incomplete_cost_data
Whether to hide incomplete cost data in the widget.
The available timeframes depend on the widget you are using.
Allowed enum values: 1m,5m,10m,15m,30m,1h,4h,1d,2d,1wShow 7 more
,1mo,3mo,6mo,week_to_date,month_to_date,1y,alert
Used for arbitrary live span times, such as 17 minutes or 6 hours.
hide_incomplete_cost_data
Whether to hide incomplete cost data in the widget.
Type "live" denotes a live span in the new format.
Allowed enum values: live
Unit of the time span.
Allowed enum values: minute,hour,day,week,month,year
Used for fixed span times, such as 'March 1 to March 7'.
Start time in milliseconds since epoch.
hide_incomplete_cost_data
Whether to hide incomplete cost data in the widget.
End time in milliseconds since epoch.
Type "fixed" denotes a fixed span.
Allowed enum values: fixed
How to align the text on the widget.
Allowed enum values: center,left,right
Type of the check status widget.
Allowed enum values: check_status
default: check_status
{
"check": "",
"group": "string",
"group_by": [],
"grouping": "check",
"tags": [],
"time": {
"hide_incomplete_cost_data": false,
"live_span": "5m"
},
"title": "string",
"title_align": "string",
"title_size": "string",
"type": "check_status"
}
Pour aller plus loin
Documentation, liens et articles supplémentaires utiles:
