cancel
Showing results for 
Search instead for 
Did you mean: 
Create Post

Microsoft Office 365 Teams

Microsoft Office 365 Teams

This template shows information about Office 365 Teams and includes the following Component:

  • Number of Calls
  • Number of Meetings
  • Number of Chat Messages
  • Number of daily users by device type
    1. Web
    2. Windows Phone + Windows
    3. Android Phone, 
    4. iOS
    5. Mac

Prerequisites:

  • The details collected as part of above steps should be passed as Arguments to Monitors in below format/precedence

client_id=<Value>, TenantID=<Value>, client_secret=<Value>

Credentials:

  • The user should have SAM Administrator permissions
  • Pass Client ID and Password as Arguments to Monitors (Argument details mentioned in Pre-requisite)

MONITORED COMPONENTS

  • Number of Calls

Get the number of Microsoft Teams activities.

The activity types value given is calls.

Argument: Client ID, Tenant ID, Client Password

Format: client_id=<Value>, TenantID=<Value>, client_secret=<Value>

Statistic Unit: Number

  • Number of Meetings

Get the number of Microsoft Teams activities.

The activity types value given is Meetings.

Argument: Client ID, Tenant ID, Client Password

Format: client_id=<Value>, TenantID=<Value>, client_secret=<Value>

Statistic Unit: Number

  • Number of Chat Messages

Get the number of Microsoft Teams activities.

The activity types value given is Chat Message (Private + team)

Argument: Client ID, Tenant ID, Client Password

Format: client_id=<Value>, TenantID=<Value>, client_secret=<Value>

Statistic Unit: Number

  • Number of Daily Web User

Get the number of Microsoft Teams daily unique Web users

Argument: Client ID, Tenant ID, Client Password

Format: client_id=<Value>, TenantID=<Value>, client_secret=<Value>

Statistic Unit: Number

  • Number of Daily Windows User 

Get the number of Microsoft Teams daily unique Windows users (Windows Device+ Windows Phone)

Argument: Client ID, Tenant ID, Client Password

Format: client_id=<Value>, TenantID=<Value>, client_secret=<Value>

Statistic Unit: Number

  • Number of Daily Android Phone User 

Get the number of Microsoft Teams daily unique Android Phone users

Argument: Client ID, Tenant ID, Client Password

Format: client_id=<Value>, TenantID=<Value>, client_secret=<Value>

Statistic Unit: Number

  • Number of Daily iOS User

Get the number of Microsoft Teams daily unique iOS users

Argument: Client ID, Tenant ID, Client Password

Format: client_id=<Value>, TenantID=<Value>, client_secret=<Value>

Statistic Unit: Number

  • Number of Daily Mac User

Get the number of Microsoft Teams daily unique Mac users

Argument: Client ID, Tenant ID, Client Password

Format: client_id=<Value>, TenantID=<Value>, client_secret=<Value>

Statistic Unit: Number

Troubleshooting steps

Detail troubleshooting steps (common for template)

Use UPN format (username@domain) and not domain\username format to enter credentials. Also, a service account for Exchange Web Services is recommended to avoid authentication issues when passwords are updated.

Portions of this document were originally created by and are excerpted from the following sources:

https://docs.microsoft.com/en-us/graph/overview?toc=./toc.json&view=graph-rest-1.0

https://docs.microsoft.com/en-us/graph/api/resources/report?view=graph-rest-1.0

Last updated: <Date updated>



Labels (1)
Attachments
Comments

Is this for Teams or Skype for Business?  These are still two separate services and I'm confused by the naming and descriptions of this template which seem to be at odds with one another.

It is for Teams... Sorry for the confusion. I have edited the text appropriately.

Thanks for the heads up!

Struggling to get this working:

I'm running the test locally on my SAM server. The host is running the latest powershell version (5.1). I'm using credentials in the UPN format and the user has SAM admin.

I beleive I have the script parameters correct.

I'm getting this error when I test on the SAM server.

Output:      ==============================================

