Microsoft Teams Integration Setup

You can configure the Microsoft Teams Integration settings in your LogicMonitor portal to set up a Microsoft Teams integration. Configuring the settings creates one instance of a Microsoft Teams integration in your LogicMonitor portal, and each instance integrates with one Microsoft Teams channel. You can configure as many instances as your environment needs.

The Microsoft Teams integration leverages webhooks to route alerts. Setting up the integration involves adding webhook information in your LogicMonitor portal to do the following:

  • Establish communication—Establishing communication between LogicMonitor and a Microsoft Teams channel is accomplished using webhooks that you create in your Microsoft Teams channels. These webhooks contain information that you enter into the Microsoft Teams Integration settings in your LogicMonitor portal to establish the communication between LogicMonitor and Microsoft Teams.
  • Manage alerts—You can enable a Team to manage alerts between LogicMonitor and a Microsoft Teams channel. You can use the following to acknowledge (ACK) or put alerts in scheduled downtime (SDT) directly in a Microsoft Teams channel:
    • ACK – @outogoing-webhook-name ack [alertId] [ackComment-optional]
      • @webhookname LMA12345 OptionalComment 
    • SDT – @outogoing-webhook sdt [alertId] [sdtType] [sdtDuration] [sdtCcomment-optional]
      • @webhookname sdt LMA12345 device 30 minutes comment-Optional

You can enable as many Teams to manage alerts as your environment needs.

After an integration is set up, you can use the Microsoft Teams Integration settings to test the alert delivery between LogicMonitor and your Microsoft Teams channel.

You can also use the Microsoft Teams Integration settings to prevent Teams from managing alerts in a Channel. For example, you may configure the integration to enable more than one Team to manage alerts. If your environment changes and you need to prevent a Team from managing alerts, you can modify the integration settings to remove that Team. In addition, you can prevent all Teams in your environment from managing alerts using a single setting.

Note: To acknowledge alerts from within Microsoft Teams, you must be logged in to your LogicMonitor portal.

Requirements for Integrating with Microsoft Teams

To set up the Microsoft Teams Integration, you must create the following in Microsoft Teams:

  • An Incoming Webhook
    Creating an Incoming Webhook generates an Incoming Webhook URL used to establish communication between LogicMonitor and a Microsoft Teams channel. For more information, see Microsoft’s Create an Incoming Webhook documentation.
  • An Outgoing Webhook
    Creating an Outgoing Webhook generates an Outgoing Webhook Token (also called a Hash-based Authentication Code (HMAC) security token) used to manage LogicMonitor alerts for a single Microsoft Teams channel. For more information, see Microsoft’s Create Outgoing Webhook documentation.

Important: When creating the Outgoing Webhook in Microsoft Teams, you must use the following for the Callback URL:
https://integrationcenter.integrations.logicmonitor.com/rest/msTeams/outgoingWebhook

To enable or prevent a Team from managing alerts, you need a link to your Team. For more information, see Microsoft’s Create a link or a code for joining a team documentation. To prevent all Teams from managing alerts, you need the Tenant ID. You can obtain this from the Team link.

Setting up the Microsoft Teams Integration in LogicMonitor

  1. In LogicMonitor, navigate to Settings > Integrations.
  2. Click Add.
  3. From the Start New Integration pane, click Microsoft Teams.
  1. Enter a name and description for the Microsoft Teams integration.
  2. Enter the Incoming Webhook URL you created in Microsoft Teams in the Incoming Webhook URL field.

Important: Ensure you select “https://” from the drop-down menu and remove “https://” when entering the Webhook URL in the Incoming Webhook URL field.

  1. Enable the Alert Statuses you want routed to your Microsoft Teams channel.
    Receipt of new alerts is enabled by default, but updates on the current alert status are optional (Acknowledged, Cleared, Escalated/De-escalated).
  2. To enable a Team to manage alerts from a Microsoft Teams channel, do the following:
    1. Click the disclosure triangle next to Add Outgoing Webhook Token.
    2. In the Outgoing Webhook URL field, enter the link to the Microsoft Team you want to manage alerts from.
    3. In the Outgoing Webhook Token field, enter the HMAC security token you generated when creating the Outgoing Webhook in Microsoft Teams.
    4. Click Save Token.

Note: Clicking Save Token stores the information, and then removes it from the settings. You can add as many Outgoing Webhook Tokens as your environment needs.

  1. Click Save.

Testing the Microsoft Teams Alert Delivery

  1. In LogicMonitor, navigate to Settings > Integrations.
  2. Select Manage for the Microsoft Teams integration you want to test Alert Delivery for.
  3. Click Test Alert Delivery.

A dialog displays indicating whether the alert was successfully posted to your Microsoft Teams channel.

Preventing a Team from Managing Alerts

  1. In your LogicMonitor portal, navigate to Settings > Integrations.
  2. Select Manage for the Microsoft Teams integration you want to remove an Outgoing Webhook from.
  3. Do one of the following:
    • To prevent a single Team from managing alerts, click the disclosure triangle next to Remove Outgoing Webhook Token and do the following:
      • a. Enter the URL for the Outgoing Webhook in the Outgoing Webhook Team URL field.
      • b. Click Delete Token.

        Important: Ensure you select “https://” from the drop-down menu and remove “https://” when entering the Webhook URL in the Outgoing Webhook Team URL field.

    • To prevent all Teams from managing alerts, click the disclosure triangle next to Remove Outgoing Webhook Tokens and do the following:
      • a. Enter the tenant ID in the Tenant ID field.
      • b. Click Delete Token(s).

  4. Click Save.
In This Article