The M365 integration enables discovery of the following M365 services, providing visibility into service availability and performance for root cause analysis and remediation:

M365 AppsM365 Azure Information ProtectionM365 Bookings
M365 Dynamics 365 AppsM365 Exchange OnlineM365 Forms
M365 Identity ServiceM365 Mobile Device ManagementM365 Office for the web
M365 OneDrive for BusinessM365 PlannerM365 Power Apps
M365 Power Apps in Microsoft 365M365 Power AutomateM365 Power Automate in Microsoft 365
M365 Power BIM365 SharePoint OnlineM365 StaffHub
M365 StreamM365 SuiteM365 Sway
M365 TeamsM365 Yammer Enterprise
Microsoft KaizalaMicrosoft VivaProject for the web
Project OnlineSkype for Business

After completing the integration installation and set up, Microsoft 365 resources are discovered and monitoring is enabled as specified in the configuration profile.

Step 1: Register the application with Azure AD

These steps register and authorize a new application to call the reports API.

  1. Log in to the Azure portal using an administrator account.

  2. From the Azure Services menu, Navigate to the App registrations page:

    Image
  3. Select + New Registration.

  4. Enter a display Name and select from the Support account types for who is authorized to access the API:

    Image
  5. Click Register.

  6. On the registration page, save the values in the Application (client) ID and Directory (tenant) ID fields. These are needed later to complete the OpsRamp part of the integration in Step 3: Configure the integration:

    Image

Step 2: Configure API permissions

In the left navigation panel, click API permissions to add new permissions for the Microsoft Graph and Office 365 Management APIs:

Image

This step describes how to:

    ☑ Add a Microsoft Graph permission
    ☑ Add an Office 365 Management API permission

Add a Microsoft Graph permission

  1. Click + Add a permission to get a list of commonly used APIs:

    Image
  2. You want to add a permission to the Microsoft Graph API. Select Microsoft Graph:

    Image
  3. Click Application permissions to specify the type of permission needed:

    Image
  4. Select the following permissions:

    PermissionDescription
    User.Read.AllPermits you to sign in to the application with your organization account and enables the application to read your profile and basic company information.
    Reports.Read.AllPermits the application to read all service usage reports without having a signed-in user. Services that provide usage reports include Office 365 and Azure Active Directory.

Add an Office 365 Management API permission

  1. On the Request API permissions page, select Office 365 Management APIs:

    Image
  2. Click Application permissions to specify the type of permission needed:

    Image
  3. Select the following permission:

    PermissionDescription
    ServiceHealth.ReadPermits you to read organization service health information.
  4. Go to the API Permissions page and grant permission for all configured permissions by selecting Grant admin consent for xyz:

    Image
  5. In the left navigation panel, click Certificates & secrets:

    Image
  6. Select + New client secret.

    Image
  7. Add a Description and select a time duration for when the secret Expires:

    Image
  8. Click Add.

  9. Save the Value and Secret ID. These are needed later to complete the OpsRamp part of the integration in Step 3: Configure the integration:

    Image

Step 3: Configure the integration

  1. From All Clients, select a client.

  2. Go to Setup > Integrations > Integrations.

  3. In the Saas Application section, select Office365:

    Image
  4. Enter your account information:

    Image
    PropertyDescription
    Name(required) User-defined, descriptive integration name.
    Subscription Id(required) Azure subscription ID, from **Azure services > Subscriptions**.
    Client ID(required) OpsRamp client ID saved from Step 1.
    Tenant ID(required) OpsRamp tenant ID saved from Step 1.
    Security Key>(required) Client secret ID saved from the Add an Office 365 Management API permission step.
    Confirm Security Key(required) Reenter the Security Key.
  5. Click Next.

  6. Choose the discovery schedule period:

    Image
  7. Click Finish.

Next steps

After configuring the integration, M365 services discovery and monitoring is enabled. Discovered services and metrics can be viewed from the Infrastructure page.

No templates need to be applied on discovered devices. Alerts can be enabled using alert policies.

Supported metrics

ResourceMetric NameMetric Display NameUnits
Exchangeoffice365_exchange_MailboxSizeTotal

Total storage consumption by all mailboxes
Mailbox Total Sizegigabytes
office365_exchange_ActiveOrTotalMailboxCount

Number of mailboxes with active count. Active means the user sent/received or read a mail on that day. Categories: total count, active count
Active/total mailbox countcount
office365_exchange_MailboxQuotaLimitCount

Number of mailboxes that have crossed a specific limit. Categories: Under Limit, Warning Issued, Send Prohibited, Send/Receive Prohibited
Number of mailboxes under quota limit countcount
office365_exchange_MessagesTotalSentReadReceived

Number of messages sent, received, read, or any of these three by the organization in total. Categories: sent, received, read, total
Total messages sent/read/receivedcount
office365_exchange_AppUsage

Number of users of different apps or protocols.
  • Categories: Mail for Mac, Outlook for Mac, and more
  • Total: 9
Individual specific app usage in Exchange Onlinecount
SharePointoffice365_sharepoint_UniqueUserCount

Number of unique users who in any way interacted with SharePoint. Categories: Viewed Or Edited, Synced, Shared Internally, Shared Externally
Number of unique users who interacted with Sharepoint in specific wayscount
office365_sharepoint_ActiveUserCount

Total number of interactions with SharePoint without respect to the uniqueness of the user.
  • Categories: Viewed Or Edited, Synced, and more
  • Total: 5
Number of active users who interacted with Sharepoint in specific wayscount
office365_sharepoint_PageVisitCount

Number of unique pages visited by users.
Number of unique pages visited by userscount
office365_sharepoint_ActiveFileCount

Number of files that have been interacted with on that day. Categories: total, active
Number of files in SharePoint that have been interacted withcount
office365_sharepoint_TotalFileCount

Total number of files in SharePoint. Categories: total, active
Total number of files in SharePointcount
office365_sharepoint_Storage

Total storage consumed using SharePoint.
Total storage consumed using SharePointGB
office365_sharepoint_TotalPageVisitCount

Number of pages viewed across all sites. Provided info: page visit count.
Number of pages viewed across all sitescount
yammeroffice365_yammer_InteractionWithMessagesCount

Number of interactions with Yammer messages. Categories: liked, posted, read
Number of interaction with Yammer messagescount
office365_yammer_UniqueUserCountInteractingWithMessages

Number of unique users who interacted with Yammer messages. Categories: liked, posted, read
Number of unique users who interacted with Yammer messagescount
office365_yammer_UserCountByDeviceType

Number of users by device type interacting using Yammer.
  • Categories: web, iPhone, iPad, and more
  • Total: 6
Number of users by device type interacting using Yammercount
office365_yammer_DailyUserCountByDeviceType

Number of daily users by device type interacting using Yammer.
  • Categories: web, iPhone, iPad, and more
  • Total: 6
Number of daily users by device type interacting using Yammercount
office365_yammer_GroupCount

Number of groups in Yammer. Categories: total, active
Number of groups in Yammercount
office365_yammer_InteractionInGroupsCount

Number of interaction with messages in Yammer groups. Categories: liked, posted, read
Number of interactions with messages in Yammer groupscount
Microsoft Teamsoffice365_microsoftteams_DailyUniqueUsersByDeviceType

Number of Microsoft Teams daily unique users by device type.
  • Categories: iOS, Android Phone, and more
  • Total: 6
Number of Microsoft Teams daily unique users by device typecount
office365_microsoftteams_DailyActivitiesByActivityType

Number of Microsoft Teams activities by activity type.
  • Categories: Calls, Meetings, and more
  • Total: 4
Number of Microsoft Teams activities by activity typecount
office365_microsoftteams_DailyUniqueUsersByActivityType

Number of Microsoft Teams unique users by activity type.
  • Categories: Calls, Meetings, and more
  • Total: 5
Number of Microsoft Teams users by activity typecount
OneDriveForBusinessoffice365_onedrive_ActiveUserCount

Total number of interactions with OneDrive without respect to the uniqueness of the user.
  • Categories: Viewed Or Edited, Synced, and more
  • Total: 4
Number of users who interacted with OneDrivecount
office365_onedrive_UniqueUserCount

Number of unique users who in any way interacted with OneDrive.
  • Categories: Viewed Or Edited, Synced, and more
  • Total: 4
Number of unique users who interacted with OneDrivecount
office365_onedrive_ActiveSiteCount

Number of active business sites in OneDrive. Categories: total, active
Number of active business sites in OneDrivecount
office365_onedrive_TotalFileCount

Total number of files in OneDrive. Categories: total, active
Total number of files in OneDrivecount
office365_onedrive_Storage

Total storage consumed using OneDrive.
Total storage consumed using OneDriveGB
OSDPPlatform (Microsoft 365 suite)office365_osdpplatform_ActiveUserCount

Number of users who interacted with specific services.
  • Categories: Exchange OneDrive, and more
  • Total: 7
Number of daily active users in specific servicescount
office365_osdpplatform_ActiveInactiveUserInServicesCount

Number of users if active or not in specific services.
  • Categories: Exchange Active, OneDrive Active, and more
  • Total: 14
Number of users with activity type in servicescount
office365_osdpplatform_GroupActivityCount

Number of activities in groups with activity type.
  • Categories: number of exchange emails received, and more
  • Total: 4
Number of group activitiescount
office365_osdpplatform_ActiveGroupCount

Number of groups. Categories: active, total
Number of groups that have interacted with Office 365count
office365_osdpplatform_Storage

Total storage consumed by all the users. Categories: Mailbox Storage Used, Site Storage Used
Total storage consumed by all the usersGB
office365_osdpplatform_FileCount

Total number of files used by all the . Categories: active, total
Total number of files used by all the userscount
Health StatusHealth status metrics have a value in the range zero (0) through nine (9). The numeric value has the following enumeration:
  • 0 = Investigating. Microsoft is aware of a potential issue and is gathering more information and the scope of impact.
  • 1 = ServiceDegradation. Microsoft confirms that there is an issue, which may affect the use of a service or feature. You might see this status if a service is performing more slowly than expected, there are intermittent interruptions, or if a feature is not working.
  • 2 = ServiceInterruption. Microsoft determined that an issue affects the ability of users to access the service. The issue is significant and can be consistently reproduced.
  • 3 = RestoringService. The cause of the issue has been identified, Microsoft knows the corrective action and is in the process of returning the service to a healthy state.
  • 4 = ExtendedRecovery. Corrective action is in progress to restore service to most users but it might take time to restore the service to all affected systems. You might also see this status if Microsoft made a temporary fix to reduce impact while waiting to apply a permanent fix.
  • 5 = InvestigationSuspended. Microsoft is investigating a potential issue, which might result in a request for additional information from customers. Microsoft might request data or logs.
  • 6 = ServiceRestored. Microsoft confirms that corrective action has resolved the underlying problem and the service has been restored to a healthy state. View the issue details to find the cause of the problem.
  • 7 = PostIncidentReviewPublished. Microsoft published a Post Incident Report for a specific issue, which includes root cause information and next steps to ensure that a similar issue does not reoccur.
  • 8 = FalsePositive. After a detailed investigation, Microsoft confirms the service is healthy and operating as intended. No impact to the service was observed or the cause of the incident originated outside of the service.
  • 9 = ServiceOperational. Service features are healthy and running as intended.
office365_bookings_ServiceStatus

Service status of Microsoft Bookings representing current service operability. Range: 0-9
Microsoft Bookings Statusstatus
office365_dynamicscrm_ServiceStatus

Service status of Dynamic 365 App representing current service operability. Range: 0-9
Dynamic 365 Apps Statusstatus
office365_exchange_ServiceStatus

Service status of Exchange Online representing current service operability. Range: 0-9
Exchange Online Statusstatus
office365_forms_ServiceStatus

Service status of Microsoft Forms representing current service operability. Range: 0-9
Microsoft Forms Statusstatus
office365_kaizalamessagingservices_ServiceStatus

Service status of Microsoft Kaizala representing current service operability. Range: 0-9
Microsoft Kaizala Statusstatus
office365_lync_ServiceStatus

Service status of Skype for Business representing current service operability. Range: 0-9
Skype for Business Statusstatus
office365_microsoftflow_ServiceStatus

Service status of Microsoft Power Automate representing current service operability. Range: 0-9
Microsoft Power Automate Statusstatus
office365_microsoftflowm365_ServiceStatus

Service status of Microsoft Power Automate in Microsoft 365 representing current service operability. Range: 0-9
Microsoft Power Automate in Microsoft 365 Statusstatus
office365_microsoftteams_ServiceStatus

Service status of Microsoft Teams representing current service operability. Range: 0-9
Microsoft Teams Statusstatus
office365_mobiledevicemanagement_ServiceStatus

Service status of Mobile Device Management for Office 365 representing current service operability. Range: 0-9.
Mobile Device Management for Office 365 Statusstatus
office365_o365client_ServiceStatus

Service status of Microsoft 365 Apps representing current service operability. Range: 0-9.
Microsoft 365 Apps Statusstatus
office365_officeonline_ServiceStatus

Service status of Office for the web representing current service operability. Range: 0-9.
Office for the web Statusstatus
office365_onedriveforbusiness_ServiceStatus

Service status of OneDrive for Business representing current service operability. Range: 0-9.
OneDrive for Business Statusstatus
office365_orgliveid_ServiceStatus

Service status of Identity Service representing current service operability. Range: 0-9.
Identity Service Service Statusstatus
office365_osdpplatform_ServiceStatus

Service status of Microsoft 365 suite representing current service operability. Range: 0-9.
Microsoft 365 suite Statusstatus
office365_planner_ServiceStatus

Service status of Planner representing current service operability. Range: 0-9.
Planner Statusstatus
office365_powerapps_ServiceStatus

Service status of Power Apps representing current service operability. Range: 0-9.
Power Apps Statusstatus
office365_powerappsm365_ServiceStatus

Service status of Power Apps in Microsoft 365 representing current service operability. Range: 0-9.
Power Apps in Microsoft 365 Statusstatus
office365_powerbicom_ServiceStatus

Service status of Power BI representing current service operability. Range: 0-9
Power BI Statusstatus
office365_projectfortheweb_ServiceStatus

Service status of Project for the web representing current service operability. Range: 0-9.
Project for the web Statusstatus
office365_projectonline_ServiceStatus

Service status of Project Online representing current service operability. Range: 0-9.
Project Online Statusstatus
office365_rms_ServiceStatus

Service status of Azure Information Protection representing current service operability. Range: 0-9
Azure Information Protection Statusstatus
office365_sharepoint_ServiceStatus

Service status of Sharepoint Online representing current service operability. Range: 0-9
Sharepoint Online Statusstatus
office365_staffhub_ServiceStatus

Service status of Microsoft Staffhub representing current service operability. Range: 0-9
Microsoft Staffhub Statusstatus
office365_stream_ServiceStatus

Service status of Microsoft Stream representing current service operability. Range: 0-9
Microsoft Stream Statusstatus
office365_swayenterprise_ServiceStatus

Service status of Sway representing current service operability. Range: 0-9
Sway Statusstatus
office365_viva_ServiceStatus

Service status of Microsoft Viva representing current service operability. Range: 0-9
Microsoft Viva Statusstatus
office365_yammer_ServiceStatus

Service status of Yammer representing current service operability. Range: 0-9
Yammer Enterprise Statusstatus
IncidentCountoffice365_bookings_IncidentCount

Number of log entries for specific reasons. Categories: resolved count, pending count, total count
Microsoft Bookings Incident Countcount
office365_dynamicscrm_IncidentCount

Number of log entries for specific reasons. Categories: resolved count, pending count, total count
Dynamic 365 Apps Incident Countcount
office365_exchange_IncidentCount

Number of log entries for specific reasons. Categories: resolved count, pending count, total count
Exchange Online Incident Countcount
office365_forms_IncidentCount

Number of log entries for specific reasons. Categories: resolved count, pending count, total count
Microsoft Forms Incident Countcount
office365_kaizalamessagingservices_IncidentCount

Number of log entries for specific reasons.
  • Categories: resolved count, pending count, total count
  • Total: 34
Microsoft Kaizala Incident Countcount
office365_lync_IncidentCount

Number of log entries for specific reasons.
  • Categories: resolved count, pending count, total count
  • Total: 34
Skype for Business Incident Countcount
office365_microsoftflow_IncidentCount

Number of log entries for specific reasons. Categories: resolved count, pending count, total count
Microsoft Power Automate Incident Countcount
office365_microsoftflowm365_IncidentCount

Number of log entries for specific reasons. Categories: resolved count, pending count, total count
Microsoft Power Automate in Microsoft 365 Incident Countcount
office365_microsoftteams_IncidentCount

Number of log entries for specific reasons. Categories: resolved count, pending count, total count
Microsoft Teams Incident Countcount
office365_mobiledevicemanagement_IncidentCount

Number of log entries for specific reasons. Categories: resolved count, pending count, total count
Mobile Device Management for Office 365 Incident Countcount
office365_o365client_IncidentCount

Number of log entries for specific reasons. Categories: resolved count, pending count, total count
Microsoft 365 Apps Incident Countcount
office365_officeonline_IncidentCount

Number of log entries for specific reasons. Categories: resolved count, pending count, total count
Office for the web Incident Countcount
office365_onedriveforbusiness_IncidentCount

Number of log entries for specific reasons. Categories: resolved count, pending count, total count
OneDrive for Business Incident Countcount
office365_orgliveid_IncidentCount

Number of log entries for specific reasons. Categories: resolved count, pending count, total count
Identity Service Service Incident Countcount
office365_osdpplatform_IncidentCount

Number of log entries for specific reasons. Categories: resolved count, pending count, total count
Microsoft 365 suite Incident Countcount
office365_planner_IncidentCount

Number of log entries for specific reasons.
  • Categories: resolved count, pending count, total count
  • Total 34
Planner Incident Countcount
office365_powerapps_IncidentCount

Number of log entries for specific reasons. Categories: resolved count, pending count, total count
Power Apps Incident Countcount
office365_powerappsm365_IncidentCount

Number of log entries for specific reasons. Categories: resolved count, pending count, total count
Power Apps in Microsoft 365 Incident Countcount
office365_powerbicom_IncidentCount

Number of log entries for specific reasons. Categories: resolved count, pending count, total count
Power BI Incident Countcount
office365_projectfortheweb_IncidentCount

Number of log entries for specific reasons.
  • Categories: resolved count, pending count, total count
  • Total: 34
Project for the web Incident Countcount
office365_projectonline_IncidentCount

Number of log entries for specific reasons.
  • Categories: resolved count, pending count, total count
  • Total: 34
Project Online Incident Countcount
office365_rms_IncidentCount

Number of log entries for specific reasons. Categories: resolved count, pending count, total count
Azure Information Protection Incident Countcount
office365_sharepoint_IncidentCount

Number of log entries for specific reasons. Categories: resolved count, pending count, total count
Sharepoint Online Incident Countcount
office365_staffhub_IncidentCount

Number of log entries for specific reasons. Categories: resolved count, pending count, total count
Microsoft Staffhub Incident Countcount
office365_stream_IncidentCount

Number of log entries for specific reasons. Categories: resolved count, pending count, total count
Microsoft Stream Incident Countcount
office365_swayenterprise_IncidentCount

Number of log entries for specific reasons. Categories: resolved count, pending count, total count
Sway Incident Countcount
office365_viva_IncidentCount

Number of log entries for specific reasons.
  • Categories: resolved count, pending count, total count
  • Total: 34
Microsoft Viva Incident Countcount
office365_yammer_IncidentCount

Number of log entries for specific reasons. Categories: resolved count, pending count, total count
Yammer Enterprise Incident Countcount
ServiceOutageoffice365_bookings_ServiceOutageInHours

Length of time that the Microsoft Bookings service has been out of order.
Microsoft Bookings Service Outage in Hourshours
office365_dynamicscrm_ServiceOutageInHours

