Check status shows the current status or number of results for any check performed:
Setup
Configuration
Select a previously created service check.
Choose a reporting time frame. This time frame always includes up to the present, so you can choose an option such as The past 10 minutes
or The past 1 day
and it reports a status that includes that time frame up to the present moment. If you choose Global Time
, the person using the dashboard can select a range using the time frame selector in the upper right, but they must choose one that includes the present moment, that is any past X
time frame. Otherwise the widget is blank.
Choose your scope:
- A single check: Select this option if your Check Status widget is for a specific element only, for example: one
host:<HOSTNAME>
, one service:<SERVICE_NAME>
. - A cluster of checks: Select this option if your Check Status widget is for a scope of elements as in all
host
s, or all service
s.
After selecting your scope, define your Check Status widget context with the Reported by field.
API
This widget can be used with the Dashboards API. See the following table for the widget JSON schema definition:
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.
The available timeframes depend on the widget you are using.
Allowed enum values: 1m,5m,10m,15m,30m,1h,4h,1d,2d,1w,1mo,3mo,6mo,week_to_date,month_to_date,1y,alert
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": {
"live_span": "5m"
},
"title": "string",
"title_align": "string",
"title_size": "string",
"type": "check_status"
}
Further Reading
Additional helpful documentation, links, and articles: