Slack alert
The Slack alert method allows sending a predefined notification through Slack to notify Nobl9 users whenever an incident is triggered.
Authentication
To set up the Slack integration, you’ll need to provide an Incoming Webhook URL. This allows Slack to send an automated notification to a channel of your choice. Refer to steps 2
and 3
of Getting started with Incoming Webhooks | Slack documentation.
You can find instructions how to create an Incoming Webhook URL here.
If you need any further help, contact your Slack administrator.
Known limitations
Currently Nobl9 doesn't return the severity level when a Slack alert is triggered.
Configuring the Slack alert method
You can configure your Slack alert method directly in the Nobl9 UI, or by applying a YAML file in sloctl
.
Nobl9 UI
To set up the alert method in the Nobl9 UI, follow these steps:
- Navigate to Integrations > Alert Methods.
- Click
.
- Click the relevant Alert Method icon.
Then, in the Slack Configuration Wizard:
- Enter the URL.
This is your Incoming Webhook URL. It must start withhttps://hooks.slack.com/
. For more information, refer to the Authentication section.
- Select a Project.
Specifying a project is helpful when multiple users are spread across multiple teams or projects. When the Project field is left blank, Nobl9 uses thedefault
project. - Enter a Display Name.
You can enter a user-friendly name with spaces in this field. - Enter a Name.
The name is mandatory and can only contain lowercase, alphanumeric characters, and dashes (for example,my-alert-method-1
). Nobl9 duplicates the display name here, transforming it into the supported format, but you can edit the result. - Enter a Description.
Here you can add details such as who is responsible for the integration (team/owner) and the purpose of creating it. - Click Add Alert Method
YAML configuration
- YAML
- Example
apiVersion: n9/v1alpha
kind: AlertMethod
metadata:
name: string # Mandatory
displayName: string # Mandatory
spec:
description: string # Mandatory
slack:
url: string # Mandatory, must start with https://hooks.slack.com/
apiVersion: n9/v1alpha
kind: AlertMethod
metadata:
name: slack-notification
displayName: slack notification
spec:
description: Sends notification to a Slack channel
slack:
url: <https://hooks.slack.com/services/1234567890/abcdef>
Testing the Slack alert method in the UI
- Navigate to Integrations > Alert Methods.
- Click the required alert method.
Its Details page opens. - Click Test under the alert method name:
- For the correct configuration, Nobl9 displays Test completed successfully! under the button
- Otherwise, Nobl9 displays the Test failed message, specifying what is set incorrectly