ErrTapDOCS

Alerting

Configure notification channels and alert rules for errors, regressions, downtime, and missed cron heartbeats in ErrTap.

Channels

Channels are notification destinations. ErrTap supports:

  • Email — one or more addresses
  • Slack — incoming webhook URL
  • Generic webhook — any HTTP endpoint that accepts the alert JSON payload

Channel secrets are encrypted at rest. Use Test on any channel to verify delivery before wiring it to rules.

Alert types

TypeWhen it fires
NEW_ISSUEA never-before-seen error group appears
REGRESSED_ISSUEA resolved issue comes back in a new release (or after a snooze expires)
DOWNTIMEAn uptime check is confirmed down
RECOVERYAn uptime check recovers after a downtime incident
CRON_MISSEDA heartbeat did not arrive within the grace window

Rules

Rules bind an alert type to one or more channels. Each rule can be scoped to:

  • A specific environment (e.g., only fire for production)
  • A severity level filter (e.g., only error and above, not warning)

Deduplication / cooldown

Rules carry a cooldown window: ErrTap fires at most one alert per issue (or check) per window. This means an error storm pages you once — not hundreds of times.

Configure the cooldown duration per rule in Alerts → Alert rules.

Configuring rules

Navigate to Alerts → Alert rules → New rule:

  1. Choose an alert type
  2. Select one or more channels
  3. Optionally filter by environment or severity
  4. Set a cooldown window (default: 1 hour)
  5. Save and test