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