Before you set up the integration, you’ll need a few things:
a user account in your team’s Slack organization
a user account in your Honeycomb Team
Setting Up Your Integration
Before you can configure Honeycomb to send alerts to Slack, you must set up your integration.
Create Your Integration in Honeycomb
To create your integration, you must add your Slack to Honeycomb.
Navigate to Team Settings, and select the Integrations view.
Locate the Honeycomb + Slack section, and select Add to Slack.
When Slack requests that you authorize Honeycomb, select Allow.
Note
To send alerts to public Slack channels, only one of your Slack team’s members needs to authorize Honeycomb.
Team members who want to send alerts to their private channels or to themselves must authorize Slack on an individual basis.
Once authorized, Honeycomb will send alerts to your Slack channels with features like link unfurling, which shows a preview of your Honeycomb query result graphs.
Configuring Alerts to Use Slack as a Recipient
After your integration is set up in Honeycomb, you can configure Triggers and SLOs to use Slack as a recipient for alerts.
Configuring Triggers to Alert Slack
In the Honeycomb UI, navigate to Triggers.
Select the name of the trigger you want to configure, or create a new trigger by clicking New Trigger.
Locate the Recipients section, and select Add Recipient.
In the Add Trigger Recipient modal, locate the Recipient dropdown and choose your Slack integration, then select Add.
Select Save Trigger.
Configuring SLO Burn Alerts to Alert Slack
In the Honeycomb UI, navigate to SLOs.
In the list, locate the SLO you want to configure, or create a new SLO by clicking New SLO.
Find your SLO in the list, and click the Configure button in the Burn Alerts column.
Click New Burn Alert.
In the Create Burn Alert form, set your desired exhaustion time, then choose your Slack integration in the Notify dropdown. Set your desired Severity (Critical is the default).
Select Create Burn Alert.
Removing the Integration
To remove the integration, you will need to delete it from your Honeycomb team.
Deleting the integration from your team will remove it from all associated triggers and SLOs.
Navigate to Team Settings, and select the Integrations view.
Locate Trigger and SLO Recipients and find your Slack integration, then select Edit.