Extend the platform,
empower your team.
Monitor Microsoft 365 (Office 365) performance, usage and availability.
ExtensionGet insights into your Microsoft Office 365 tenant services status, usage, performance and service availability. Understand service usage patterns over time for Mail, OneDrive, Teams, SharePoint, ActiveDirectory, watch licenses consumption and activations. One-stop, at-a-glance overview of Office 365 status keeps you informed - you always know first if any service level quality degradations are mounting, so you can react before serious business impact.
This extension is intended for users, who:
This extension enables you to:
Office 365 extension runs on Dynatrace Active Gate and connects to your Microsoft 365 tenant to scrape performance metrics. You need to connect using credentials that are provisioned specifically for monitoring purposes.
The process of configuring the monitoring access on your M365 instance includes:
The M365 tenant configuration step-by-step:
On the Azure admin portal, select the “Enterprise Applications” tab
The extension package contains:
Summary of the entities monitored: Office 365 extension collects metrics for the specified tenant, in categories of:
Summary of privileges required by the extension to work correctly, divided by API:
Summary of required privileges divided by feature set:
Note: These permissions are the permissions taken from above and grouped according to what each feature set requires.
A: Data is collected from Microsoft portal every 5 minutes. Typical delays for data available through Microsoft APIs are in 15-30 minutes range. However, some metrics are available in 1-day resolution only and always reflect yesterday's status:
A: The email activity metric is a tricky one; we are looking for ways to provide near-real-time email activity summaries. Any advice in this regard is welcomed. Please use the Community thread to provide feedback.
A: The metric "office365.tenant.service.health" represents the current health of the different M365 services. The specific service recorded by a metric line can be determined by looking at the "service" dimension. The value of the "Service Health Status" metric is calculated using a mapping between the possible status of each service to a numerical value:
serviceOperational -> 0,
falsePositive -> 1,
serviceRestored -> 2,
postIncidentReviewPublished -> 3,
verifyingService -> 4,
restoringService -> 5,
extendedRecovery -> 6,
investigating -> 7,
investigationSuspended -> 8,
serviceDegradation -> 9,
serviceInterruption -> 10,
These values increase as the corresponding service status becomes worse. Three tiers of service status can be used, values 0-4 are a healthy status, values 5-7 are in a warning state, and values 8 and above are considered an error status. These tiers are used in the default dashboard.
A: The extension collects data from the Microsoft Graph API and the Office 365 Management API. Microsoft's authentication endpoint is also used to retrieve authorization tokens. The specific API endpoint that gets used depends on the type of Office 365 tenant that is being monitored. The extension currently supports the Enterprise tenant.
Enterprise Tenant:
A: This extension does not monitor Azure AD or Active Directory on-prem. This extension provides only two metrics related to O365 user interactions with AD: number of logons and number of failed logons.
Use Active Directory monitoring extensions to monitor Active Directory on-prem. Note that these extensions don't support Azure AD.
A: The formula for DDU consumption of the extension is:
40 * 525.6 DDUs/year per monitored M365 tenant
Typically, there's one tenant monitored - your enterprise M365 tenant. However, the extension allows for monitoring of multiple tenants.
DDU cost above does not include any possible Log events or Custom events triggered by the extension. For more information on this, please visit the DDU log event cost and DDU custom event cost pages.
| Chart Name | Metric[s] | Description |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Service Health | office365.tenant.service.health | The current health of the different M365 services. Specifics on this value can be found in the 'Q: What does the metric "office365.tenant.service.health" represent?' |
| Users by Service | office365.tenant.services.user.counts | Number of active and inactive users for each M365 service, aggregated over a 7 day period. Data may be delayed up to 48 hours. |
| Mailbox User Counts | office365.outlook.users | Number of Outlook users, split by type of operation |
| Email Activity Count | office365.outlook.email.activity | Count of Outlook activity operations, split by status, aggregated over a 7 day period. Data may be delayed up to 48 hours. |
| Active Mailboxes | office365.outlook.mailbox.used | Count of active Outlook mailboxes, aggregated over a 7 day period. Data may be delayed up to 48 hours. |
| OneDrive Active Files | office365.onedrive.file.count.active | Number of active files in OneDrive |
| SharePoint Active Files | office365.sharepoint.file.count.active | Number of active files in SharePoint |
| AD Logins | office365.ad.logins / office365.ad.logins.failed | Number of successful and failed logins to Active Directory |
| Active Mailboxes Pct | office365.outlook.mailbox.used.pct | Percentage of Mailboxes in use, aggregated over a 7 day period. Data may be delayed up to 48 hours. |
| Mailbox Storage | office365.outlook.mailbox.storage | Amount of storage used by all Outlook mailboxes, aggregated over a 7 day period. Data may be delayed up to 48 hours. |
| Quota Status | office365.outlook.quota.status[.under.limit, .warning.issued, .send.prohibited, .send.receive.prohibited, .indeterminate] | Count of each category of sent mail, aggregated over a 7 day period. Data may be delayed up to 48 hours. |
| OneDrive Total Files | office365.onedrive.file.count.total | Total number of files in OneDrive divided by the site type, aggregated over a 7 day period. Data may be delayed up to 48 hours. |
| OneDrive Storage | office365.onedrive.storage | Size of all storage in OneDrive divided by the site type, aggregated over a 7 day period. Data may be delayed up to 48 hours. |
| OneDrive User Activity | office365.onedrive.active.users[.viewed.or.edited, .synced, .shared.internally, .shared.externally] | Count of all user operations in OneDrive divided by each operation, aggregated over a 7 day period. Data may be delayed up to 48 hours. |
| Teams Activities | office365.teams.activity.counts | Count of the number of times each Teams activity was performed. |
| Teams Users | office365.teams.user.counts | Count of unique users that performed an activity on Teams. |
| SharePoint Total Files | office365.sharepoint.file.count.total | Count of all files in SharePoint split by site type and file type, aggregated over a 7 day period. Data may be delayed up to 48 hours. |
| SharePoint Storage | office365.sharepoint.storage | Size of all storage in SharePoint split by site, aggregated over a 7 day period. Data may be delayed up to 48 hours. |
| SharePoint User Activity | office365.sharepoint.active.users[.visited_page, .viewed.or.edited, .synced, .shared.internally, .shared.externally] | Count of all user operations in SharePoint divided by each operation, aggregated over a 7 day period. Data may be delayed up to 48 hours. |
| SharePoint Visted Pages/Sites | office365.sharepoint.visited.pages.sites | Count of all SharePoint Pages and Sites that were visited. |
| Licenses Activations | office365.tenant.activation.counts[.windows, .mac, .android, .ios, .windows.mobile] | Count of all license activations divided by device type. Data may be delayed up to 48 hours. |
| Licenses Service Users | office365.tenant.services.user.counts | Count of M365 services users divided by activity and service type, aggregated over a 7 day period. Data may be delayed up to 48 hours. |
| Licenses Activations | office365.tenant.activated.enabled[.assigned, .activated, .shared.activation] | Count of M365 license activations divided by activation status. Data may be delayed up to 48 hours. |
Below is a complete list of the feature sets provided in this version. To ensure a good fit for your needs, individual feature sets can be activated and deactivated by your administrator during configuration.
Metric name | Metric key | Description | Unit |
---|---|---|---|
Windows Activations | office365.tenant.activation.counts.windows | Activation count for all windows devices across the organization. Note: 1-day resolution and data typically available within 48 hours. | Count |
Mac Activations | office365.tenant.activation.counts.mac | Activation count for all mac devices across the organization. Note: 1-day resolution and data typically available within 48 hours. | Count |
Android Activations | office365.tenant.activation.counts.android | Activation count for all android devices across the organization. Note: 1-day resolution and data typically available within 48 hours. | Count |
IOS Activations | office365.tenant.activation.counts.ios | Activation count for all ios devices across the organization. Note: 1-day resolution and data typically available within 48 hours. | Count |
Windows Mobile Activations | office365.tenant.activation.counts.windows.mobile | Activation count for all window mobile devices across the organization. Note: 1-day resolution and data typically available within 48 hours. | Count |
Service Users | office365.tenant.services.user.counts | User count across services by activity type. Note: 1-day resolution and data typically available within 48 hours. | Count |
Assigned Users | office365.tenant.activated.enabled.assigned | Number of users that have been assigned the subscription. Note: 1-day resolution and data typically available within 48 hours. | Count |
Activated Users | office365.tenant.activated.enabled.activated | Number of users that have activated the subscription. Note: 1-day resolution and data typically available within 48 hours. | Count |
Shared Activation Users | office365.tenant.activated.enabled.shared.activation | Number of users that have a shared computer activation of the subscription. Note: 1-day resolution and data typically available within 48 hours. | Count |
Metric name | Metric key | Description | Unit |
---|---|---|---|
Active Files | office365.onedrive.file.count.active | Total number of active files in OneDrive. | Count |
Total Files | office365.onedrive.file.count.total | Total number of files in OneDrive. Note: 1-day resolution and data typically available within 48 hours. | Count |
Storage | office365.onedrive.storage | Total storage in bytes used by OneDrive. Note: 1-day resolution and data typically available within 48 hours. | Byte |
Viewed or Edited | office365.onedrive.active.users.viewed.or.edited | Counts the times that OneDrive active users viewed or edited a file. Note: 1-day resolution and data typically available within 48 hours. | Count |
Synced | office365.onedrive.active.users.synced | Counts the times that OneDrive active users synced a file. Note: 1-day resolution and data typically available within 48 hours. | Count |
Shared Internally | office365.onedrive.active.users.shared.internally | Counts the times that OneDrive active users shared a file internally. Note: 1-day resolution and data typically available within 48 hours. | Count |
Shared Externally | office365.onedrive.active.users.shared.externally | Counts the times that OneDrive active users shared a file externally. Note: 1-day resolution and data typically available within 48 hours. | Count |
Metric name | Metric key | Description | Unit |
---|---|---|---|
Active Files | office365.sharepoint.file.count.active | Total number of SharePoint active files. | Count |
Total Files | office365.sharepoint.file.count.total | Total number of SharePoint files. Note: 1-day resolution and data typically available within 48 hours. | Count |
Storage | office365.sharepoint.storage | SharePoint storage used and allocated. Note: 1-day resolution and data typically available within 48 hours. | Byte |
Visited Page | office365.sharepoint.active.users.visited_page | Number of SharePoint active users who visited a page. Note: 1-day resolution and data typically available within 48 hours. | Count |
Viewed or Edited | office365.sharepoint.active.users.viewed.or.edited | Number of SharePoint active users who viewed or edited a file. Note: 1-day resolution and data typically available within 48 hours. | Count |
Synced | office365.sharepoint.active.users.synced | Number of SharePoint active users who synced a file. Note: 1-day resolution and data typically available within 48 hours. | Count |
Shared Internally | office365.sharepoint.active.users.shared.internally | Number of SharePoint active users who shared a file internally. Note: 1-day resolution and data typically available within 48 hours. | Count |
Shared Externally | office365.sharepoint.active.users.shared.externally | Number of SharePoint active users who shared a file externally. Note: 1-day resolution and data typically available within 48 hours. | Count |
Visited Pages/Sites | office365.sharepoint.visited.pages.sites | Total number of SharePoint Pages and Sites that have been visited. | Count |
Metric name | Metric key | Description | Unit |
---|---|---|---|
Teams Activities | office365.teams.activity.counts | Total number of Teams activities by activity type. | Count |
Teams Users | office365.teams.user.counts | Total number of Teams users by activity type. | Count |
Metric name | Metric key | Description | Unit |
---|---|---|---|
AD Logins | office365.ad.logins | Count of total AD logins. | Count |
AD Logins Failed | office365.ad.logins.failed | Count of failed AD logins. | Count |
Metric name | Metric key | Description | Unit |
---|---|---|---|
Service Health Status | office365.tenant.service.health | Gets the enumerated health of the service. | Count |
Metric name | Metric key | Description | Unit |
---|---|---|---|
Active Users | office365.outlook.users | Number of unique users who are performing email activities. | Count |
Active Mailboxes | office365.outlook.mailbox.used | Count of active user mailboxes in the organization. Note: 1-day resolution and data typically available within 48 hours. | Count |
Active Mailboxes Percent | office365.outlook.mailbox.used.pct | Percentage of user mailboxes that are active. Note: 1-day resolution and data typically available within 48 hours. | Percentage |
Mailbox Storage | office365.outlook.mailbox.storage | Amount of mailbox storage (in bytes) used by the organization. Note: 1-day resolution and data typically available within 48 hours. | Byte |
Under Limit Status | office365.outlook.quota.status.under.limit | Quota under limit status count of all mailboxes of the organization. Note: 1-day resolution and data typically available within 48 hours. | Count |
Warning Issued Status | office365.outlook.quota.status.warning.issued | Quota warning issued status count of all mailboxes of the organization. Note: 1-day resolution and data typically available within 48 hours. | Count |
Send Prohibited Status | office365.outlook.quota.status.send.prohibited | Quota send prohibited status count of all mailboxes of the organization. Note: 1-day resolution and data typically available within 48 hours. | Count |
Send Receive Prohibited Status | office365.outlook.quota.status.send.receive.prohibited | Quota send receive prohibited status count of all mailboxes of the organization. Note: 1-day resolution and data typically available within 48 hours. | Count |
Indeterminate Status | office365.outlook.quota.status.indeterminate | Quota indeterminate status count of all mailboxes of the organization. Note: 1-day resolution and data typically available within 48 hours. | Count |
Email Activity | office365.outlook.email.activity | Count of all email activity for Outlook. Note: data may be delayed up to 24 hours. | Count |
New features:
Patch level changes:
This is the first official release of this extension.
We look for your feedback, through Community, on the extension focus, scope and documentation.
The Preview release. There are some known issues, e.g. we grapple with some metrics availability, especially mail activity counters.
We look for your feedback, through Community, on both the extension focus, scope and documentation.