Integrating Alerts with Discord

Server Scout can send alerts directly to your Discord channels, making it easy to keep your team informed about server issues in real-time. Discord accepts Slack-compatible webhooks with a simple URL modification, making the integration straightforward.

Creating a Discord Webhook

First, you'll need to create a webhook in your Discord server. This requires administrative permissions for the server or channel where you want to receive alerts.

1. Navigate to your Discord server and right-click on the channel where you want alerts to appear
2. Select Edit Channel from the context menu
3. Click on Integrations in the left sidebar
4. Select Webhooks and click New Webhook
5. Give your webhook a descriptive name (e.g., "Server Scout Alerts")
6. Optionally, upload an avatar image for the webhook
7. Copy the webhook URL - you'll need this for Server Scout configuration

The webhook URL will look similar to:

https://discord.com/api/webhooks/123456789/abcdefghijklmnop

Configuring Server Scout

To enable Discord notifications in Server Scout, you'll need to modify the webhook URL and add it to your Server Scout configuration.

Modifying the Webhook URL

Discord accepts Slack-compatible payloads when you append /slack to the webhook URL. Transform your webhook URL like this:

https://discord.com/api/webhooks/123456789/abcdefghijklmnop/slack

Adding the Webhook to Server Scout

1. Access your Server Scout dashboard
2. Navigate to Settings → Notifications
3. Select Add New Integration
4. Choose Slack/Discord as the integration type
5. Paste your modified webhook URL (with /slack appended)
6. Configure your alert preferences:

- Select which alert types to send (CPU, memory, disk, network, etc.) - Set severity thresholds - Choose notification frequency to avoid spam

Alert Message Format

Server Scout sends alerts to Discord as rich embedded messages with colour-coding for easy identification:

• Red: Critical alerts (server down, disk full, critical thresholds exceeded)
• Orange: Warning alerts (high resource usage, approaching limits)
• Green: Recovery alerts (issues resolved, services restored)

Each alert includes:

• Server hostname and IP address
• Alert type and severity level
• Current metric values
• Timestamp of the event
• Direct link to the Server Scout dashboard for detailed analysis

Testing Your Integration

Once configured, it's essential to verify that alerts are working correctly:

1. Use Server Scout's Test Alert feature in the notifications settings
2. Check your Discord channel for the test message
3. Verify that the message formatting appears correctly
4. Confirm that @mentions work if you've configured them

If the test fails, double-check:

• The webhook URL includes the /slack suffix
• The Discord channel permissions allow webhook posts
• Your Server Scout notification settings are properly configured

Rate Limit Considerations

Discord enforces rate limits on webhook usage to prevent abuse. For Server Scout integrations, be aware of these limitations:

• 5 requests per second per webhook
• Burst limit of 10 requests before rate limiting kicks in
• Rate limits reset after a brief cooldown period

To avoid hitting these limits:

Configure Alert Thresholds Wisely

Set reasonable thresholds to prevent notification spam. For example:

• CPU alerts only when usage exceeds 80% for more than 2 minutes
• Memory alerts when usage is above 90% for 5 minutes
• Disk space alerts when usage exceeds 85%

Use Alert Grouping

Enable Server Scout's alert grouping feature to combine multiple related alerts into single messages, reducing the total number of webhook calls.

Implement Notification Schedules

Consider setting up notification schedules to reduce alerts during maintenance windows or off-hours, helping to stay within rate limits whilst ensuring critical alerts still reach your team.

Troubleshooting Common Issues

If you're not receiving alerts:

• Verify the webhook URL is correct and includes /slack
• Check Discord's Server Settings → Audit Log for webhook activity
• Ensure Server Scout has internet connectivity to reach Discord's API
• Review Server Scout logs for any webhook delivery errors

By following this guide, you'll have Server Scout alerts flowing seamlessly into your Discord channels, keeping your team informed of server status without overwhelming them with notifications.