Skip to main content
ComponentsEngine
Availability2020.2 or later

Integration Overview

Post alerts to channels

Create a Slack App

Bot token and OAuth scopes

Example Slack API Request

Sample message posting call

Recommended Practices

Avoid duplicate high-priority posts

​
Overview

GermainUX alerts can automatically be posted to Slack channels, allowing teams to receive and respond to critical events in real time. Messages can be triggered by:
  • SLA conditions
  • Scheduled executions
  • Other GermainUX automation events

​
Integration Overview

GermainUX integrates with Slack through HTTP Actions and the Slack Web API. When a configured condition occurs, GermainUX calls Slack’s chat.postMessage method to publish a message to the selected channel.
Example of Slack Integration for GermainUX

​
Create a Slack App

If you do not already have a Slack app:
  1. Create an app in your Slack workspace.
  2. Add the required OAuth scopes.
  3. Install or reinstall the app in the workspace.
  4. Copy the generated bot token.
  5. Identify the ID of the destination channel.
    Minimum permissions required by Slack App to post messages to channel
The Slack app requires the chat:write scope to publish messages. Add chat:write.public only if the app must post to public channels of which it is not a member. If the channel ID must be retrieved programmatically, the app may also require channels:read. See Slack’s message-sending guide and chat:write.publicdocumentation.

​
Example Slack API Request

The following request posts a message to a Slack channel:
Store the Slack bot token in a secure GermainUX credential configuration. Do not include a production token directly in the HTTP Action.

​
Automatically Post GermainUX Alerts to Slack

Go to GermainUX Workspace —> Left Menu —> Settings → Automation -> HTTP. This screen displays the available HTTP Actions and identifies those associated with SLAs. Select an existing action to edit it, or click + to open the HTTP Action wizard.

​
1 Step 1: Configure the Action

Enter: Click Next.
First page of creation wizard of a new HTTP Action showing the required fields

​
2 Step 2: Configure the HTTP Request

Use the following request body:
A successful Slack API response contains "ok": true. Because Slack can return an HTTP success status with "ok": false in the response body, validate the ok property whenever the GermainUX HTTP Action configuration supports response-content validation. See the chat.postMessageAPI documentation.
Second page of creation wizard of a new HTTP Action showing the required fields

​
3 Step 3: Select the Trigger

Select the CPU Usage SLA that should trigger the Slack message. When the SLA is breached, GermainUX will post the configured message to the selected Slack channel. Click Finish to save the configuration.
  • Use a dedicated Slack app with only the required OAuth scopes.
  • Store the bot token securely and never expose it in documentation or logs.
  • Use a channel ID rather than a channel name.
  • Apply an execution limit or quiet period to avoid duplicate messages.
  • Include the affected system, KPI, current value, threshold, and Analysis Dashboard link.
  • Test the integration in a dedicated Slack channel before enabling it in production.

​
Get Help

Contact GermainUX Support

The Germain Team can help you set this up.

Can't find what you need?

Search all GermainUX docs with Ctrl + K, or use the feedback buttons at the bottom of this page to tell us what is missing.

The content of this document is proprietary to GERMAIN SOFTWARE LLC.