Garmingo Docs
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

  1. In Mattermost: Main Menu → Integrations → Incoming Webhooks → Add New.
  2. Select the destination channel and save; copy the webhook URL.
  3. In Garmingo: Create Mattermost integration → paste webhook URL.
  4. 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:

FieldPurpose
textPrimary message (summary line)
context linkDirect 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

IssueCauseFix
403Webhook disabled or wrong URLRecreate webhook
No messageChannel permissions or deleted webhookVerify integration list
Formatting odditiesMattermost markdown differencesSimplify message body