Types
Mattermost
Post structured status notifications into a Mattermost channel via incoming webhook.
Deliver incident, maintenance, and monitor status changes to a Mattermost channel using an incoming webhook.
Setup
- In Mattermost: Main Menu → Integrations → Incoming Webhooks → Add New.
- Select the destination channel and save; copy the webhook URL.
- In Garmingo: Create Mattermost integration → paste webhook URL.
- Save and fire a test (or toggle a non‑critical monitor temporarily).
Payload Structure
Posts use JSON payload with text plus optional attachments for richer formatting (future enhancement). Core fields:
Field | Purpose |
---|---|
text | Primary message (summary line) |
context link | Direct link back to status page / incident |
Best Practices
- Use a dedicated channel (e.g.
#status-alerts
). - Apply channel naming with environment prefix (
prod-
,staging-
). - Pin the integration message with a short legend (emoji severity mapping).
Troubleshooting
Issue | Cause | Fix |
---|---|---|
403 | Webhook disabled or wrong URL | Recreate webhook |
No message | Channel permissions or deleted webhook | Verify integration list |
Formatting oddities | Mattermost markdown differences | Simplify message body |