App for Microsoft Teams alert channel (public preview)

Instana currently supports only SaaS deployments. To proceed with installation, make sure that you have an active login session in Instana.

To create an app for Microsoft Teams alert channel, complete the following steps:

1. From the navigation menu in the Instana UI, click Settings.

2. On the Global settings tab, in the Events & alerts section, click Alert channels.

3. Click Add alert channel.

4. Select App of Microsoft Teams from the list.

5. Enter an app name for the Microsoft Teams alert channel.

6. Obtain the channel link:

   1. Go to Microsoft Teams, and select Chat from the navigation menu.
   2. Click Teams and channels, and find the channel that you want to connect with Instana.
   3. Click the ellipsis button ..., and select Copy link.

7. Paste the channel link in the Channel link field. You can see the Microsoft Teams channel name in the following Channel name field. Check and confirm that the channel information that you entered is correct.

   

8. Click Create.

You can find your alert channel in the Alert channels section in the Instana UI.

1. Go to Microsoft Teams, and select Apps from the navigation menu.

2. Search and add IBM Instana Microsoft Teams App. When adding the app, you must agree to the privacy policy, terms of use, and permissions.

3. Open the IBM Instana Microsoft Teams App. From the Channels section, select the Microsoft Teams channel that you chose to connect. You can use the search bar to find the channel quickly.

   

4. Click Go to use the app at the channel. You are redirected to the channel page, where you can see a draft post with the IBM Instana Microsoft Teams App link.

5. Click Post to send the message to the channel. The app is added to the channel.

You can configure your existing or new alerts with the app for Microsoft Teams alert channel. For more information, see Configuring and managing alerts. All alert events automatically appear in your selected Microsoft Teams channel.

In the Microsoft Teams event message, you can click the Show/Hide Details and Show/Hide Custom Payloads to view or hide the information as you want.

The following images show an event messages that is synchronized from Instana to Microsoft Teams:

Messages are synchronized between Instana and Microsoft Teams. Messages that are added to an incident thread in Microsoft Teams appear in the Summary and notes with AI section of the Instana UI. Similarly, notes that are added in the Summary and notes with AI section of the Instana UI appear in the related Microsoft Teams incident thread.

In addition, the incident and note summaries that are generated in the Summary and notes with AI section of the Instana UI also appear in the related Microsoft Teams incident thread.

Edits and deletions of notes are also synchronized between Microsoft Teams and Instana. When a note is edited in Microsoft Teams, the change is reflected in Instana, and vice versa. Similarly, when a note is deleted from either Microsoft Teams or Instana, it is also removed from the other platform to keep both systems consistent.

To close an incident, issue, or change from the Microsoft Teams, complete the following steps:

1. Select an open incident, issue, or change in Microsoft Teams.

2. Click Close Incident, Close Issue, or Close Monitoring Issues depending on your event type.

   

3. Enter a reason for closure in the closure notes input box, and then click Submit.

   

The event message in the Microsoft Teams channel is updated from an open event to a manually closed event. You can see the status change, the duration of the event, and manual close information as shown in the following image:

The event status in the Instana UI is updated to Manually Closed as shown in the following image:

The privacy policy outlines the types of data that is collected and their purposes.