Grafana Cloud

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

  1. Click Incidents in the left-side menu.
  2. Click Integrations.
  3. Select the Microsoft Teams tile and then Install Integration.
  4. Once redirected to Microsoft Teams, enter your Teams credentials.
  5. Review the Grafana App and permissions required, click Accept.
  6. Follow the prompts in Teams to allow Grafana Incident to access your Microsoft Teams.
  7. 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 kindUpdate
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 commandDescription
incident helpList of all /incident commands
incident new something went wrongCreate new incident
incident new <severity> “title”Create new incident with severity
incident listList all active incidents
incident rolesFind out who’s involved in an incident
incident talkFind an online place to discuss
incident statusGet a live inline update
incident severitySet the incident severity
incident severity majorUpdate the incident severity to major
incident tasksCreate, assign and manage tasks
incident tasks helpGet more information about tasks
incident task add 'deploy new release'Add a new task
incident task add 'deploy new release' @bobAdd a new task and assign to @bob
incident tasks listView current tasks
incident notesAdd and view incident notes
incident notes helpMore information about notes
incident note add "customer is aware of the problem"Add a new note
incident notes listView current notes
incident stacksList 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

Read and write the names, descriptions, and settings of all channelsRead channel basic settings where the bot is installed to show in Incident
Allow the Teams app to manage itself for all teamsAllow Grafana IRM bot to install itself in the Microsoft Teams Workspace
Read all teams’ settingsTo read the Team settings and info
Read all users’ full profilesThis permission enables us to fetch profile data, such as Microsoft Teams handlers and avatars
Read contacts in all mailboxes without a signed-in userThis permissions enables us to find users by email and facilitate account matching between Grafana and your workspace

Channel access

Receive messages mentioning the botThe app can access messages directed at it within channels or chats
Send channel notificationsThe app can send notifications to the designated channel
Access Team InformationThis includes team and channel names, roster details, and member information

Message and conversation access

Receive messagesThe app can receive and process messages that mention the bot
Send messagesIt can send notifications and messages within the channel where incidents are declared
Access user profile informationThis includes basic profile details like name, email, company, and language preference
Create Incident-specific ConversationsThe bot is authorized to initiate new incident-specific conversations or threads within the ‘originator channel’
View Direct MentionsThe app has the ability to view messages specifically mentioning ‘@Grafana IRM’ within conversations it is engaged in