S Technologies's Logo

Color

Green
Teal
Indigo
Blue
Purple
Red
Rose

Mode

Light

alert

Read the open alerts, the rules that raise them and the channels they are sent to.

Alerts are raised by rules when a watched value crosses a threshold, and each alert is sent to the channels that accept its severity. These commands are read-only. Use them to see what is firing, why, and whether anything is able to deliver it. Every command also takes --json, --quiet and --help.

CommandWhat it does
stechbd alert lsRecent alerts, newest first
stechbd alert rulesEvery rule: what it watches and when it fires
stechbd alert channelsWhere alerts are sent, and whether each is delivering

stechbd alert ls

Lists recent alerts, newest first, with their state, severity, scope, latest value and when they opened. The list shows 50 alerts unless --limit says otherwise. When the list stops at the limit, a line below the table says so, so a short list is not read as the whole history.

bash
stechbd alert ls [--state <state>] [--limit <n>]
OptionDescription
--state <state>Show only alerts in this state.
--limit <n>The most alerts to show, a whole number at least 1. Defaults to 50.
bash
stechbd alert ls
stechbd alert ls --limit 200 --json

stechbd alert rules

Lists every rule with the metric it watches, its threshold, how long the value must stay past it before the alert fires, its severity, its scope, and whether it is enabled.

bash
stechbd alert rules
bash
stechbd alert rules --json

stechbd alert channels

Lists the channels alerts are sent to, with each one's kind, target, the lowest severity it accepts, and whether it is healthy. A failing channel is flagged below the table with the last error it recorded. If there are no channels at all, the command warns that alerts that fire are sent nowhere.

bash
stechbd alert channels
bash
stechbd alert channels --json