Slack integration for Grafana Incident
Grafana Incident integrates with your Slack workspace so you and your team can declare, collaborate on, and manage incident-worthy events without leaving Slack. Automatically create incident-specific channels, track the timeline of events, interact with your incident via the Slack bot, and more.
Before you begin
The Grafana Incident Slack app uses org-wide deployment and requires permission to access your Slack workspace to deploy the Slack bot.
To install the Grafana Incident Slack app:
- You must be a Slack workspace owner or admin
- Allow Grafana Incident to access your Slack workspace
Note: Slack has not yet reviewed this app but it is safe to install.
Install Slack integration for Grafana Incident
- Click Incidents in the left-side menu.
- Click Integrations.
- Click the Slack tile and then Install Integration.
- Once redirected to Slack, enter your workspace URL and click Continue.
- Enter your Slack credentials and verify the Slack workspace is correct.
- Follow the Slack prompts to allow Grafana Incident to access your Slack workspace and specify a default channel for Grafana Incident to post to, for example, #incidents.
Once you’re redirected back to Grafana Incident, your Slack and Grafana Cloud accounts are automatically linked.
Customize Slack channel prefixes
Prefixes determine the name of automatically created incident channels. For example, if the channel prefix is incident
, the channel name will be #incident-date-title
.
Customizing Slack channel prefixes is optional but helps keep incident channels organized and searchable.
To customize Slack channel prefixes:
- Click Incidents in the left-side menu.
- Click Settings.
- Navigate to Prefixes at the bottom of the Settings page.
- Click + Add Prefix and provide a name and description.
- Edit any existing prefixes and click Update.
Once your prefixes are defined, you can specify which prefix to use when you declare an incident in Grafana Incident.
Note: Incident channels are set as public channels by default. Private channel creation isn’t supported in the current version.
Available Slack commands
It can be easy for things to get lost in the chaos of incident response; the /incident
Slack commands allow teams to focus on what’s important and reduce administrative tasks.
Use the /incident
Slack commands to run and participate in incidents without leaving Slack. Minimize the number of windows you and your team are switching between, delegate a task with one command and remove the need to update a stakeholder.
Tip: Use the 🤖 robot emoji Slack reaction to add important messages to the incident timeline.
/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 |
/incident talk | find an online place to talk |
/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 | 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 |
Manage Slack attachments
When you react to a Slack message containing a file with the 🤖 emoji, the file is securely copied to Grafana Cloud storage, safeguarding your incident timeline from data loss, even if they are deleted from Slack. Here’s how it works:
- File retention: You can control attachment retention in your incident timeline. Removing the 🤖 reaction promptly deletes attached files from Grafana Cloud storage.
- Incident web app: Deleting an item from the timeline within the Incident web app also removes the associated file from Grafana Cloud storage.
- File size limit: Files in Grafana Incident are limited to 100MB. Be mindful of this limit when sharing files via Slack messages to ensure successful preservation.
If a file is too big to persist, it will still be accessible via a link to the source file in Slack.
Permissions scope and purpose
The Grafana Incident Slack app only requests permissions that are essential for its proper functioning and integration with Grafana Incident and Slack. By granting access to the app, you are providing authorizations to your Grafana Incident and Slack accounts, as detailed below:
Workspace access
Permission | Description |
---|---|
View the workspace name, email domain, and icon | We use this information for identification and to establish the association with your workspace |
View people in a workspace | Used to find users by email and facilitate account matching between Grafana and your workspace |
View profile details about people in a workspace | This permission enables us to fetch profile data, such as Slack handles and avatars |
Access public channels
Permission | Description |
---|---|
View basic information about public channels | To list Slack channels when adding the app to new channels |
Manage public channels that Grafana Incident has been added to and create new ones | Allows the app to create new channels and invite users to these channels |
View files shared in channels and conversations that Grafana Incident is a part of | For incident-related file sharing and collaboration within authorized channels |
View pinned content in channels and conversations that Grafana Incident has been added to | To access and display pinned content related to incidents |
View messages and conversations
Permission | Description |
---|---|
View messages and other content in public channels that Grafana Incident is a part of | Enables the app to read messages and related content within authorized channels |
View messages that directly mention @grafana_incident in conversations that the app is a part of | To identify me |
Was this page helpful?
Related resources from Grafana Labs
![Getting started with the Grafana LGTM Stack](/static/assets/featured/getting-started-with-grafana-lgtm-stack-amer_featured.png?w=200 200w, /static/assets/featured/getting-started-with-grafana-lgtm-stack-amer_featured.png?w=400 400w)
![Intro to Kubernetes monitoring in Grafana Cloud](/media/webinar/Screenshot-2024-02-12-at-4.09.30-PM.png?w=200 200w, /media/webinar/Screenshot-2024-02-12-at-4.09.30-PM.png?w=400 400w)
![Building advanced Grafana dashboards](/media/webinar/AMER_buildadv_notxt.png?w=200 200w, /media/webinar/AMER_buildadv_notxt.png?w=400 400w)