Slack

The Slack Notifier allows you to notify one or more channels in your Slack workspace upon notifier invocation. This page will explain how to set it up in your Humio instance.

Creating Your Slack App

Before you can create your Slack Notifier within Humio, you must configure your Slack workspace with a new app.

To do this:

  1. Go to The Slack Apps Directory

  2. Click “Create New App”

  3. Select a name for the app, and the workspace you want to message with your notifier

  4. Click “Create App”

You now have a new app connected to your workspace. This needs to be configured in one of two ways, depending on how you want to notifiy Slack from Humio. These are described in the following subsections.

Incoming Webhook

If you want your notifier to notify only a single Slack channel upon invocation, you need to configure your app with an Incoming Webhook. To do this, start from the main screen of your new Slack app and follow these steps:

  1. Under “Add features and functionality” go to “Incoming Webhooks”

  2. Activate incoming webhooks

  3. Click “Add New Webhook to Workspace”

  4. Choose your desired channel to message

  5. Save the webhook.

Note down the newly generated url listed under the “Webhook URL” section.

OAuth Scope

If you want your notifier to message multiple Slack channels on a single invocation, you need to configure your app with an OAuth Scope. To do this, start from the main screen of your new Slack app and follow these steps:

  1. Under “Add features and functionality” go to “Permissions”

  2. Under “Scopes” add “chat:write.public” as a new OAuth scope to “Bot Token Scopes”

  3. If this is the first permission you are adding to the app click “Install App to Workspace” at the top of the page

Note down the OAuth token displayed under “Tokens for Your Workspace”.

Creating Your Slack Notifier in Humio

To create your Slack Notifier in Humio go to the notifier creation page and pick Slack.

If you configured Slack with an Incoming Webhook choose Single-Channel Slack Notifier and complete the following steps:

  1. Choose a Name for your notifier

  2. Enter the Webhook Url under Slack Webhook Url

  3. If needed, configure Fields to customize the message that appears in Slack upon notification.

  4. Save your notifier.

If you configured Slack with an OAuth scope choose Multi-Channel Slack Notifier and complete the following steps:

  1. Choose a Name for your notifier

  2. Enter the OAuth token Url under Slack OAuth Token

  3. Choose which channels to message. You can use either the channel ID or channel name (including the #). Separate each channel with a comma.

  4. If needed, configure Fields to customize the message that appears in Slack upon notification.

  5. Save your notifier.