EV Observe - Configure the Teams Notification Channel

Last modified on 2022/08/11 19:15

Notifications can be sent to a Teams team when there are changes to the statuses of hosts, services and user services. All users belonging to the Teams team will automatically receive a warning in real time.

  • You must create a notification channel associated with an incoming webhook in Teams. EV Observe and Teams share information using the URL of the webhook.
  • Notifications will automatically be triggered when there is a change in a component's status.
  • You can configure them in EV Observe based on the criticality of the component or warning. You can define a time period for the notifications.

Notes

Procedure: How to configure the Teams notification channel

Step 1: Configure a custom incoming webhook in Teams 

1. Create an incoming webhook in Teams.

  • Go to Microsoft Teams.
  • Open the team that will receive the notifications.
  • Click Browse grey points icon.png in the top navigation bar and select the Connectors option.
            Webhook URL - Creation.png
  • Select the connector called Incoming Webhook.
  • Click Add.

2. Configure the new webhook.

  • Click Configure next to the webhook.
            Webhook URL - Configuration.png
  • Enter the name of the new webhook.
  • Upload an image you want to associate with the webhook data.
  • Click Create.
  • The webhook URL will automatically be generated.
  • You can now use it to send notifications to Teams.

3. Copy the webhook URL and paste it in your text editor in order to store it temporarily. It will be required when defining the configuration in EV Observe in step 2.

          Webhook URL - Copy.png

4. Click Done.

5. Run the commands below to check that the webhook works correctly using a curl command.

Replace <webhook_url> with the webhook URL you copied and stored in your text editor.

  • Mac OS or Linux

curl -H 'Content-Type: application/json' -d '{"text": "Hello World"}' <webhook_url>

  • Windows

curl.exe -H "Content-Type:application/json" -d "{'text':'Hello World'}" <webhook_url>

  • If the result displayed by curl is 1, this means that the publication was successful.
  • The Hello World message will appear in Teams for the team associated with the webhook.

          Webhook URL - Message in Teams.png

Step 2: Configure a contact for Teams notifications in EV Observe

1. Go to the Web app.

2. Add a contact.

  • Select Configuration > General > Contacts in the menu.
  • Click + Add.
           Contact configuration.png

3. Specify the information below.

  • Teams Webhook URL: Paste the webhook URL you copied and stored in your text editor in step 1.
  • Click Yes to enable the contact.
    Notification properties will appear for user services, hosts and services.
  • Select the statuses whose notifications you want to receive for each component.
  • Select the period for which you want to receive notifications. Note: Only for services and hosts.
  • Select Teams in the Notify with field.

4. Click Validate.
 

Step 3: Configure Teams notifications to be sent for each component

1. Open the form of the component.

  • Hosts: select Configuration > Hosts > List in the menu
  • Services: select Configuration > Services > List in the menu
  • User services: select Configuration > User services > List in the menu

2. Select the component you want to configure.

3. Select the Notifications tab.

         Create new service - Notifications tab.png

4. Specify the information below.

  • Click Yes to enable notifications.
    Notification properties will appear for each component.
  • Select the statuses whose notifications you want to receive.
  • Select the period for which you want to receive notifications. Note: Only for services and hosts.
  • Select Teams in the Notify with field.
  • Select the Teams notification contact you created in step 2 in the Level 1 contact(s) and contact group(s) section.

5. Click Validate.

The next time the status of the component changes, notifications will automatically be sent to the Teams team associated with the Teams notification contact for the specified period.

         Element notification example.png

6. Repeat the procedure for each component whose notifications you want to receive in Teams.

Tags:
Powered by XWiki © EasyVista 2022