eyJ0eXAiOiJKV1QiLCJub25jZSI6IkFRQUJBQUFBQUFEQ29NcGpKWHJ4VHE5Vkc5dGUtN0ZYdzFxempCY2pWdVBsOE1CaFFPR3NQamI3TEZBRElzUE5hcmUzNVpmaHl2X3pBWTY0ZTlLZTVNZ2hSNTc3OHhVb2gyWTZWeDJqYk1URDBndTBiVXJuM0NBQSIsImFsZyI6IlJTMjU2IiwieDV0IjoiSEJ4bDltQWU2Z3hhdkNrY29PVTJUSHNETmEwIiwia2lkIjoiSEJ4bDltQWU2Z3hhdkNrY29PVTJUSHNETmEwIn0.eyJhdWQiOiJodHRwczovL2dyYXBoLm1pY3Jvc29mdC5jb20iLCJpc3MiOiJodHRwczovL3N0cy53aW5kb3dzLm5ldC85YzFiOTkxNi02MjkwLTQ1M2YtYTFjMy1hNjBmMjJhNzliYzAvIiwiaWF0IjoxNTU5MzA4MTkxLCJuYmYiOjE1NTkzMDgxOTEsImV4cCI6MTU1OTMxMjA5MSwiYWlvIjoiNDJaZ1lQaDR0ZU5seUMzbXVGY0cyUlpMTkhhZUJRQT0iLCJhcHBfZGlzcGxheW5hbWUiOiJTb2xhcldpbmRzIFNBTSIsImFwcGlkIjoiOTI2Njk5NjQtOTk0Mi00MjkxLTk2NjMtNTIwYzgyMWZmYzFjIiwiYXBwaWRhY3IiOiIxIiwiaWRwIjoiaHR0cHM6Ly9zdHMud2luZG93cy5uZXQvOWMxYjk5MTYtNjI5MC00NTNmLWExYzMtYTYwZjIyYTc5YmMwLyIsIm9pZCI6IjY5NTJkYmNlLTg5MWQtNDQwZS1hNmFkLTYxMWUyODUyMTJlYyIsInN1YiI6IjY5NTJkYmNlLTg5MWQtNDQwZS1hNmFkLTYxMWUyODUyMTJlYyIsInRpZCI6IjljMWI5OTE2LTYyOTAtNDUzZi1hMWMzLWE2MGYyMmE3OWJjMCIsInV0aSI6InZZU0ZLRkFESVVhZWpfYmtvNHNSQUEiLCJ2ZXIiOiIxLjAiLCJ4bXNfdGNkdCI6MTQ0ODM1OTY4N30.LDcDH3BDK5JU4XWXs4THnhBL_ZpLIi7TNT1wz74WH9_-gvJNvvIy1LyWsFmVP3yPccIxny9TEWcnH37LBiRQg24ONNGWqo9lGuPx60QO2hzMmF4dDv1nr8G0K5ivSWXrWx7ysE0CmYhC6HmYSAHqbsygj4BPFRnD9SEIJyp5IMqV_6Y_beWlt3JDWEPq8YsUx2qIk-2fIpu-yv3mtzG8jahC9Pnv3wVPRJOFrae8CELAgYBzPW7I7b_OipAHfzznn8-LEuzDiXqgLeqbIgp8TEy7kVXAloAbU5zMvSEKGdZoKe_xFoivmYqFJ9eAHx9kozLMm2fEoVpe5AAHhIOiqA

[ERROR] The remote server returned an error: (403) Forbidden.

pastedImage_0.png

Any thoughts?

Thanks in advance.

Here are steps to configure the PSMSGraph module to support the Office 365 Teams template, which will be included in the next edition of the SAM documentation. Perhaps the issue you're experiencing is related to how PSMSGraph is configured.

Integrate Office 365 templates with Microsoft Graph

You can configure the following Office 365 templates to work with Microsoft Graph, a product that offers a single REST API endpoint where SAM can access data for Office 365 services such as OneDrive, SharePoint, and Skype.

  • Microsoft Office 365 OneDrive
  • Microsoft Office 365 SharePoint Online
  • Microsoft Office 365 Skype
  • Microsoft Office 365 Skype for Business
  • Microsoft Office 365 Teams

To learn more about Graph, see:

