Create a Slack notifier - Chronosphere Documentation

To create a Slack notifier, set up Slack and then create the notifier in Chronosphere Observability Platform.

Set up Slack

Before creating a Slack notifier in Observability Platform, create an incoming webhook in Slack. See Sending messages using incoming webhooks in the Slack documentation for more information. Next, create a Slack notifier in Observability Platform.

Create a Slack notifier in Observability Platform

After setting up Slack, you can create a Slack notifier in Observability Platform. Select from the following methods to create a Slack notifier. You can use variables in your notifiers.

Web
Chronoctl
Terraform
API

To create a Slack notifier:

In the navigation menu select Alerting > Notifiers.
Click Create notifier.
Enter a descriptive name for the notifier.
Select Slack as the type of notifier you want to create.
In the API URL field, enter the URL you created for your webhook in Slack, which is called as a POST request. For example:
```
https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXX
```
The API URL from Slack contains the channel name.
The Channel field is deprecated and doesn’t affect the notifier. A channel name is still required in this field until the field is fully removed.
Optional: In the Username field, enter the Slack username to post the notifier as.
Optional: Select Notify when resolved to send a resolved alert notification.
Click Save.

To create one or more notifiers using Chronoctl, create a YAML file that defines them and apply the configuration to your instance.

You can use the notifiers scaffold command to generate an example notifier, and then copy the resource definition for your notifier type:

chronoctl notifiers scaffold

Define the resource definition for your Slack notifier:

api_version: v1/config
kind: Notifier
spec:
  name: NAME
  slug: SLUG
  skip_resolved: true
  slack:
    - actions: null
      api_url: https://hooks.slack.com/services/
      channel: CHANNEL
      fields: null
      mrkdwn_in: null
      username: USERNAME

Replace the following:

NAME: A descriptive name, such as test-slack.
SLUG: A unique identifier, such as team-slack.
CHANNEL: Deprecated. The Slack channel to send notifications to.
USERNAME: Send the notification message from a specified Slack username.

Enter the URL you created for your webhook in Slack as the value for the api_url field. The API URL contains the channel to send the message to.
Optional: Enter the Slack username to post the notifier as in the username field.
Apply the changes:
```
chronoctl apply -f FILE_NAME.yaml
```
Replace FILE_NAME with the name of your notifier YAML file.

To create a Slack notifier:

Create a Slack notifier with Terraform by using the chronosphere_slack_alert_notifier type followed by a name in a resource declaration:

resource "chronosphere_slack_alert_notifier" "slack_notifier" {
  name = "Slack Notifier"

  # Optional slug of the slack notifier.
  slug = "slack-notifier"

  ## Notifier-specific required configuration.
  # For detailed definitions, see
  # https://prometheus.io/docs/alerting/latest/configuration/#slack_config
  # `api_url` is a sensitive value. Treat it like a secret.
  api_url       = "https://hooks.slack.com/services/XXXXX/XXXXX/XXXXX"
  channel       = "alerts"

  ## Notifier-specific optional configurations
  username      = "alertbot"
  callback_id   = "my_callback_id"
  color         = "red"
  fallback      = "my_fallback"
  footer        = "my_footer"
  icon_emoji    = ""
  image_url     = "https://example.com/images/img.png"
  link_names    = false
  mrkdwn_in     = []
  pretext       = "my_pretext"
  short_fields  = false
  text          = "my_text"
  title         = "my_title"
  title_link    = "my_title_link"

  # Can have multiple fields.
  fields {
    title = "my_title"
    value = "my_value"
    short = true
  }

  # Optional list of actions
  action {
    name                        = "my_action"
    style                       = "my_style"
    text                        = "my_text"
    type                        = "my_type"
    url                         = "my_url"
    value                       = "my_value"
    action_confirm_text         = "confirmation text"
    action_confirm_tile         = "confirmation title"
    action_confirm_ok_text      = "confirmation ok text"
    action_confirm_dismiss_text = "dismissal text"
  }

  ## (Optional) Base configuration common to all notifiers
  send_resolved = true # The default value

  ## (Optional) HTTP configuration common to HTTP notifiers
  basic_auth_username = "username"
  basic_auth_password = "strong+p@ssword"
  # Can use bearer_token instead of basic auth
  tls_insecure_skip_verify = false
}

Enter the URL you created for your webhook in Slack as the value for the api_url field. The API URL contains the channel to send the message to. The channel field is deprecated.
Optional: Enter the Slack username to post the notifier as in the username field.
Run terraform apply to create the notifier resource.
```
terraform apply
```

To complete this action with the Chronosphere API, use the slack object in the CreateNotifier endpoint.Because the Chronosphere API requires authentication, include an API token with your curl request, as shown in the following example. For more details, see Create an API token.

export CHRONOSPHERE_API_TOKEN="TOKEN"
export CHRONOSPHERE_DOMAIN="INSTANCE.chronosphere.io"

curl -H "API-Token: ${CHRONOSPHERE_API_TOKEN}" \
     -X METHOD "https://${CHRONOSPHERE_DOMAIN}/ENDPOINT_PATH"

Replace the following:

TOKEN: Your API token.
INSTANCE: The subdomain name for your organization’s Observability Platform instance.
METHOD: The HTTP method to use with the request, such as GET or POST.
ENDPOINT_PATH: The specific endpoint you want to access.

​Set up Slack

​Create a Slack notifier in Observability Platform

Set up Slack

Create a Slack notifier in Observability Platform