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:

  1. From the navigation menu in the Instana UI, click Settings.

  2. On the Global settings tab, in the Events & alerts section, click Alert channels.

  3. Click Add alert channel.

  4. Select Slack app from the list.

  5. Enter a name for the Slack application alert channel.

    “Figure
    Slack app Alert Channel

    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.

  6. Click Authenticate in Slack.

    The Slack login page appears. You must select a Slack workspace and authorize the application with the necessary permissions.

    “Figure
    Slack App Oauth

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

“Figure
Channel Selection

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.

  1. Click the channel name of the conversation area. A panel appears with channel information.

  2. In the channel details panel, select the Integrations tab.

  3. On the Integrations tab, click Add apps and type IBM Instana.

  4. Select IBM Instana.

    “Figure
    Adding Slack app

Using the Slack application with a private channel

Complete the following steps to use the IBM Instana app within a private Slack channel:

  1. Prerequisite: you need to install the IBM Instana app in a public Slack channel.
  2. In Slack, open your private channel and click the channel name at the top of the conversation area. The channel details panel opens.
  3. Select the Integrations tab.
  4. Click Add apps, then search and select IBM Instana. please refer Adding IBM Instana app to the Slack channel integrations.
  5. 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.

“Figure
Instana notes

“Figure
Slack thread

Closing event from Slack

To close an incident, issue, or change from the Slack application, complete the following steps.

  1. Select an open incident, issue, or change in Slack.

  2. Click Close incident, Close issue, or Close Monitoring issues depending on your event type.

    “Figure
    close-button

  3. Enter a reason for closure, then click Ok.

    “Figure
    popup

The event status in the Instana UI should be updated to manually closed.

“Figure
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.