aboutsummaryrefslogtreecommitdiffstats
path: root/docs/alerting.md
blob: de8d6a92cb21d70556ca406cf23b5d2b69e4a382 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
# Alerting

Alerts are signals from [Monitors][1] to perform actions.  Alerts MUST
be _meaningful_ and _actionable_.

**Meaningful**: Alert only on montiors which indicate a problem.  (See
[Monitoring][1] subsection "Saturation".)

**Actionable**: Alerts MUST always include a corresponding action to
resolve or investigate the underlying condition.

## Requirements

- Alerts MUST be resolved by a human being.
- Alerts MUST begin with [PagerDuty][2].
  - Alert notifications MAY forward to Slack.
  - Alert notifications MAY forward via Email.
- Alerts MUST NOT deduplicate automatically.  A human MAY aggregate
  alerts if unknown dependencies provide alerts during an incident.

[1]: monitoring.md
[2]: https://www.pagerduty.com/