Microsoft 365

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

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:

   

3. Select + New Registration.

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

   

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:

   

Step 2: Configure API permissions

Add a Microsoft Graph permission in the left navigation panel, click API permissions to add new permissions for the Microsoft Graph APIs:

Add a Microsoft Graph permission

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

   

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

   

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

   

4. Select the following permissions:

   Permission	Description
   User.Read.All	Permits 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.All	Permits 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.
   ServiceHealth.Read.All	Permits the application to read your tenant's service health information, without a signed-in user. Health information may include service issues or service health overviews.

5. Go to the API Permissions page and grant permission for all configured permissions by selecting Grant admin consent for xyz:

   

Add a client secret

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

   

2. Select + New client secret.

   

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

   

4. Click Add.

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

   

Step 3: Configure the integration

1. From All Clients, select a client.

2. Go to Setup > Integrations and Apps. If there are already installed apps, it will redirect to the INSTALLED APPS page where all the installed apps are displayed. Click +ADD and search for the App on the Available apps page.

   

If there are no installed apps, it will navigate to the AVAILABLE APPS page.

Use the search option available to search for Office365 application. Alternatively, use All Categories dropdown to search. In this case, select Saas Application. All SAAS apps are displayed.
Note: The search option is used to search for apps on a page.

3. Click ADD under Office365:

   

4. In Add OFFICE365 page, enter account information:

   

   Property	Description
   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) Re Enter the Security Key.

5. Click Next.In the RESOURCE TYPE section, select:

   • ALL: All the existing and future resources will be discovered.
   • SELECT: You can select one or multiple resources to be discovered.

6. In the DISCOVERY SCHEDULE section, select Recurrence Pattern to add one of the following patterns:

   • Minutes
   • Hourly
   • Daily
   • Weekly
   • Monthly

     

7. Click Finish.
   The application is now installed and displayed on the Installed Integration page. Use the search field to find the installed application.

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