MS Teams alert method

Reading time: 0 minute(s) (0 words)

The MS Teams alert method sends alerts through MS Teams to notify Nobl9 users whenever an incident is triggered.

Authentication

Action required: MS Teams webhook-based connector update

Microsoft is retiring its Office 365 Connectors service, impacting webhook integrations with MS Teams. To ensure continued functionality, update the URLs for all webhook-based connectors.

The entire Office 365 Connectors service in MS Teams will be retired at the end of 2025. It is recommended migrating your webhooks to the Workflows app within MS Teams.

MS Teams Webhook URLs

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.

Adding the MS Teams alert method

You can add the MS Teams alert method directly in the Nobl9 Web application.

Alternatively, utilize the SLOs-as-code approach by:

• Applying an alert method YAML configuration with the sloctl apply command.
• Configuring the MS Teams alert method definition programmatically using the Nobl9 Terraform provider.

Nobl9 Web

To set up the alert method in the Nobl9 UI, follow these steps:

1. Navigate to Integrations > Alert methods.
2. Click .
3. Select MSTeams.

4. Enter the URL (mandatory).
   This is your MS Teams Workflows URL. To obtain the required URL, configure an incoming webhook using the Microsoft Teams Workflows app.

5. Select a Project (mandatory).
   Projects provide the structure for organizing Nobl9 resources and managing access permissions.
   If a project is not specified, Nobl9 assigns the default project value automatically.
6. Enter a Display Name (optional).
   Spaces are allowed.
7. Enter a Name (mandatory).
   It can only contain lowercase, alphanumeric characters, and dashes (for example, my-alert-method-1). Nobl9 auto-populates this field based on the display name you enter, transforming it into the supported format. You can edit the result.
8. Enter a Description (optional).
   Provide extra details, such as the purpose and responsible personnel.
   Up to 1050 characters.

9. Click Add alert method.

YAML configuration for MS Teams alerts

YAML

General YAML sample for MS Teams alert method

apiVersion: n9/v1alpha
kind: AlertMethod
metadata:
  name: string # Mandatory
  displayName: string # Mandatory
  project: string # Mandatory
  # Optional
  # The key value: only alphanumeric characters, `-`, `_`, or `.` are allowed.
  # The key value must start and end with an alphanumeric character.
  # An optional DNS subdomain prefix followed by `/` is allowed.
  annotations:
    key: value
spec:
  description: string # Mandatory
  msteams:
    url: string # Mandatory, requires https://, secret field

Example

Working YAML sample for MS Teams alert method

apiVersion: n9/v1alpha
kind: AlertMethod
metadata:
  name: teams
  displayName: Teams Alert Method
  project: default
  annotations:
    area: latency
    env: prod
    region: us
    team: sales
spec:
  description: Example Teams Alert Method
  msteams:
    url: https://meshmark.webhook.office.com/webhookb2/123@321/IncomingWebhook/123/321

Field	Type	Description
url	string	The MS Teams Webhook URL. To obtain the required URL, configure an incoming webhook using the Microsoft Teams Workflows app.

Testing the MS Teams 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:

1. Navigate to Integrations > Alert methods.
2. Click the required alert method.
   Its Details page opens.
3. Click Test under the alert method name:
   
   
   • When the configuration is correct, Nobl9 displays Test completed successfully! under the button.
   • Otherwise, the Test failed message appears. It contains the details of incorrect settings.

Useful links

Check out these related guides and references:

MS Teams alert methodTerraform provider