MS Teams Integration

Streamline alerts management with MS Teams integration

By integrating Teams, the process of managing Alerts in clusters becomes more efficient. This feature enables users to promptly receive notifications on the designated Teams channel whenever alerts are produced.

MS Teams profile

Configuring Teams integration with the profile

🛠️ How to create Teams Profile

There are two options for creating a Profile: from the Settings tab or directly from the Overview.

From the Settings tab

Go to the Settings tab on the left panel -> select Integrations -> click the +Add Integration button and select Teams from the drop-down -> insert teams_webhook -> click Save button.

MS Teams profile from settings

From the Overview tab

Go to the Overview tab on the left panel -> find the cluster to which you want to apply the Profile and click gear button -> go to Customizations -> find Integrations and click the Communication & Messaging drop-down list -> click the Add New Profile button and select Teams -> insert teams_webhook -> click Save And Apply button.

MS Teams profile from overview

🛠️ How to apply Teams Profile

Apply to a single cluster

To apply Teams Profile to the cluster, go to the Overview tab on the left panel -> find the cluster to which you want to apply the Teams Profile and click gear button -> go to Customizations -> select the needed profile in the Communication & Messaging drop-down list.

Applying MS Teams profile to a single cluster

Apply to multiple clusters

To apply the profile to multiple clusters from a single view, use the Manage Assignments feature.

Go to the Settings tab on the left panel -> select the Integrations -> click the Manage Assignments button -> go to Communication & Messaging section and apply the profiles for the needed clusters -> click the Save Changes button.

Applying MS Teams profile to multiple clusters

Configuring Teams integration with CRD

To enable Teams alerts using a Custom Resource Definition (CRD), you’ll need to define and apply a Custom Resource (CR) with the required parameters. This approach allows you to manage Teams alerting directly through Kubernetes manifests.

The Custom Resource (CR) must be created in the perfectscale namespace.

Setup instructions

1. Go to the Apps at https://teams.microsoft.com/.

2. Go to Incoming Webhook and click Add to connect your Webhook to a specific channel.

3. Provide the channel name where you want PerfectScale alerts to be received.

4. Name your webhook and click the Create button.

5. Copy the webhook URL (you will need it for the Teams webhook secret in the next steps).

Apply the Teams webhook secret first:

apiVersion: v1
kind: Secret
metadata:
  name: teams-credentials
  namespace: perfectscale
type: Opaque
stringData:
  webhook-url: "https://outlook.office.com/webhook/your-webhook-url-here"

Ensure that the secret is created in the same namespace as the exporter - perfectscale.

Configure the CR:

apiVersion: perfectscale.io/v1
kind: ClusterSettings
metadata:
  name: cluster-settings-main
  namespace: perfectscale
spec:
  profiles:
    integrations:
      - type: teams
        name: ops-team-notifications
        assigned: true
        value:
          teams_webhook_from:
            secretKeyRef:
              name: teams-credentials
              key: webhook-url

⚙️ CR parameters:

Parameter	Description
teams_webhook_from	A secret that permits PerfectScale to interact with your Teams. Learn how to configure teams_webhook here.

Teams Integration Verification

To verify the accuracy of your MS Teams configuration, simply click on the Test Integration button. When the configuration is correct, you will see the message Teams Configured Correctly. In case of Teams Configured Wrongly response, check and ensure that the teams_webhook URL is correct.

MS Teams integrations verification