Support Center

To better serve you during these uncertain times, we will be hosting a weekly support webinar. We’ll cover topics like LogicMonitor admin basics as well as ways to monitor a remote work environment. Tune in every Wednesday at 11:00am PST.

Sign up here

To better serve you during these uncertain times, we will be hosting a weekly support webinar. We’ll cover topics like LogicMonitor admin basics as well as ways to monitor a remote work environment. Tune in every Wednesday at 11:00am PST.

Sign up here

Overview

Microsoft ​​Office 365 is a line of cloud-based software offered by Microsoft as part of the Microsoft Office product line. LogicMonitor offers out-of-the-box monitoring for Office 365. With LogicMonitor’s Office 365 package, you can monitor the state of your Microsoft Office 365 deployment and the underlying services and license usage, allowing you to quickly identify faults and manage performance and license utilization accordingly.

Note: LogicMonitor also offers monitoring for the Microsoft Exchange server. See Microsoft Exchange Monitoring for more information.

Setup Requirements

Add Resource Into Monitoring

Add your Microsoft Office 365 host into monitoring. As cloud-based software, there is no physical resource to add into monitoring so simply create a new resource with “outlook.office.com” as the IP address/DNS name. Be sure to assign a Windows-based Collector or Collector group to the resource. For more information on manually adding resources into monitoring, see Adding Devices.

Create Credentials for Office 365

LogicMonitor must provide the appropriate credentials in order to successfully access Office 365. These credentials must belong to an Office 365 user account with global admin access (the account does not require any licenses). The following roles are required:

  • Reports reader
  • Message Center reader
  • Message Center Privacy reader

For more information on adding users, see Microsoft’s Office 365 documentation.

Once the user account is created, log into Microsoft’s Exchange Admin Center and add the new user to the “View-Only Organization Management” Exchange role.

Additionally, enter the username and password associated with the new account as properties on the Microsoft Office 365 resource you created within LogicMonitor. As discussed in the Assign Properties to Resource section of this support article, the properties that carry these values are office365.user and office365.pass.

Configure PowerShell

LogicMonitor initiates remote PowerShell sessions to retrieve data from Office 365. There are two PowerShell modules that need to be installed on the Windows Collector host (or hosts if you are monitoring using an Auto-Balanced Collector Group or have a backup Collector) that is associated with your Office 365 resource in LogicMonitor:

Ensure that your Collector(s) can run PowerShell scripts by setting the execution policy to RemoteSigned on the Collector host(s):

Set-ExecutionPolicy RemoteSigned

Set Up Microsoft Graph API

LogicMonitor uses the reports API in Microsoft Graph to collect Office 365 usage data. For more information on Microsoft Graph, see Microsoft Graph documentation.

Follow these steps to register and authorize a new application to call the reports API:

  1. Log into the Azure portal using an administrator account.
  2. Navigate to Enterprise Applications under Azure Active Directory. Click + New Application.
  3. From the Add an application dialog, select “Application you’re developing”.
  4. From the App registrations dialog, click + New registration.
  5. Provide a meaningful name for the application.
  6. Leave all other settings as they are and click Register.
  7. On the Overview page for the new application, locate the following:
    • Application (client) ID. Create a property on the LogicMonitor host named office365.clientid and enter this ID as the property value. (For more information on assigning properties, see the Assign Properties to Resource section of this support article.)
    • Directory (tenant) ID. Create a property on the LogicMonitor host named office365.tenantid and enter this ID as the property value.

      Capturing the clientid and tenantid values

  8. Open the Open the Authentication page for the new application and perform the following steps:
    1. Click + Add a platform to allow access tokens for a web application.

      Authentication page
    2. From the Configure platforms dialog that displays, select “Web”.
    3. On the following Configure Web dialog, enter your LogicMonitor portal URL as the redirect URI.
    4. Check the Access tokens option.
  9. Open the Certificates & secrets page for the new application and perform the following steps:
    1. Click + New client secret and provide a description.
    2. Immediately copy your new client secret value (you will not be able to view it again).
    3. Create a property on the LogicMonitor host named office365.clientsecret.pass and enter the client secret as the property value.
  10. Open the API permissions page for the new application and perform the following steps:
    1. Click + Add a permission.
    2. When the drawer from the right appears, select “Microsoft Graph” and then “Application Permissions”.
    3. Under the Reports heading, check the Reports.Read.All option.
    4. Click Grant admin consent for <domain>.
    5. When finished, two green checkmarks will display confirming that consent has been granted.

Assign Properties to Resource

The following custom properties must be set on the Microsoft Office 365 resource within LogicMonitor. For more information on setting properties, see Resource and Instance Properties.

Note: If you’ve performed the setup requirements in the previous sections, several of these properties will already be present.

Property

Value

