Documentation forServer & Application Monitor

Microsoft Office 365 Teams

This SAM application monitor template shows information about Office 365 Teams and includes the following component monitors:

  • Number of Calls
  • Number of Meetings
  • Number of Chat Messages
  • Number of daily users by device type
    • Web
    • Windows Phone and Windows
    • Android Phone
    • iOS
    • Mac

Prerequisites

The PSMSGraph PowerShell module is installed and the Client is configured in Azure AD. See Integrate Office 365 application monitor templates with Microsoft Graph in SAM.

When you configure the PSMSGraph PowerShell module, collect the following values to pass as arguments to component monitors in the following format and order of precedence.
client_id=<Value>, TenantID=<Value>, client_secret=<Value>, apiversion=v1.0

Starting in SAM 2020.2.5, apiversion=v1.0 is required in PowerShell scripts for this template and related application monitors. Otherwise, scripts return [ERROR] The remote server returned an error: (404) Not Found. messages. Alternatively, use the Microsoft 365 Teams API poller template.

Credentials

  • An Orion account with SAM administrator permissions.
  • An all-in-one, inclusive Office 365 account with Global Administrator privileges.

    Alternatively, use an account with an admin role that has permission to access data to be monitored via the Office 365 API.

  • Use UPN format (username@domain) — not domain\username format to enter credentials.

    To avoid authentication issues if passwords change, use a service account.

User has privileges to pass credentials as arguments to monitors.

Component monitors

For component monitors that require script arguments, use the same format configured for the PSMSGraph PowerShell module:

client_id=<Value>, TenantID=<Value>, client_secret=<Value>, apiversion=v1.0

Number of Calls

Get the number of Microsoft Teams activities. The activity types value given is calls.

Statistic Unit: Number

Number of Meetings

Get the number of Microsoft Teams activities. The activity types value given is Meetings.

Statistic Unit: Number

Number of Chat Messages

Get the number of Microsoft Teams activities. The activity types value given is Chat Message (Private + team).

Statistic Unit: Number

Number of Daily Web User

Get the number of Microsoft Teams daily unique Web users.

Statistic Unit: Number

Number of Daily Windows User

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

Statistic Unit: Number

Number of Daily Android Phone User

Get the number of Microsoft Teams daily unique Android Phone users.

Statistic Unit: Number

Number of Daily iOS User

Get the number of Microsoft Teams daily unique iOS users.

Statistic Unit: Number

Number of Daily Mac User

Get the number of Microsoft Teams daily unique Mac users.

Statistic Unit: Number

Portions of this topic are based on Overview of Microsoft Graph and Working with Office 365 usage reports in Microsoft Graph (© 2019 Microsoft Corp., available at https://docs.microsoft.com, obtained on May 8, 2019).