ErrTap / DevelopersDocumentation
ErrTap docsconcepts / alerts

Alerting

Configure notification channels and alert rules for issue lifecycle, spikes, downtime, recovery, SSL expiry, and missed heartbeats.

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
SSL_EXPIRYA monitored certificate crosses an expiry warning threshold
CRON_MISSEDA heartbeat did not arrive within the grace window
ERROR_SPIKEProject event volume exceeds its recent baseline

Rules

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

  • A specific environment for NEW_ISSUE and REGRESSED_ISSUE rules

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 select an environment for an issue lifecycle rule
  4. Set a cooldown window (default: 5 minutes)
  5. Save and test

On this page