Before you set up the integration, you’ll need a few things:
a user account in your team’s Microsoft Teams organization
a user account in your Honeycomb Team
Setting Up Your Integration
Before you can configure Honeycomb to send alerts to Microsoft Teams, you must set up your integration.
Create an Incoming Webhook for your Microsoft Teams Channel
In Microsoft Teams, you must create an incoming webhook for your channel.
Once you have generated your webhook URL, you will provide it to Honeycomb.
To learn how to configure an incoming webhook in Microsoft Teams, visit Microsoft’s Microsoft Teams Incoming Webhooks documentation.
Create Your Integration in Honeycomb
To create your integration, you must add your Microsoft Teams webhook to Honeycomb.
Navigate to Team Settings, and select the Integrations view.
Locate the Trigger and SLO Recipients section, and select Add Integration.
For Provider, select MS Teams, then enter a name that will be easy to find when you configure alerts in the future, and paste the Microsoft Teams Incoming Webhook URL.
Select Add.
Configuring Alerts to Use Microsoft Teams as a Recipient
After your integration is set up in Honeycomb, you can configure Triggers and SLOs to use Microsoft Teams as a recipient for alerts.
Configuring Triggers to Alert Microsoft Teams
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 MS Teams integration, then select Add.
Select Save Trigger.
Configuring SLO Burn Alerts to Alert Microsoft Teams
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 MS Teams 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 MS Teams integration, then select Edit.
