EV Observe - Configure the Teams Notification Channel

Last modified on 2023/03/16 13:39

Notifications can be sent to a Teams team when there are changes to the statuses of configuration items (CIs) (host, services, user services). All users belonging to the Teams team will automatically receive a warning in real time.

  • You can configure notifications based on the criticality of the change to the status or warning.
  • You can define a time slot for the notifications.

Notes

  • 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.

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 each type of configuration item (CI).
  • Select the statuses whose notifications you want to receive for each type of CI.
    Contextual information to the selected status will appear.
  • Select the time slot 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 configuration item (CI)

1. Open the form of the CI you want to configure.

  • Host: Configuration > Hosts > List menu
  • Service: Configuration > Services > List menu
  • User service: Configuration > User services menu

2. Select the Notifications tab.

         Create new service - Notifications tab.png

3. Specify the information below.

  • Click Yes to enable notifications.
    Notification properties will appear for each CI.

          Open url.png See the tab description for each type of CI:

         Open url.png See also:

  • Select the statuses whose notifications you want to receive.
  • Select the time slot 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 (that you created in step 2) in the Level 1 contact(s) and contact group(s) section.

4. Click Validate.

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

         Element notification example.png

5. Repeat the procedure for each CI whose notifications you want to receive in Teams.

Tags:
Powered by XWiki © EasyVista 2024