Skip to main content

Slack Integration

Overview​

Slack is the primary notification channel for OpsWorker investigation results. Connect Slack to receive investigation summaries, feedback buttons, and daily alert digests in your team channels. Slack is configured per cluster, with routing from each Kubernetes namespace to a channel.

What It Enables​

  • Investigation notifications: root cause, affected resources, and fix commands delivered to Slack
  • Feedback buttons: rate investigation quality directly from Slack
  • Daily alert digest: automated daily summary of alert activity
  • Investigation links: click through to the portal for full details

Setup​

1. Install from Portal​

  1. Go to Integrations → Slack → Install
  2. Click Connect to Slack

2. Authorize​

  1. Select your Slack workspace
  2. Review requested permissions
  3. Click Allow

3. Add Namespace Routing​

OpsWorker routes notifications per (cluster + Kubernetes namespace) to a single Slack channel. After authorizing, open the Slack integration screen and click Add Namespace Routing to map each namespace to the channel that should receive its notifications (for example, production to #prod-incidents).

Permissions​

OpsWorker requests the OAuth scopes it needs to post and manage notifications. These include reading channel history, which Slack requires for some message-management operations.

PermissionPurpose
Send messagesPost investigation results and daily digests
Post to channelsDeliver notifications to configured channels
Read channel historyManage and update notifications OpsWorker posts

OpsWorker reads only what it needs to post and manage its own notifications. It does not mine your team conversations.

Investigation Message Format​

Each investigation notification includes:

  • Alert summary: what triggered the investigation
  • Root cause: AI-identified cause with explanation
  • Affected resources: pods, services, deployments involved
  • Recommendations: immediate actions with kubectl commands
  • Feedback buttons: Accurate / Partially Accurate / Needs Improvement
  • Portal link: full investigation details

Next Steps​