Discord
Discord’s webhook integration is simpler than Slack’s — works great for homelab and small team alerting.
Create a Discord webhook
Section titled “Create a Discord webhook”- Open the Discord server where you want alerts
- Server Settings → Integrations → Webhooks → New Webhook
- Choose the channel (e.g.
#alerts) - Name the webhook (e.g.
dockmesh) - Optionally upload an avatar
- Copy the Webhook URL — looks like
https://discord.com/api/webhooks/.../...
Add to dockmesh
Section titled “Add to dockmesh”Settings → Channels → New channel → Discord
| Field | Value |
|---|---|
| Name | alerts |
| Webhook URL | paste from Discord |
| Mention role (optional) | @here, @everyone, or a specific role ID like <@&123456789> |
| Severity filter | All / Warning+ / Critical only |
Click Send test — message should land in your channel.
Role mentions for critical alerts
Section titled “Role mentions for critical alerts”Discord webhooks can ping specific roles. For on-call pager behavior:
- Create an
@oncallrole in Discord, assign to the person currently on-call - Get the role ID — right-click role with developer mode enabled → Copy ID
- In dockmesh, set Mention role to
<@&1234567890>(format:<@&+ role ID +>) - Set severity filter to Critical only so you don’t spam the pager for warnings
Critical alerts now ping the @oncall role. Non-critical alerts arrive silently.
Multiple channels by severity
Section titled “Multiple channels by severity”Typical setup:
| Severity | Discord channel |
|---|---|
| Info | #alerts-log (muted) |
| Warning | #alerts-warn |
| Critical | #alerts-crit with @oncall role mention |
Create three Discord webhooks + three dockmesh channels, one per severity.
Message format
Section titled “Message format”Discord renders the alert as an embed:
- Color-coded left border (red/amber/blue)
- Title: the rule name
- Body: target, metric, value, threshold
- Timestamp
- Link button “View in dockmesh”
Troubleshooting
Section titled “Troubleshooting”Rate limiting:
- Discord rate-limits webhooks at 30 requests per 60 seconds per channel
- dockmesh automatically backs off on
429 Too Many Requests - For heavy alert volume, split across multiple channels
Embed too long:
- Discord limits embed bodies to 4096 chars
- Rare in practice, but long alert context (e.g. error logs) may be truncated with a “see full in dockmesh” link
See also
Section titled “See also”- Alerts — rule configuration
- Integrations · Slack — equivalent for Slack workspaces