Note: All Microsoft links in this topic are © 2019 Microsoft Corp., available at https://docs.microsoft.com, obtained on May 8, 2019.

Requirements

  • PSMSGraph PowerShell module for the Microsoft Graph API is installed and configured on the Orion server.
  • Collect the following values for use in arguments for Office 365 component monitors.
  • Reports.Read.All-level rights for Delegated Permissions and Application Permissions in Microsoft Graph.

Set up the PSMSGraph module on the Orion server

To install and configure the PSMSGraph module on the Orion server:

  1. Install PSMSGraph by following steps from either of these websites:
  2. Verify the module is installed correctly.
    1. In the PowerShell console, type: Get-Module -ListAvailable -Name "psmsgraph"
    2. Compare the output to the following screenshot; it should be similar.

Register the app

To provide SAM and the PSMSGraph module with read access to Azure data, you'll need to register an Azure Active Directory (AD) app in the Azure portal.

When you create the app, use a recognizable name, such as "SAM Office 365 Graph".

Here are some links that provide more information about configuring Azure AD apps:

To register an app in the Azure AD instance:

  1. Navigate to https://apps.dev.microsoft.com/
  2. Log into the Application Registration Portal.
  3. On the My applications page, click Add an app.
  4. Enter your Application Name in the field provided and click Create.
  5. Under Properties page, provide the Name for the app.
  6. Record the Application ID that appears beneath the Name field.
  7. Click Generate New Password.
  8. Under Microsoft Graph Permissions, select the Reports.Read.All level for the following permission types, and then click OK.
    • Delegated Permissions
    • Application Permissions
  9. Click Save.

Get Admin Consent for the app

To approve permissions for your app, your Azure AD admin can follow these steps.

  1. Log into https://portal.azure.com using the Global Administrator account.
  2. Navigate to All Services > Identity > Azure Active Directory.
  3. On the Azure Active Directory page, click App registration (preview) and select the app you just registered.
  4. In the app, note the Client ID and Tenant ID. They should match IDs recorded earlier in the process.
  5. Click View API Permissions.
  6. On the API permissions page, click Add a permission to grant Report.Read.All rights for:
    • Delegated Permissions, and
    • Application Permissions
  7. Under Grant consent, click Grant admin consent for (requestor).
  8. Click Yes to confirm record updates.A "Successfully granted admin consent for requested permissions" message should appear.

Disclaimer: Please note, any custom scripts or other content posted herein are provided as a suggestion or recommendation to you for your internal use. This is not part of the SolarWinds software that you have purchased from SolarWinds, and the information set forth herein may come from third party customers. Your organization should internally review and assess to what extent, if any, such custom scripts or recommendations will be incorporated into your environment. Any custom scripts obtained herein are provided to you “AS IS” without indemnification, support, or warranty of any kind, express or implied. You elect to utilize the custom scripts at your own risk, and you will be solely responsible for the incorporation of the same, if any.

Just verifying that we should be able to set this up and have a data point for each day. This data point would be the number of say Teams Private IM Chats over the past 24 hours? reading the support docs from MS Graphs I am confused because I see that 7 days is the smallest timeframe available. How is this pulling the values for a 24 hour period?

Would it be possible to have an example of this monitor added to the SolarWinds Orion demo instance so I can review it with our engineers? If I can show it to them working I think it would be beneficial.

No love? AlterEgo, I know you are out there Save the day, please

Including serena​ as she is now the Product Manager for SAM and may be able to assist here.

I am wondering about the credential for monitoring? I keep getting this error:

pastedImage_0.png

acandell​ The SAM Template Reference includes details on individual templates, including prerequisites, required credentials, port requirements (if applicable), and a list of component monitors included in each template. For the Microsoft Office 365 Teams template released in SAM 6.9, credentials must be for a user in the SAM Administrator group. Also, use UPN format (username@domain) and not domain\username format to enter credentials.

If you continue getting the error, you can reach out to SolarWinds Support for assistance. See Working with Support for details.

Version history
Revision #:
1 of 1
Last update:
‎01-07-2019 01:50 PM
Updated by:
Product Manager