Notifications: Email

Route grith events to email via SMTP.

Send digest items and alerts via SMTP. Useful for digest summaries to oncall mailing lists.

Configure

[notifications.channels.email]
enabled = true
smtp_host = "smtp.example.com"
smtp_port = 587
smtp_user = "grith@example.com"
smtp_pass = "..."                       # or use SMTP_PASS env var
smtp_tls  = "starttls"                  # "starttls" | "tls" | "none"
from = "grith@example.com"
to   = ["oncall@example.com"]
severity_map = { canary = "critical", queue = "warning" }
batch_window_seconds = 300              # batch queue events into one mail

Batching

Email isn't a great instant-alert channel; the batch_window_seconds field collects queue events into a single digest mail. Canary fires bypass batching and send immediately.

Test

grith notifications test email

You should see a test mail in the recipient inbox within a minute.

Format

Subject — [grith] <severity> <operation> <target>.
Body — plain text with filter contributions, then HTML version with links to the dashboard.
From — the configured from address.

Caveats