Setting Up Alert Manager for Microsoft Teams in Rancher For Automation Suite

News Knowledge Base
,
1

How to set up the Alert Manager for Microsoft Teams in Rancher?

Description of Issue:

Users utilizing Rancher for managing Kubernetes clusters are seeking to set up an Alert Manager to route alerts to Microsoft Teams. They need comprehensive guidance to configure the Alert Manager effectively to ensure smooth and efficient alert routing to Microsoft Teams, allowing for timely responses to any issues that may arise.

Prerequisites:

  1. Microsoft Teams Channel - Ensure that you have a Microsoft Teams channel where alerts will be posted.
  2. Rancher Installation - Ensure that Rancher is installed and configured correctly.
  3. Alertmanager Configuration - Ensure that Alertmanager is properly configured within your Rancher instance.

Steps:

  1. Join or Create a Team
image.png
  1. Add a channel
image.png
  1. Add a connector
  1. Create an Incoming Webhook in Microsoft Teams:
  1. Perform the below
    1. Go to the channel where the alerts need to be received
  1. Click on the three dots (…) > Connectors > Incoming Webhook > Configure.
  1. Name your webhook and upload an image if desired, then click "Create."
  2. Copy the provided URL; you'll need it for Alertmanager configuration.

Clone the 'prom2teams' Repository

  1. git clone https://github.com/idealista/prom2teams.git


Navigate to the Helm Chart Directory:

  1. cd prom2teams/helm/prom2teams/


Modify the values.yaml file:

  1. Open the values.yaml file in your preferred text editor.
  2. Locate the connector section and replace the placeholder URL with the actual webhook connector URL copied from Microsoft Teams.

  1. Configure Alertmanager in Rancher:
    1. Log in to your Rancher UI.
    2. Navigate to the cluster that you want to configure the Alertmanager for.
    3. Save and close the file after modification.


Install the Helm Chart using the Local Directory Path:

While in the helm/prom2teams directory, run the following command to install the Helm chart:

helm install prom2teams . -n --create-namespace

Verify that the Helm release is installed:

  1. helm list -n cattle-monitoring-system
  2. Go to “Tools” > “Alerting,” and enable alerting if it is not already enabled
  3. Under the Alertmanager tab, click "Add Receiver."
  4. Name your receiver, for example, “ms-teams,” and select “webhook” as the type
image.png
  1. Paste the webhook URL you copied from Microsoft Teams into the “URL” field.
image.png
image.png
  1. Create Alert Rules:
    1. In Rancher, navigate to “Tools” > “Alerting.”
    2. Under the "Cluster Alert Groups" tab, you can either edit an existing group to add a new rule or create a new alert group.
    3. When creating or editing an alert rule, select “ms-teams” as the receiver.
  2. Test the Configuration:
    1. After setting up, create a test alert to verify that alerts are being posted to the designated Microsoft Teams channel.
    2. Observe the Microsoft Teams channel for the alert; it should arrive promptly.