Discord alert
Reading time: 0 minute(s) (0 words)
The Discord alert method sends alerts through Discord to notify Nobl9 users whenever an incident is triggered.
Authenticationβ
To set up the Discord integration, youβll need to provide a Discord Webhook URL. This allows you to send an automated notification to a channel of your choice. For details, see Discord documentation.
Known limitationsβ
Currently, Nobl9 doesn't return the severity level when a Discord alert is triggered.
Configuring the Discord alert methodβ
You can configure your Discord 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 Discord Configuration Wizard:
- Enter the URL.
This is your Discord Webhook URL. 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
Hereβs a general specification for adding a Discord alert method through YAML:
apiVersion: n9/v1alpha
kind: AlertMethod
metadata:
name: string # Name of the Integration
displayName: string # optional
project: default
spec:
description: string # optional
discord:
url: # URL to Discord webhook
Here's an example of Discord configuration through YAML:
apiVersion: n9/v1alpha
kind: AlertMethod
metadata:
name: discord-notification
displayName: Discord notification
spec:
description: Sends message to Discord channel through webhook
discord:
# Nobl9 general Discord channel
url: <https://discord.com/api/webhooks/809803263775211571/D4-5q51DehrBpOAFND6naV8MgCQwmu1vpAwXrO8vPVflFt1bo6J0wMXzvFAttb_2CRjv>
Testing the Discord alert method in the UIβ
You can test alert methods for all notification services supported by the Nobl9 platform through the UI.To verify the correctness of your alert method configuration:
- 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