Documentation Grafana Cloud Alerts and IRM IRM Connect integrations Chat and collaboration Microsoft Teams

Microsoft Teams integration for Grafana IRM

The Microsoft Teams integration for Grafana IRM enables you and your team to respond to alert groups and manage incidents without leaving Microsoft Teams. Alert group notifications include interactive cards with Acknowledge, Resolve, and Silence buttons. For incidents, the integration creates dedicated threads, tracks the timeline of events, and lets you manage the incident lifecycle using the Grafana IRM bot.

Before you begin

To use the Microsoft Teams integration, you need:

• Microsoft Teams owner or admin permissions
• Ability to approve org-wide app deployment in Teams
• Admin permissions in Grafana IRM (chatops:update-settings permission is required)

Configure the Microsoft Teams integration

1. Navigate to IRM > Integrations in the Grafana Cloud main menu
2. Select the Apps tab
3. Click the Microsoft Teams tile
4. Click Install Integration
5. When redirected to Microsoft Teams, enter your credentials if prompted
6. Review the Grafana IRM app and requested permissions, then click Accept
7. Follow the prompts in Teams to allow Grafana IRM to access your Microsoft Teams
8. Configure the integration settings:
   • Select a Team
   • Select a default channel for incident posts and thread creation
   • Choose which incident types to announce (drill incidents, non-drill incidents, or both)

Once redirected back to Grafana IRM, the Microsoft Teams workspace is connected for incident notifications.

Customize incident thread settings

After you install the integration, new incidents are announced in your designated Microsoft Teams channel. The incident thread stays up to date throughout the incident lifecycle.

You can customize the following settings:

• Team and channel selection: Specify where incident announcements should be posted
• Incident types: Choose which types of incidents are announced (drill, non-drill, or both)
• Important incident updates: Enable or disable “Post important items to the thread”

When important updates are enabled, the following activities are automatically shared in the incident thread:

Alert group notifications

When an alert group is routed to Microsoft Teams, Grafana IRM posts an adaptive card to the linked channel or your direct message. Each card displays the alert group status, title, source integration, and a link to view the alert group in IRM.

Interactive card actions

Alert group cards include action buttons you can use directly in Teams without opening Grafana:

The card status and buttons update automatically as the alert group state changes.

Link your Teams account to use interactive actions

To link your account:

1. In Grafana Cloud, click your avatar and open your Profile.

2. Select the IRM tab.

3. Click MS Teams connection.

4. Copy the generated link code.

5. In Microsoft Teams, open a direct message with the Grafana IRM bot.

6. Send the following command, replacing <CODE> with the code you copied:

   text Copy

   linkUser <CODE>

Once linked, you can acknowledge, resolve, and silence alert groups directly from Teams cards.

Bot commands for alert groups

Send the following commands to the Grafana IRM bot. Use linkUser in a direct message and linkTeam in a channel.

Incident bot commands

Use the following @Grafana IRM commands in Microsoft Teams to manage incidents:

Required permissions

The Grafana IRM app requires the following permissions in Microsoft Teams:

Workspace access permissions

Channel access permissions

Message and conversation permissions