teams-health-feature-monitoring

所属分类:中间件编程
开发工具:Others
文件大小:0KB
下载次数:0
上传日期:2022-06-04 21:04:48
上 传 者sh-1993
说明:  Microsoft团队发布和到SharePoint列表时的服务问题和消息中心通知。,
(Microsoft Teams service issues and Message Center notifications as Teams posts and to SharePoint lists.,)

文件列表:
LICENSE.md (1067, 2022-06-04)
Power_Automate/ (0, 2022-06-04)
Power_Automate/MicrosoftTeamsHealthandFeatureMonitoringv2.1.zip (7511, 2022-06-04)
SP_Lists_Template/ (0, 2022-06-04)
SP_Lists_Template/SP_Lists_Template_TeamsHealthandFeatureMon_v2.xml (15154, 2022-06-04)

# teams-health-feature-monitoring | [About The Project](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/#about-the-project) | [Usage](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/#usage) | [Prerequisites](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/#prerequisites) | [Installation](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/#installation) | ---- | ---- | ---- | ---- | Microsoft Teams Service Issues and Message Center Notifications as Teams posts and stored to SharePoint lists. All you need is one Power Automate (incl. SharePoint site and Teams channel) to stay informed. :mega: **Note for V1 users:** If you already using the previous version of this solution (deprecated Service Communications API), then please follow the steps in the guide to update your existing version to the new version. :zap: In Short: The SharePoint List requires new columns and the app registration require new permissions. **Whats new in V2**:question: - Power Automate uses now the new Graph API ([serviceAnnouncement](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/https://docs.microsoft.com/en-us/graph/api/resources/serviceannouncement?view=graph-rest-1.0)) - Message Center and Service issues Teams posts will now included the full message (HTML-based incl. links and images) - All Message Center notifications will be posted to Microsoft Teams. - No additional image location required (OneDrive for Business) ## Table of Contents - [teams-health-feature-monitoring](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/#teams-health-feature-monitoring) - [Table of Contents](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/#table-of-contents) - [About The Project](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/#about-the-project) - [Built With](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/#built-with) - [Getting Started](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/#getting-started) - [Prerequisites](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/#prerequisites) - [Installation](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/#installation) - [1. Clone the repo or download the files directly](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/#1-clone-the-repo-or-download-the-files-directly) - [1. Create an App Registration in Azure AD](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/#1-create-an-app-registration-in-azure-ad) - [2. Create a SharePoint site](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/#2-create-a-sharepoint-site) - [3. Import the SharePoint lists](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/#3-import-the-sharepoint-lists) - [4. Import the Power Automate flow](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/#4-import-the-power-automate-flow) - [5. Adjust the values in the Power Automate](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/#5-adjust-the-values-in-the-power-automate) - [Usage](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/#usage) - [Other Workloads](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/#other-workloads) - [Follow-ups (Tasks)](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/#follow-ups-tasks) - [Roadmap](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/#roadmap) - [Contributing](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/#contributing) - [License](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/#license) - [Contact](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/#contact) ## About The Project The project includes **one** simple Power Automate solution to stay informed about the Microsoft Teams Service issues and upcoming changes to the service that may require administrator or end-user attention. :rocket: ![Intro](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/https://www.tnext-labs.com/GitHub/teams_health_feature_monitoring/intro_new.png) The Power Automate will fetch every **20 Minutes** the latest updates from the Office 365 Service Health Status and the Message Center using the Graph API and post them to Teams (if required) and store the information to SharePoint lists. :bangbang: **TIP:** *The solution is designed for Microsoft Teams but can also be used for all other Office 365 services by simply changing the filters inside the flow.* ### Built With * [Power Automate](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/https://us.flow.microsoft.com/) * SharePoint Online Lists * Graph API ([serviceAnnouncement](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/https://docs.microsoft.com/en-us/graph/api/resources/serviceannouncement?view=graph-rest-1.0)) ## Getting Started To get a local copy up and running follow these simple steps. ### Prerequisites The solution require an Office 365 subscription including the following: - Microsoft Teams license - Power Automate license (Premium Connector) - SharePoint license - PnP PowerShell Module (SharePoint Online) - Access to Azure AD to create App Registration ### Installation #### 1. Clone the repo or download the files directly Clone the repo: ```sh git clone https://github.com/tobiheim/teams-health-feature-monitoring.git ``` #### 1. Create an App Registration in Azure AD First open the Azure AD Portal (https://aad.portal.azure.com) and select **App registrations**. ![Create App Registration](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/https://www.tnext-labs.com/GitHub/teams_health_feature_monitoring/azure_portal.png) Create a new registration: ![Create App Registration](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/https://www.tnext-labs.com/GitHub/teams_health_feature_monitoring/ar1.png) Provide a name to your new app and select the supported account type as shown in the screenshot below. Now you can register the app. ![Name and register App Registration](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/https://www.tnext-labs.com/GitHub/teams_health_feature_monitoring/ar2.png) Also copy the **Application ID** and the **Tenant ID** from the overview section. ![Copy app id and tenant id](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/https://www.tnext-labs.com/GitHub/teams_health_feature_monitoring/ar11.png) Next you need to add permissions to your app registration. ![View permissions](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/https://www.tnext-labs.com/GitHub/teams_health_feature_monitoring/ar3.png) Select **Add a permission** ![Add permissions](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/https://www.tnext-labs.com/GitHub/teams_health_feature_monitoring/ar4.png) Select **Graph API** ![Select Mgmt API](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/https://www.tnext-labs.com/GitHub/teams_health_feature_monitoring/ar5_new.png) Next select **Application permissions** ![Select app permissions](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/https://www.tnext-labs.com/GitHub/teams_health_feature_monitoring/ar6.png) Select the permissions listed in the screenshot below: ![Select the required permissions](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/https://www.tnext-labs.com/GitHub/teams_health_feature_monitoring/ar7_new.png) After selecting the permissions, click **Add permission**. Don't forget to grant admin consent for your organization. ![Grant admin permissions](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/https://www.tnext-labs.com/GitHub/teams_health_feature_monitoring/ar8_new.png) As last step you need to create a client secret for your app. **Note:** It is up to you what name and expiration time you select based on your requirements. ![Create client sec](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/https://www.tnext-labs.com/GitHub/teams_health_feature_monitoring/ar9.png) Make sure to copy the client secret. You will need it later. ![Copy client sec](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/https://www.tnext-labs.com/GitHub/teams_health_feature_monitoring/ar10.png) #### 2. Create a SharePoint site To create a new SharePoint page navigate to SharePoint Online using the menu in the top right corner. ![Navigate to SP](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/https://www.tnext-labs.com/GitHub/teams_health_feature_monitoring/sp_hamb1.png) ![Create SP site](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/https://www.tnext-labs.com/GitHub/teams_health_feature_monitoring/sp1.png) Select a Modern Team Site and add the required members and owners. ![Select Teams site](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/https://www.tnext-labs.com/GitHub/teams_health_feature_monitoring/sp2_new.png) **Note:** You can also use a already existing modern SharePoint site. Copy the URL of the SharePoint site. You will need it later. ![Create SP site](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/https://www.tnext-labs.com/GitHub/teams_health_feature_monitoring/sp_url.png) #### 3. Import the SharePoint lists After the new site is created you can apply the list template. The template includes two lists for the service issues and the message center notifications. Make sure to install the PnP PowerShell module. https://pnp.github.io/powershell/ `Install-Module -Name PnP.PowerShell` `Connect-PnPOnline -Url "https://{Vanity domain host name}.sharepoint.com/sites/{Your site name} -Interactive` ![Connect to SP site](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/https://www.tnext-labs.com/GitHub/teams_health_feature_monitoring/sp3_new.png) The list template is part of this repo. You can apply it using the following cmdlet. `Invoke-PnPSiteTemplate -Path C:\Temp\SP_Lists_Template_TeamsHealthandFeatureMon_v2.xml -Handlers Lists` ![Apply the SP template](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/https://www.tnext-labs.com/GitHub/teams_health_feature_monitoring/sp4_new.png) After you applied the template you should see the following newly created lists. If not, please refresh the browser. ![Verify the lists](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/https://www.tnext-labs.com/GitHub/teams_health_feature_monitoring/sp5_update.png) #### 4. Import the Power Automate flow Navigate to the Power Automate portal (https://us.flow.microsoft.com) and go to **My flows**. Select **Import** to add the flow template to your environment. ![Select flow import](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/https://www.tnext-labs.com/GitHub/teams_health_feature_monitoring/pa1.png) When you import the flow you need to make sure to replace the existing connections as shown below: ![Replace the connections](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/https://www.tnext-labs.com/GitHub/teams_health_feature_monitoring/pa2_new.png) More details how to replace the connections can be found here: https://docs.microsoft.com/en-us/power-automate/add-manage-connections https://docs.microsoft.com/en-us/power-automate/create-team-flows#modify-a-connection The included connections are used for the following reasons: |**Connections** |Description | |---------|---------| |SharePoint Online |This connector is used to connect, read and write to the SharePoint lists. | |Microsoft Teams |Required to post messages to a Teams channel. | |Content Conversion |Required to convert HTML to plain text. |
After you replaced all the connections the import screen should look like this: ![flow import view](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/https://www.tnext-labs.com/GitHub/teams_health_feature_monitoring/pa3_new.png) Finally you can import the flow to your environment. ![final view after flow import](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/https://www.tnext-labs.com/GitHub/teams_health_feature_monitoring/pa4_new.png) ![flow successful import](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/https://www.tnext-labs.com/GitHub/teams_health_feature_monitoring/pa5.png) #### 5. Adjust the values in the Power Automate As very last step you need to adjust the SharePoint and Teams connections inside the flow. First you need to adjust the app registration information as showing in the following example: ![Logo path](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/https://www.tnext-labs.com/GitHub/teams_health_feature_monitoring/pa8_new.png) You need to adjust 6 times the SharePoint steps *(Make sure to select the correct list)*. The flow is divided into two trees, each to control a specific aspect of the monitoring: a. **Left hand side tree** to monitor a product health status (in this case Microsoft Teams and SfBO) b. **Right hand side tree** to monitor the Message Center Notifications The flow is shipped with two SharePoint lists that you imported earlier, in the service issues side of the flow-tree, you need to point all SharePoint lists flow steps to Service Health Notification SharePoint List, the same for the Message Center Notification flow-tree but by pointing to the Message Center Notification SharePoint list instead. ![Logo path](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/https://www.tnext-labs.com/GitHub/teams_health_feature_monitoring/pa_tree_new.png) ![Logo path](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/https://www.tnext-labs.com/GitHub/teams_health_feature_monitoring/pa9.png) Last but not least you need to adjust the Teams steps to your channel (3 times). ![Logo path](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/https://www.tnext-labs.com/GitHub/teams_health_feature_monitoring/pa10_new.png) **Note:** You could separate the incident posts from the message center posts into different channels if needed. :tada: **Let's go! Try it.** ## Usage **Service Issues:** The flow will check for any Microsoft Teams related issues that are classified as **Service Degradation** and store this information to a SharePoint list. As you can see the list template is configured with **conditional formatting** to highlight every degraded (red) and restored (green) service. In addition to the list the flow will also post directly to a defined Teams channel. This way the admins stay informed without the need of checking the service health section in the Office 365 admin center all the time or subscribe to the notification mails that spams their inbox. **Feature Updates:** The message center notification follows the same logic. Every Teams related entry will be stored in a SharePoint list. The list also includes pre-defined **conditional formatting** to highlight every entry that is tagged a "Plan for Change". Updates to the service will also be posted to Teams in case they require admin or user attention. Here two examples: **SharePoint List** ![MC SP](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/https://www.tnext-labs.com/GitHub/teams_health_feature_monitoring/mcsp01.png) **Teams Post** ![MC Post](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/https://www.tnext-labs.com/GitHub/teams_health_feature_monitoring/mc01_new.png) ## Other Workloads You can use the flow also for any other M365 Workload. All you need to do is to adjust the following filters in flow: ![MC Post](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/https://www.tnext-labs.com/GitHub/teams_health_feature_monitoring/filters.png) Next you need to adjust the HTML of the Teams posts (only the Title) to reflect the correct workload. ## Follow-ups (Tasks) If you want to take action on any of the Teams posts then use **Tasks** in Teams. ![Tasks01](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/https://www.tnext-labs.com/GitHub/teams_health_feature_monitoring/tasks01.png) ![Tasks02](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/https://www.tnext-labs.com/GitHub/teams_health_feature_monitoring/tasks02.png) ## Roadmap The following item are on the Roadmap: - Currently nothing planned. See the [open issues](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/https://github.com/tobiheim/teams-health-feature-monitoring/issues) for a list of proposed features (and known issues). ## Contributing Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are **greatly appreciated**. 1. Fork the Project 2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`) 3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`) 4. Push to the Branch (`git push origin feature/AmazingFeature`) 5. Open a Pull Request ## License Distributed under the MIT License. See `LICENSE` for more information. ## Contact Tobias Heim - [@saibothe](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/https://twitter.com/saibothe) **Thanks a lot to:** Mostafa Eid [@Lyncdude](https://github.com/tobiheim/teams-health-feature-monitoring/blob/master/https://twitter.com/Lyncdude) for contributing to the documentation.

近期下载者

相关文件


收藏者