Setup and configuration - Slack
What this integration sends
The Slack integration is a feature of the DockRay panel itself, not something installed on the client's side. The notification channel posts to chosen Slack channels whenever the scheduler or the ingest pipeline detects one of five monitoring events:
- ping - the application server stops responding,
- ssl - the certificate is about to expire,
- google-page-speed - a performance drop,
- issue - a new error, never seen before,
- error-spike - a sudden surge in the number of errors.
Each event type has its own switch and can go to its own channel - availability incidents to the on-call channel, performance to whoever owns upkeep.
Preparing things on the Slack side
- Create a Slack app in your workspace (api.slack.com/apps).
- Under OAuth & Permissions, add the bot scope
chat:write. - Install the app to the workspace and copy the Bot User OAuth Token - it starts with
xoxb-. - Invite the bot to the channels alerts should reach: always for private channels, and for public ones too if the bot cannot join them on its own.
DockRay rejects a token without the xoxb- prefix right when the form is saved - the most common mistake at this step is pasting a user token (xoxp-) or a signing token (xoxs-) instead of the bot token.
Configuring it in the DockRay panel
There is one screen for the account and one for a project: Settings → Notification channels, and for a single project, Project settings → Notification channels. Editing requires the project-management permission, held by the developer role and above.
- Enable the Slack provider and paste the bot token.
- For each event type, enter a channel - a name (e.g.
#alerts) or a channel ID. - Save. Leaving the token field blank on save means 'keep what is stored' - the credential never comes back to the form in plain text.
A project inherits the account's configuration by default. It can also override it with its own token and channels, or explicitly turn a given event type off, independently of what the account has set.
The test message
Every event type has a Send test button. It posts a sample message down the exact path a real alert would take - it only works once everything is in place: a saved or freshly entered token and a channel. The test therefore confirms not just that the token is valid, but that the bot is actually visible in the target channel.