office365.clientid The “Application (client) ID” used for Microsoft Graph report retrieval from the reports API. See the Set Up Microsoft Graph API section for details on obtaining this ID.
office365.clientsecret.pass The client secret used for Microsoft Graph report retrieval from the reports API. See the Set Up Microsoft Graph API section for details on obtaining this secret.
office365.tenantid The “Directory (tenant) ID” used for Microsoft Graph report retrieval from the reports API. See the Set Up Microsoft Graph API section for details on obtaining this ID.
office365.tenantname The tenant name used for Microsoft Graph report retrieval from the reports API (example: <customer name>.onmicrosoft.com)
office365.user Username for the Office 365 admin account used to access Office 365 data (example: [email protected]<customer name>.onmicrosoft.com). See the Create Credentials for Office 365 section for details on creating this account.
office365.pass Password for the Office 365 admin account used to access Office 365 data. See the Create Credentials for Office 365 section for details on creating this account.
office365.spoadminsite The customer name portion of the URL of the SharePoint admin center. For example, if the SharePoint URL is “westbeachservices-admin.sharepoint.com”, the value of this property would be “westbeachservices”.

Import LogicModules

From the LogicMonitor repository, import all Microsoft Office 365 LogicModules, which are listed in the LogicModules in Package section of this support article. If these LogicModules are already present, ensure you have the most recent version.

Once the LogicModules are imported (assuming all previous setup requirements have been met), the PropertySources will automatically detect the host and assign the appropriate values to the system.categories property. This, in turn, will automatically associate the DataSources (and ConfigSources if supported by your LogicMonitor account) and data monitoring will begin.

LogicModules in Package

LogicMonitor’s package for Microsoft Office 365 consists of the following LogicModules. For full coverage, please ensure that all of these LogicModules are imported into your LogicMonitor platform.

Note: The package includes ConfigSources (configuration file monitoring), which are only available to customers that are using the LM Config add-on feature. For more information on ConfigSources, see Creating ConfigSources.

Display Name

Type

Description

addCategory_Office365 PropertySource Identifies if the Office 365 host is configured for Office365 monitoring and, if it is, adds the value of “Office365” to the system.categories property.
addCategory_Office365Reports PropertySource Identifies if the Office 365 host is configured properly to retrieve Graph reports and, if it is, adds the value of “Office365Reports” to the system.categories property.
Exchange Online: Mailbox Statistics DataSource Monitors Exchange Online mailbox statistics.
Microsoft Teams: Device Usage DataSource Monitors the last seven days of Microsoft Teams device usage by number of users.
Microsoft Teams: User Activity DataSource Monitors the last seven days of Microsoft Teams activity.
Office 365 License DataSource Monitors Office 365 license usage.
OneDrive: File Counts DataSource Monitors OneDrive total and active files, as well as the time since the report was last updated.
OneDrive: Storage Used DataSource Monitors OneDrive total storage used.
OneDrive: User Activity DataSource Monitors OneDrive user activity metrics.
Outlook: Email Activity DataSource Monitors Outlook total and rate counts for read, received and sent emails.
Services: User Activity DataSource Monitors individual Office365 services and their associated user activity.
SharePoint Online: Site Status DataSource Monitors the overall status of the SharePoint site.
SharePoint Online: Site Usage DataSource Monitors SharePoint site usage metrics such as page views, file count, file usage, storage, etc.
Skype for Business: User Activity Detail DataSource Monitors Office 365 Skype for Business user activity metrics.
User Activity Details DataSource Monitors individual Office365 services and their associated user activity.
Yammer: Device Usage DataSource Monitors Yammer usage by device type.
SharePoint Online: Tenant Config ConfigSource Captures SharePoint Online organization-level tenant config.
Exchange Online: Groups ConfigSource Monitors the config group objects. Returns security groups, mail-enabled security groups, distribution groups, and role groups.
Exchange Online: Mailboxes ConfigSource Monitors the Exchange mailbox configs.
Exchange Online: Management Roles ConfigSource Monitors the Exchange management role objects in your organization.
Exchange Online: Mobile Device Mailbox Policy ConfigSource Monitors Exchange mobile device mailbox policy config.
Exchange Online: Mobile Devices ConfigSource Monitors Exchange mobile device config for identification, configuration, and status information for each mobile device.
Exchange Online: Organization ConfigSource Monitors Exchange organization config.
Exchange Online: OWA Mailbox Policy ConfigSource Monitors Exchange Outlook on the web mailbox policies in the organization.
Exchange Online: Transport Config ConfigSource Monitors Exchange organization-wide transport configuration settings.
Exchange Online: Users ConfigSource Monitors Exchange users in your organization.

When setting static datapoint thresholds on the various metrics tracked by this package’s DataSources, LogicMonitor follows the technology owner’s best practice KPI recommendations. If necessary, we encourage you to adjust these predefined thresholds to meet the unique needs of your environment. For more information on tuning datapoint thresholds, see Tuning Static Thresholds for Datapoints.

In this Article: