Integrations

Discord Integration

Receive instant error notifications in your Discord server. Ideal for developer communities and teams using Discord for collaboration.

Tier Requirement

Discord notifications are included in Bootstrapper, Compliance, and Scale plans.

Setup Guide

Create a Discord Webhook

Open your Discord server, go to Server Settings → Integrations, and click Webhooks → New Webhook.

Configure the webhook:

Name: LuminaLog Alerts
Channel: Select the channel for alerts
Avatar: Optional custom icon

Click Copy Webhook URL.

Configure Alert Rule in LuminaLog

Navigate to your project dashboard, go to Alerts → Alert Rules, and click Create Alert Rule.

Configure the rule:

Rule Name: e.g., "Discord Production Alerts"
Error Type: Specific error or "*" for all
Severity: error, fatal, or panic
Channels: Select "Discord"
Discord Webhook URL: Paste your webhook URL

Click Save.

Protect your webhook URL

Anyone with your webhook URL can post messages to your Discord channel. Keep it secure and never share it publicly.

Alert Format

Discord alerts use rich embeds with color-coded severity levels:

🚨 Error Alerts

Red embeds for immediate attention when new exceptions are caught.

⚠️ Threshold Alerts

Orange alerts when error frequency exceeds set limits.

✅ Resolved Alerts

Green confirmation when an error stream has stabilized.

📊 Grouped Summaries

Blue periodic roll-ups of all project activity.

Advanced Configuration

Multiple Channels

Create separate webhooks for different alert types:

#critical-errorsFatal and panic

#api-monitoringAPI-specific

#error-feedAll errors

Role Mentions

You can mention roles in Discord by including them in custom alert messages:

Get your role ID from Discord (enable Developer Mode)
Right-click the role and copy ID
Use <@&ROLE_ID> in alert messages

Pro Tip: Use threads

Enable "Create a thread for each message" in your webhook settings to keep alert discussions organized.

Alert Filtering

By Severity

Only send fatal/panic to Discord

By Error Type

Filter specific error patterns

By Threshold

Only alert on error spikes

Grouped Updates

Send hourly summaries instead

Best Practices

Channel Organization

Create a dedicated #alerts category
Use separate channels for dev and prod
Set up a #critical-only channel with mentions
Archive old alert channels periodically

Notification Control

Mute non-critical channels during off-hours
Use Discord's notification overrides
Enable mobile push for critical channels
Set up keyword notifications

Troubleshooting

Webhook Not Working

Verify the URL is correct and not expired, check server permissions, and ensure the channel exists.

Rate Limiting

Discord limits to 30 requests/min. Enable Grouped Updates or increase thresholds to reduce noise.

Direct Connectivity Test

Test your webhook connectivity using a simple curl command:

curl -X POST "YOUR_WEBHOOK_URL" \
-H "Content-Type: application/json" \
-d '{"content": "Test message from LuminaLog"}'

Example Configuration

{
  "ruleName": "Discord Critical Alerts",
  "errorType": "*",
  "severity": "fatal",
  "channels": ["discord"],
  "discordWebhookURL": "https://discord.com/api/webhooks/...",
  "countThreshold": 3,
  "timeWindowMinutes": 15,
  "enabled": true
}