Slack is an instant messaging program designed by Slack Technologies and owned by Salesforce.

What does ChaosSearch offer for Slack users?

ChaosSearch has a one-directional integration with Slack. It is easy to configure alerts to go to a designated Slack channel to notify users of incidents or conditions detected in your cloud-storage log and event files.

Add a Slack integration in ChaosSearch, and start taking advantage of Slack's easy-to-use team collaboration platform with the ChaosSearch alert notification system.

Configuring the Integration

The Slack integration has three main steps:

1. Configure Slack to expose a webhook for alert notifications.
2. Create a webhook on your workspace.
3. Add Slack as a destination in ChaosSearch for alerts.

Configuring Slack to Expose a Webhook for Alert Notifications

1. In the Slack client, click your company or organization name at the top of the Slack window to display the workspace menus.
2. Click Add workspaces, then Create a new workspace.

3. Your browser opens a page that prompts you for your email. Type your email address and click Continue.

3. Type the six digit code that Slack sends to your email for verification.

4. The Slack client displays a page with a message that it is launching your workspace. Depending upon your browser, you might be prompted for permission for the website to launch the workspace in your client application. Allow this.
5. Open your client and there should be a second workspace in the upper left corner. Click on the second workspace.

6. You are prompted for a name for your workspace. Type your desired name.
7. You are prompted for a project description. Type your project description and click next.
8. You are prompted to enter coworkers. Click Skip for this step. On the ensuing prompt, click Skip Step. Coworkers can be added later if desired.
9. You have provisioned your slack workspace. You can jump between your workspaces using the icons in the upper left corner.

Create a Webhook for Your Workspace

1. In the upper left corner, click your new workspace.
2. Click Browse Slack and then click Apps.

3. In the upper right corner of your workspace, click App Directory.

4. A Slack page opens in your web browser. In the search bar, type incoming and click Incoming WebHooks.

5. Click Add to Slack to configure your first webhook.
6. In the Post to Channel box, click the desired channel from the drop-down or run the create a new channel wizard if desired.
7. On the next page, copy your webhook URL (this can always be retrieved again later) and click Save settings.

Add Slack to Alerting Destinations

To add a destination for the Slack integration:

1. Log in to the ChaosSearch console as a user with Analytics access.
2. On the Search Analytics tab, click Alerting in the left menu area. The Alerts page opens.
3. Click Destinations.
4. Click Add destination.
5. Type a name for your integration such as Slack_channel.
6. In the Type field, select Custom Webhook. Some additional fields are added to the page.
7. Select the Define endpoint by URL option.
8. In the Webhook URL field, type or paste the URL from the Incoming Webhook setup page.
9. Click Create.