AzureAppForMicrosoftTeams/Documentation.md

---
title: Azure with Microsoft Teams
description: Monitor your application and infrastructure on Azure from Microsoft Teams
ms.date: 02/14/2020
---

# Azure with Microsoft Teams
If you use Microsoft Teams, you can use the Azure app for Microsoft Teams to easily monitor your application and infrastructure on Azure. Link action groups of your choice with a channel and get notified on the alerts.


## Prerequisites
Being a private preview, Azure app has certain limitations as detailed below. We will continue to invest in the app to remove some of these constraints.

> [!NOTE]
> * The app posts notifications for metric alerts. Support for 'activity log' and 'log alerts' will added soon.
> * Alerts with multiple conditions or a single metric alert with multiple dimensions are not supported.
> * Need to add a point on user id in ADO. WIll have to frame accordingly. 


## Add the Azure app to your team
Download the manifest file from [here](https://google.com) and upload it as a custom app and install it to the team of your choice. 
> ![Add as custom app](./teams/add-as-custom-app.PNG)

Upon installing, a welcome message is displayed as shown in the following image. Use the @azure handle to start interacting with the app.
> ![welcome message](./teams/welcome-message.PNG)


## Link the Azure app to action groups 

1. Once the app is installed in your team, authenticate yourself to Azure app using the @azure signin command.

> ![sigin button](./teams/signin-button.PNG)
> ![sigin consent](./teams/signin-consent.PNG)
> ![sigin success](./teams/signin-success.PNG)

2. To view, link and unlink actions groups for a channel, use the following command:

  ```
   @azure actionGroups
  ```
  The `action groups` command lists all the action groups linked to the channel. It also helps users to link and unlink action groups.

> ![action groups command](./teams/actions-groups-command.PNG)

3. Click on 'Link an action group' button. Select a subscription and the action group that you want to link to the channel.

> ![link action group](./teams/link-action-group.PNG)

  To link an action group to a channel, one must be part of Azure Monitor Contributor group. When an action group is linked to a channel a webhook action will be created with the name Azure_Microsoft_Teams_<Time_stamp> for the linked action group. 

## Unlink an action group
Run `actionGroups` command. Click on 'View all action groups' button and select the action group that you want to unlink.

> ![view-all-action-groups](./teams/view-all-action-groups.PNG)

To unlink an action group, one must be part of Azure Monitor Contributor group. 

## Receiving notifications
Once an action group is linked to a channel, all alerts sent to this action group will be directed to the channel in the form of notifications.

> ![metric notification](./teams/metric notification.PNG)

For metric alerts, if the user who linked the action group has access to the resource group for which the alert was sent, a graph would be rendered.

## Future work
We’re constantly at work to improve the app, and soon you’ll see new features stated below

> * Support for activity and log alerts
> * Ability to acknowledge and close an alert from the channel (change alert state)
> * Ability to get pipeline deployment data (for virtual machines only)
> * Threading of notifications

## Troubleshooting

1) For metric alerts, the cards are not enriched with time charts
Possible cause: The user who linked the action group does not have access to the resource for which the alert was fired.