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 |
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 |