Microsoft Teams integration for Grafana IRM

The Microsoft Teams integration for Grafana IRM enables you and your team to declare, collaborate on, and manage incidents without leaving the Teams platform. This integration creates incident-specific threads, tracks the timeline of events, and lets you interact with incidents using the Grafana Teams 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
Editor or Admin permissions in Grafana IRM

Note
The Grafana Microsoft Teams app uses org-wide deployment and requires permission to access your Microsoft Teams to deploy the Teams bot.

Configure the Microsoft Teams integration

Navigate to IRM > Integrations in the Grafana Cloud main menu
Select the Apps tab
Click the Microsoft Teams tile
Click Install Integration
When redirected to Microsoft Teams, enter your credentials if prompted
Review the Grafana App and requested permissions, then click Accept
Follow the prompts in Teams to allow Grafana IRM to access your Microsoft Teams
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, your Microsoft Teams and Grafana accounts will be automatically linked.

Customize incident thread settings

After installing the integration, new incidents are announced in your designated MS Teams channel, with the incident thread kept up-to-date throughout the incident’s 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:

Activity type	Updates shared
Incident	Created, Closed, Start, End, Title changed, Severity changed, Status changed, Summary
Role	Assigned (Commander), Assigned (Investigator)
Label	Added, Removed
Action	Run
Sift	Suggestion
Data	Query
User	Note
Task	Completed

Microsoft Teams bot commands

You can use the following @Grafana IRM commands within Microsoft Teams to manage incidents directly:

Command	Description
`incident help`	List all available commands
`incident new something went wrong`	Create a new incident
`incident new <severity> "title"`	Create a new incident with specified severity
`incident list`	List all active incidents
`incident roles`	See who’s involved in the current incident
`incident talk`	Find an online place to discuss the incident
`incident status`	Get a live inline status update
`incident severity`	Set the incident severity
`incident severity major`	Update incident severity to major
`incident tasks`	Create, assign and manage tasks
`incident tasks help`	Get more information about tasks
`incident task add 'deploy new release'`	Add a new task
`incident task add 'deploy new release' @bob`	Add a task and assign to @bob
`incident tasks list`	View current tasks
`incident notes`	Add and view incident notes
`incident notes help`	Get more information about notes
`incident note add "customer is aware"`	Add a new note
`incident notes list`	View current notes
`incident stacks`	List Grafana stacks
`incident stack <stack-name>`	Set default stack for new incidents

Required permissions

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

Workspace access permissions

Permission	Purpose
Read and write channel names, descriptions, and settings	Read channel settings where the bot is installed
Allow the Teams app to manage itself for all teams	Allow the Grafana IRM bot to self-install
Read all teams’ settings	Access Team settings and information
Read all users’ full profiles	Fetch profile data like Teams handlers and avatars
Read contacts in all mailboxes	Find users by email and match accounts between Grafana and Teams

Channel access permissions

Permission	Purpose
Receive messages mentioning the bot	Access messages directed at the bot
Send channel notifications	Send notifications to the designated channel
Access Team Information	Access team and channel names, roster details

Message and conversation permissions

Permission	Purpose
Receive messages	Process messages mentioning the bot
Send messages	Send notifications within incident channels
Access user profile information	Access basic profile details
Create Incident-specific Conversations	Create new incident threads
View Direct Mentions	View messages mentioning ‘@Grafana IRM’