Alert Value Widget

The Alert value widget displays the current query value from a simple-alert metric monitor. Simple-alert monitors have a metric query that is not grouped and returns one value. Use Alert value widgets in your dashboard to get an overview of your monitor behaviors and alert statuses.

Three alert value widgets with three different monitor statuses for disk space, high cpu and checkout error rate

Setup

Alert Value setup page for high cpu monitor

Configuration

  1. Choose an existing metric monitor to graph.
  2. Select the formatting to display:
    • Decimal
    • Units
    • Alignment
  3. Give your graph a title.

API

This widget can be used with the Dashboards API. See the following table for the widget JSON schema definition:

Expand All

Field

Type

Description

alert_id [required]

string

ID of the alert to use in the widget.

precision

int64

Number of decimal to show. If not defined, will use the raw value.

text_align

enum

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

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 value in the widget.

type [required]

enum

Type of the alert value widget. Allowed enum values: alert_value

default: alert_value

unit

string

Unit to display with the value.

{
  "alert_id": "",
  "precision": "integer",
  "text_align": "string",
  "title": "string",
  "title_align": "string",
  "title_size": "string",
  "type": "alert_value",
  "unit": "string"
}

Further Reading

Additional helpful documentation, links, and articles: