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