Documentation forServer & Application Monitor

Microsoft Office 365 OneDrive

This SAM application monitor 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

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

Account 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 total files

Get the total number of files across all sites.

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.

Statistic Unit: Number

Amount of storage used total

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

Statistic Unit: GB

Number of total Accounts

Get the number of Total OneDrive for Business sites.

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.

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