Documentation forServer & Application Monitor

Microsoft Office 365 OneDrive

This template shows information about Office 365 OneDrive and includes the following component monitors:

  • Number of total files
  • Number of active files
  • Amount of storage used total
  • Number of total accounts
  • Number of active accounts

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).

Prerequisites

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

When you configure the PSMSGraph PowerShell module for Microsoft Graph, collect the following values to pass as arguments to monitors in the following format/precedence:
client_id=<Value>, TenantID=<Value>, client_secret=<Value>

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.

Account has privileges to pass credentials as arguments to monitors.

Component monitors

Number of total files

Get the total number of files across all sites.

Argument: Client ID, Tenant ID, Client Password

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

Statistic Unit: Number

Number of active files

Get the Active number of files across all sites. A file is considered active if it has been saved, synced, modified, or shared within the specified time period.

Argument: Client ID, Tenant ID, Client Password

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

Statistic Unit: Number

Amount of storage used total

Get the trend on the amount of storage you are using in OneDrive for Business.

Argument: Client ID, Tenant ID, Client Password

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

Statistic Unit: GB

Number of total Accounts

Get the number of Total OneDrive for Business sites.

Argument: Client ID, Tenant ID, Client Password

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

Statistic Unit: Number

Number of Active Accounts

Get the trend in the number of active OneDrive for Business sites. Any site on which users viewed, modified, uploaded, downloaded, shared, or synced files is considered an active site.

Argument: Client ID, Tenant ID, Client Password

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

Statistic Unit: Number