Mattermost

To open this page in the left panel, click ‘Tenant configuration’ → ‘Notification Channels’ → ‘Mattermost’.

The ‘Mattermost’ page displays a list of channels for sending messages and tools for creating and managing channels:

  1. The ‘Add Channel’ button opens a window to add a new channel.

  2. Channel information:

    • channel ID;

    • channel name;

    • webhook URL;

    • state: active or disabled.

  3. The ‘Menu’ button allows you to manage the selected channel. Three options are available in the menu:

    • ‘Open’ — opens the page of the selected channel;

    • ‘Activate/Suspend’ — resumes/suspends the use of the selected channel for message transmission;

    • ‘Delete’ — deletes the selected channel.

Preliminary actions

Before setting up the integration, you need to configure the webhook in Mattermost. To do this, follow these steps:

  1. In Mattermost, go to System Console → Integrations → Manage Integration. The value of the ‘Allow Incoming Webhook’ option shall be ‘yes’. If you do not have access to the system console, please contact your administrator.

  2. Go to the settings of the Mattermost channel where you plan to receive notifications and set up the incoming webhook.

    • In the menu, select the “Integrations” → “Incoming Webhooks” section, and click “Add Incoming Webhook”.

    • Fill in the fields and save the changes.

    • Copy the URL of the incoming webhook.

A detailed guide is available in the Mattermost documentation.

Adding a channel

To add a new channel:

  1. Click “Add Channel”.

  2. Type in webhook URL.

  3. Type in channel name. The name cannot exceed 64 characters.

  4. Click “Add Channel”.

Channel activation

To activate the channel:

  1. In the channel menu, select “Activate.”

  2. Type “activate” in the text field of the modal window.

  3. Click “Activate”.

Channel deactivation

To suspend the channel and disable corresponding notifications:

  1. In the channel menu, select “Suspend.”

  2. Type “suspend” in the text field of the modal window.

  3. Click “Suspend”.

Deleting the channel

To delete the channel:

  1. In the channel menu, select “Delete.”

  2. Type “delete” in the text field of the modal window.

  3. Click “$1”.

Manage channel

To go to the Mattermost channel management page, click on the required channel in the list or click the menu button → “Open.”

This page displays information on the channel and added rules.

You can manage the channel using the menu.

The channel menu contains the following options:

  • ‘Activate/Suspend’ — resumes/suspends the use of the selected channel for message transmission;

  • “Test connection” — sends a test message to the specified channel. After sending, a state window will appear:

  • “Add rule” — allows you to add a rule for sending messages to the channel.

Adding a rule

To add a new rule for sending messages:

  1. Select a namespace.

  2. Select the severity level: problem or warning.

  3. Click “Add Rule”. After adding the rule, you will receive corresponding notifications in the selected Mattermost channel.

Removing a rule

To remove the rule for sending messages through the channel:

  1. Type “delete” in the text field of the modal window.

  2. Click the ‘Delete’ button.