# Alerting

> A mechanism that notifies an on-call responder when a monitored condition holds for longer than its threshold.

Record: `architecture:alerting`
Kind: mechanism
Layer: [Observability](https://banes-lab.com/records/layer/observability.md)
Severity: mandatory
Scope: operations, service
Canonical: https://banes-lab.com/ontology#architecture-alerting

Listed in [Architecture principles](https://banes-lab.com/api/records/architecture.md), after [Monitoring](https://banes-lab.com/records/architecture/monitoring.md) and before [Auditability](https://banes-lab.com/records/architecture/auditability.md).

## Repair

- Refactored by: Add Alert, Tune Thresholds
- Detected by: incident reported by customers before monitoring caught it
- Violated by: critical failures without alert
- Measured by: MTTD, alert precision
- Enforced by: on-call policy

## Requires

- [Monitoring](https://banes-lab.com/records/architecture/monitoring.md)
- [Thresholds](https://banes-lab.com/records/lexicon/thresholds.md)

## Reinforces

- [Incident Response](https://banes-lab.com/records/lexicon/incident-response.md)

## Enables

- [Timely Intervention](https://banes-lab.com/records/lexicon/timely-intervention.md)

## Conflicts with

- [Silent Failure](https://banes-lab.com/records/lexicon/silent-failure.md)
- [Observability Noise](https://banes-lab.com/records/architecture/observability-noise.md)

## In tension with

- [Alert Fatigue](https://banes-lab.com/records/lexicon/alert-fatigue.md)

## Tensions

- [Alerting / Alert Fatigue](https://banes-lab.com/records/tension/alert-fatigue-alerting.md)

## Severity

- [mandatory](https://banes-lab.com/records/vocabulary/severity-mandatory.md)

## Category

- [Observability / Auditability / Traceability](https://banes-lab.com/records/architecture-category/observability-auditability-traceability.md)

## Reinforced by

- [SLO/SLI](https://banes-lab.com/records/architecture/slo-sli.md)

## Linked from

- [Anti-patterns](https://banes-lab.com/ontology/principles/architecture-category-anti-patterns.md)
- [Observability / Auditability / Traceability](https://banes-lab.com/ontology/principles/architecture-category-observability-auditability-traceability.md)
- [Core Vocabulary](https://banes-lab.com/ontology/lexicon/lexicon-category-core-vocabulary.md)
- [Observability / Auditability / Traceability](https://banes-lab.com/ontology/lexicon/lexicon-category-observability-auditability-traceability.md)
- [Severity levels](https://banes-lab.com/ontology/schema/the-vocabulary-severity.md)
- [The resolutions](https://banes-lab.com/ontology/schema/the-resolutions.md)