MS Teams
The MS Teams Alert Method enables sending alerts through MS Teams to notify Nobl9 users whenever an incident is triggered.
Authenticationβ
To set up the MS Teams integration, youβll need to provide an MS Teams Webhook URL. This allows you to send an automated notification to a channel of your choice. For details, see MS Teams documentation.
Configuring the MS Teams Alert Methodβ
You can configure your MS Teams 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:
Go to Integrations > Alert Methods.
Click the
button.
Select MS Teams.
Enter the URL (mandatory).
Select a Project (mandatory).
Specifying a Project is helpful when multiple users are spread across different teams or projects. When the Project field is left blank, a default value appears.Enter a Display name (optional).
You can enter a friendly name with spaces in this field.Enter a Name (mandatory).
The name is mandatory and can only contain lowercase, alphanumeric characters and dashes (for example,my-alertmethod-name
). This field is populated automatically when you enter a display name, but you can edit the result.Enter a Description (optional).
Here you can add details such as who is responsible for the integration (team/owner) and the purpose of creating it.Click the Add Alert Method button.
YAML Configuration for MS Teams Alertsβ
- YAML
- Example
Hereβs a general specification for adding an MS Teams Alert Method through YAML:
apiVersion: n9/v1alpha
kind: AlertMethod
metadata:
name: # string
displayName: # string
project: # string
spec:
description: # string
msteams:
url: # string, requires https://, secret field
Here's an example of MS Teams configuration through YAML:
apiVersion: n9/v1alpha
kind: AlertMethod
metadata:
name: teams-notification
displayName: MSTeams notification
project: default
spec:
description: Send message to MS Teams channel
msteams:
url: <https://webhook.office.com/webhookb2/12345>
The only field that is specific to MS Teams is url
. This field is kept secret and will be replaced with the [hidden]
string when returned from sloctl
. The https://
prefix is required.
Testing the MS Teams Alert Method in the UIβ
Users can test their Alert Methods for all notification services supported by the Nobl9 platform through the UI.
To verify that your MS Teams Alert Method is set up correctly at the time that you configure it:
Go to Integrations > Alert Methods.
Follow the process outlined above to add the Alert Method in the Nobl9 UI: complete the steps in the Create Alert Method wizard, and click the Add Alert Method button.
On the Details screen, click the Test button in the upper-right corner. If the configuration is correct, Nobl9 will display the following message next to the button:
Test completed successfully!
note
If the configuration is incorrect, Nobl9 will provide an error message with relevant details. The content of the error differs depending on the Alert Method channel.
You can also test an existing Alert Method. To do that:
Go to Integrations > Alert Methods.
Find the Alert Method you want to test in the list, and click it.
On the Details screen, click the Test button in the upper-right corner.