Discord bot
The ServersPulse Discord bot delivers alert notifications directly to your Discord server and provides commands to check server status, manage alerts, and look up players without leaving chat.
The Discord bot is available on Starter, Pro, and Multi plans.
Setup
1. Link your Discord account
Before using the bot, link your Discord account to ServersPulse:
- Go to Settings in the dashboard
- Under OAuth providers, click to link your Discord account
- Authorize the connection
This allows ServersPulse to identify your Discord user and associate it with your dashboard account.
2. Invite the bot to your guild
Invite the ServersPulse bot to your Discord server using the invite link available in the dashboard. The bot requires permissions to:
- Read and send messages in channels
- Embed links
- Use application commands (slash commands)
3. Link your guild to a server
Once the bot is in your Discord server, link it to one or more ServersPulse servers:
- Use the
/linkcommand in Discord and select the server to connect - Or link from the dashboard's server settings
4. Set an alert channel
Configure which Discord channel receives alert notifications:
- Use the bot command or dashboard settings to set the default alert channel
- Individual notification rules can override this with a specific channel ID (see Alerts)
Available commands
| Command | Description |
|---|---|
/status | Check the current status of a linked server (TPS, MSPT, memory, players) |
/servers | List all servers linked to this Discord guild |
/alerts | View and manage active alerts for linked servers |
/link | Link a ServersPulse server to this Discord guild |
/silence | Temporarily silence alert notifications for a server |
/analyze | Run an analysis on a server's recent performance |
/panel | Display a persistent status panel that updates automatically |
/whois | Look up a player's information (sessions, playtime, etc.) |
/linkeduser | View information about a linked ServersPulse user |
Alert notifications
When a notification rule triggers on a linked server, the bot sends a message to the configured alert channel with:
- The server name
- Incident type and severity
- A description of what triggered the alert
- Relevant metric values
- A link to the incident in the dashboard
If Spark auto-profiling is enabled on the rule and a Spark profile was captured, the profile URL is included in the notification.
Silencing alerts
Use the /silence command to temporarily suppress notifications for a server. This is useful during:
- Planned maintenance or restarts
- Known issues you are actively working on
- Events that cause expected metric spikes
Silencing only affects Discord notifications -- incidents are still created and visible in the dashboard.
Linking multiple servers
A single Discord guild can be linked to multiple ServersPulse servers. This is useful if you run a network with multiple game servers and want alerts from all of them in one place.
Each server can be linked to multiple guilds as well, so you can have alerts going to both a staff Discord and a community Discord.
Troubleshooting
| Problem | Solution |
|---|---|
| Bot not responding to commands | Ensure the bot has permission to read messages and use slash commands in the channel |
| No alert notifications | Check that an alert channel is set and the bot has send-message permission in that channel |
/link shows no servers | Ensure your Discord account is linked in the dashboard settings and you own or have access to servers |
| Commands show "no linked servers" | Use /link to connect a ServersPulse server to the guild first |
| Alerts going to wrong channel | Check if individual rules have a Discord channel override set |
Contributors
Thanks to everyone who keeps this docs area accurate.
