Microsoft Teams integration for Grafana Incident
Grafana Incident integrates seamlessly with Microsoft Teams, enabling you and your team to declare, collaborate on, and manage incidents without leaving the Teams platform. With this integration, you can automatically create incident-specific threads, track the timeline of events, interact with incidents using the Grafana Teams bot, and more.
Before you begin
The Grafana Microsoft Teams app uses org-wide deployment and requires permission to access your Microsoft Teams to deploy the Teams bot.
To install the Grafana Incident Teams app:
- Ensure that you are a Microsoft Teams owner or admin.
- Allow Grafana Incident to access your Microsoft Teams.
Install Microsoft Teams integration for Grafana Incident
- Click Incidents in the left-side menu.
- Click Integrations.
- Select the Microsoft Teams tile and then Install Integration.
- Once redirected to Microsoft Teams, enter your Teams credentials.
- Review the Grafana App and permissions required, click Accept.
- Follow the prompts in Teams to allow Grafana Incident to access your Microsoft Teams.
- Set up the triggers, specify the Team and the default channel for incident posts and thread creation. For example, Team Incidents Channel general.
Once you’re redirected back to Grafana Incident, your Microsoft Teams and Grafana Cloud accounts are automatically linked.
Customize incident thread settings
Once the Grafana Incident app is installed, new incidents are announced in a designated MS Teams channel. The incident thread is also kept up-to-date throughout the incident’s lifecycle.
To tailor this integration to your specific needs, you can customize the following settings related to the MS Teams incident thread:
Team and channel selection: Specify a channel to post incident announcements. This ensures that the right audience within your organization is immediately informed when an incident occurs.
Incident type: You have the option to choose which types of incidents are announced in MS Teams; Drill incidents, non-drill incidents, or both, depending on your organization’s preferences.
Important incident updates: You can enable or disable the
Post important items to the thread
checkbox. When enabled, the following updates are automatically shared in the incident thread:
Activity kind | Update |
---|---|
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 |
Available Microsoft Teams commands
To streamline incident response and reduce administrative tasks, you can use the following @Grafana IRM incident
commands within Microsoft Teams. These commands help your team focus on what’s important without having to switch between multiple windows or update stakeholders manually.
incident command | Description |
---|---|
incident help | List of all /incident commands |
incident new something went wrong | Create new incident |
incident new <severity> “title” | Create new incident with severity |
incident list | List all active incidents |
incident roles | Find out who’s involved in an incident |
incident talk | Find an online place to discuss |
incident status | Get a live inline update |
incident severity | Set the incident severity |
incident severity major | Update the 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 new task and assign to @bob |
incident tasks list | View current tasks |
incident notes | Add and view incident notes |
incident notes help | More information about notes |
incident note add "customer is aware of the problem" | 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 |
Related resources from Grafana Labs


