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
Permissions scope and purpose
To install the Grafana IRM app on Microsoft Teams, certain permissions are required. By granting access to the app, you are authorizing it to interact with your Microsoft Teams account, as detailed below:
Workspace access
Permission
Description
Read and write the names, descriptions, and settings of all channels
Read channel basic settings where the bot is installed to show in Incident
Allow the Teams app to manage itself for all teams
Allow Grafana IRM bot to install itself in the Microsoft Teams Workspace
Read all teams’ settings
To read the Team settings and info
Read all users’ full profiles
This permission enables us to fetch profile data, such as Microsoft Teams handlers and avatars
Read contacts in all mailboxes without a signed-in user
This permissions enables us to find users by email and facilitate account matching between Grafana and your workspace
Channel access
Permission
Description
Receive messages mentioning the bot
The app can access messages directed at it within channels or chats
Send channel notifications
The app can send notifications to the designated channel
Access Team Information
This includes team and channel names, roster details, and member information
Message and conversation access
Permission
Description
Receive messages
The app can receive and process messages that mention the bot
Send messages
It can send notifications and messages within the channel where incidents are declared
Access user profile information
This includes basic profile details like name, email, company, and language preference
Create Incident-specific Conversations
The bot is authorized to initiate new incident-specific conversations or threads within the ‘originator channel’
View Direct Mentions
The app has the ability to view messages specifically mentioning ‘@Grafana IRM’ within conversations it is engaged in