Office 365/Microsoft teams alert channel
- Office 365 connectors deprecation
- Creating an Office 365 or Microsoft Teams alert channel
- Alerting examples
Office 365 connectors deprecation
With the Retirement of Office 365 connectors within Microsoft Teams, the ability to create new connectors will be blocked after August 15, 2024. Existing webhooks are supported until Microsoft removes them completely. Refer to the following instructions to migrate to workflows at the earliest.
Steps for migrating to workflows
In order to migrate from existing alert channels that uses a webhook URL, please replace your Workflow / Webhook URL field on the UI with a valid workflow URL. Follow step 1 under Creating an Office 365 or Microsoft Teams alert channel for creating new workflow URLs for your channels.
There will be design changes to the alerts received through workflows as they use AdaptiveCard template. Existing alert channels that uses an incoming webhook URL will follow the old design using the MessageCard template. Check out Alerting Examples section for design changes
Creating an Office 365 or Microsoft Teams alert channel
To send alert notifications from Instana to Office 365 or Microsoft Teams in real time, create an Office 365 or Microsoft Teams alert channel.
Alert notifications are sent to Office 365 or Microsoft Teams by using Workflows or Incoming Webhooks See the following instructions on how to create these integrations.
Step 1: Getting Workflow or Webhook URL
Workflows
Follow the instructions from Microsoft to create a workflow by using the
template Post to a channel when a webhook request is received.
Validate the permission settings that are necessary for the Microsoft Teams channels.
- Public channel: If channel moderation is enabled, make sure to select the
Allow bots to submit channel messagespermission in the Microsoft Teams channel settings. - Private channel: By default, workflow bots do not support posting to private channels. As a workaround, modify the workflow to post as a user.
Incoming Webhooks
New incoming webhook connectors cannot be created in Microsoft Teams after 15 August 2024. To migrate from existing incoming webhooks to workflows, follow the steps under Workflows section and update the Instana alert channel webhook URL to the workflow URL.
To set up an Incoming Webhook for the Office 365 or Microsoft Teams alert channel integration, see Post external requests to Teams with Incoming Webhook.
Step 2: Creating an alert channel
Create an Office 365 or Microsoft Teams alert channel by navigating to Settings > Team Settings > Events & Alerts > Alert Channels > Add Alert Channel in the Instana UI.
Alerting examples
After you create the alert channel, Instana sends alerts for events as an HTTP POST to the configured Office 365 or Microsoft Teams Workflow or Webhook URL (HTTP or HTTPS), which is the address that the alerts are sent to.
See the following examples:
Workflows
On open issues or incidents
On closed issues or incidents
Closed By Instana
Manually closed
Incoming Webhooks
On open issues or incidents
On closed issues or incidents