Length of time that the Dynamic 365 Apps Service service has been out of order.
Dynamic 365 Apps Service Outage in Hourshours
office365_exchange_ServiceOutageInHours

Length of time that the Exchange Online service has been out of order.
Exchange Online Service Outage in Hourshours
office365_forms_ServiceOutageInHours

Length of time that the Microsoft Forms service has been out of order.
Microsoft Forms Service Outage in Hourshours
office365_kaizalamessagingservices_ServiceOutageInHours

Length of time that the Microsoft Kaizala service has been out of order.
Microsoft Kaizala Service Outage in Hourshours
office365_lync_ServiceOutageInHours

Length of time that the Skype for Business service has been out of order.
Skype for Business Service Outage in Hourshours
office365_microsoftflow_ServiceOutageInHours

Length of time that the Microsoft Power Automate service has been out of order.
Microsoft Power Automate Service Outage in Hourshours
office365_microsoftflowm365_ServiceOutageInHours

Length of time that the Microsoft Power Automate in Microsoft 365 service has been out of order.
Microsoft Power Automate in Microsoft 365 Service Outage in Hourshours
office365_microsoftteams_ServiceOutageInHours

Length of time that the Microsoft Teams service has been out of order.
Microsoft Teams Service Outage in Hourshours
office365_mobiledevicemanagement_ServiceOutageInHours

Length of time that the Mobile Device Management service has been out of order.
Mobile Device Management for Office 365 Service Outage in Hourshours
office365_o365client_ServiceOutageInHours

Length of time that the Microsoft 365 Apps service has been out of order.
Microsoft 365 Apps Service Outage in Hourshours
office365_officeonline_ServiceOutageInHours

Length of time that the Office for the web service has been out of order.
Office for the web Service Outage in Hourshours
office365_onedriveforbusiness_ServiceOutageInHours

Length of time that the OneDrive for Business service has been out of order.
OneDrive for Business Service Outage in Hourshours
office365_orgliveid_ServiceOutageInHours

Length of time that the Identity Service has been out of order.
Identity Service Service Outage in Hourshours
office365_osdpplatform_ServiceOutageInHours

Length of time that the Microsoft 365 suite service has been out of order.
Microsoft 365 suite Service Outage in Hourshours
office365_planner_ServiceOutageInHours

Length of time that the Planner service has been out of order.
Planner Service Outage in Hourshours
office365_powerapps_ServiceOutageInHours

Length of time that the Power Apps service has been out of order.
Power Apps Service Outage in Hourshours
office365_powerappsm365_ServiceOutageInHours

Length of time that the Power Apps in Microsoft 365 service has been out of order.
Power Apps in Microsoft 365 Service Outage in Hourshours
office365_powerbicom_ServiceOutageInHours

Length of time that the Power BI service has been out of order.
Power BI Service Outage in Hourshours
office365_projectfortheweb_ServiceOutageInHours

Length of time that the Project for the web service has been out of order.
Project for the web Service Outage in Hourshours
office365_projectonline_ServiceOutageInHours

Length of time that the Project Online service has been out of order.
Project Online Service Outage in Hourshours
office365_rms_ServiceOutageInHours

Length of time that the Azure Information Protection service has been out of order.
Azure Information Protection Service Outage in Hourshours
office365_sharepoint_ServiceOutageInHours

Length of time that the Sharepoint Online service has been out of order.
Sharepoint Online Service Outage in Hourshours
office365_staffhub_ServiceOutageInHours

Length of time that the Microsoft Staffhub service has been out of order.
Microsoft Staffhub Service Outage in Hourshours
office365_stream_ServiceOutageInHours

Length of time that the Microsoft Stream service has been out of order.
Microsoft Stream Service Outage in Hourshours
office365_swayenterprise_ServiceOutageInHours

Length of time that the Sway service has been out of order.
Sway Service Outage in Hourshours
office365_viva_ServiceOutageInHours

Length of time that the Microsoft Viva service has been out of order.
Microsoft Viva Service Outage in Hourshours
office365_yammer_ServiceOutageInHours

Length of time that the Yammer service has been out of order.
Yammer Enterprise Service Outage in Hourshours