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 |