Skip to main content

Slack Notifications

Slack can be used as a notification destination in Causely.
How you configure Slack depends on how notifications are managed in your environment.

Causely supports two configuration paths:

  • Managed Notifications (recommended)
    Routing rules are configured in the Causely UI based on impact, severity, and context.
    Slack is used purely as a delivery destination.

  • Mediator-based Notifications (advanced)
    Notifications are configured programmatically using the Causely Mediator and Causelybot.

Routing and notification rules for Managed Notifications are configured in the Causely UI: Set up notification routing in the UI

Mediator-based Configuration​

To integrate Slack with Causely, you must install the Causelybot and configure it as your Slack webhook endpoint. The bot listens for alerts from the Causely platform and posts them to your desired Slack channels.

  1. Follow the installation instructions for the Causelybot in the official GitHub repository: Causelybot

  2. Once deployed, update your causely-values.yaml file to include the executor and the bot's URL endpoint.

For example, if you deploy the Causelybot in the foo namespace of your cluster, you can configure the webhook endpoint in your causely-values.yaml file like this:

executor:
  enabled: true

notifications:
  webhook:
    url: 'http://<CAUSELYBOT_FQDN/IP>:5000/webhook'
    token: '<YOUR_CAUSELYBOT_TOKEN>'
    enabled: true
note

Make sure the Causelybot is accessible from your Causely deployment and properly configured to post to your Slack workspace and channel. Ensure the Slack channel webhook is set up to accept incoming messages and that the Causelybot has access permissions.

To install the Causely agent with the Slack integration enabled, run:

causely agent install --cluster-name <cluster-name> --values ./causely-values.yaml

Notification Payload Format​

Causely sends structured alert payloads to Slack, including summaries of causal insights and service impact context.
For an example payload and explanation of each field, refer to the Notification Payload Format page.