Slack app alert channel
You can create a Slack app alert channel to send real-time alert notifications from Instana to that Slack channel.
Installation Prerequisites
Instana currently supports only SaaS deployments. To proceed with installation, make sure that you have an active login session in Instana.
Creating a Slack app alert channel
To create a Slack app alert channel, complete the following steps:
-
From the navigation menu in the Instana UI, click Settings.
-
On the Global settings tab, in the Events & alerts section, click Alert channels.
-
Click Add alert channel.
-
Select Slack app from the list.
-
Enter a name for the Slack application alert channel.
“Figure Display Emoji: Enable this option to convert emoji strings from Instana (for example,
:warning:
) into visual emojis when shown in Slack. If this option is disabled, the strings will appear as plain text. -
Click Authenticate in Slack.
The Slack login page appears. You must select a Slack workspace and authorize the application with the necessary permissions.
“Figure -
After authentication, select the Slack channel to receive alerts and click Save.
If you select a private Slack channel, first install the IBM Instana app at workspace level by using any public Slack channel. Then, complete the steps in Using the Slack application with a private channel.

You can find your alert channel in the Alert channels section in the Instana UI.
You need to re-authenticate the alert channel with Slack if you edit an alert channel after it is created.
Required scopes
The Slack app requires the following OAuth scopes:
channels:history
channels:read
chat:write
groups:history
groups:read
users:read
Adding IBM Instana app to the Slack channel integrations
You need to perform this integration for both public and private channels in Slack.
-
Click the channel name of the conversation area. A panel appears with channel information.
-
In the channel details panel, select the Integrations tab.
-
On the Integrations tab, click Add apps and type IBM Instana.
-
Select IBM Instana.
“Figure
Using the Slack application with a private channel
Complete the following steps to use the IBM Instana app within a private Slack channel:
- Prerequisite: you need to install the IBM Instana app in a public Slack channel.
- In Slack, open your private channel and click the channel name at the top of the conversation area. The channel details panel opens.
- Select the Integrations tab.
- Click Add apps, then search and select IBM Instana. please refer Adding IBM Instana app to the Slack channel integrations.
- After adding the app, create your Slack app alert channel in the Instana by following the steps described in Creating a Slack app alert channel.
Configure alerts in the Instana UI
You can configure your existing or new alerts with the Slack app alert channel. please refer Configuring and managing alerts. All alert events automatically appear in your selected Slack channel.
Synchronization of Slack and Instana message
Messages are synchronized between Instana and Slack. Messages that are added within an incident in slack thread appear in the Notes and activities with AI section in the Instana UI. Similarly, notes that are added in the Notes and activities with AI section of Instana UI appear within the Slack under incident thread.
Currently, this Message synchronisation feature between Slack and Instana is only applicable for Instana incidents.


Closing event from Slack
To close an incident, issue, or change from the Slack application, complete the following steps.
-
Select an open incident, issue, or change in Slack.
-
Click Close incident, Close issue, or Close Monitoring issues depending on your event type.
“Figure -
Enter a reason for closure, then click Ok.
“Figure
The event status in the Instana UI should be updated to manually closed.

Privacy policy
The privacy policy outlines the types of data that are collected and their purposes.
Data collection practices
When you install and use the IBM Instana app for Slack, the following types of information are collected:
- Slack Workspace Information: Team name, team ID, and channel details to enable posting of notifications and interactions.
- User Information: Slack usernames to generate actions and maintain notes of interactions.
- Message Content: Limited content of messages or events that you explicitly interact with or authorize the application to access to alert or provide interactive functionality.
For more information, see IBM data retention policy.
Data retention regarding the management and storage of third-party data complies with established policies of IBM.
Usage of your information
The collected details are used to:
- Provide, maintain, and improve integration features
- Deliver relevant notifications and updates to your Slack channels as per the configuration
- Support troubleshooting, debugging, and technical assistance upon request
- Comply with applicable laws and regulations
For more information, see IBM Terms and Privacy.
Support and Feedback
For more information about support and feedback, see IBM Instana support.