Microsoft 365 Platform Monitoring

Community MKP for monitoring Microsoft 365 with Checkmk.

This package provides three independently configurable special agents for Microsoft 365 monitoring:

• Microsoft Graph for service health, incidents, licensing, usage reports and Teams call quality
• Exchange Online PowerShell for Exchange Online configuration and drift monitoring
• PnP.PowerShell for SharePoint Online tenant and site configuration drift monitoring

The integrations use Entra ID app-only authentication. Exchange Online and SharePoint Online use certificate-based authentication.

What you get

• Microsoft 365 service health and active issue monitoring
• Microsoft 365 licensing and subscription monitoring
• Microsoft 365 usage and activity reports
• Teams activity, device usage and call-quality monitoring
• Exchange Online organization and transport configuration monitoring
• Optional Exchange mailbox, user, role, policy and device configuration monitoring
• SharePoint Online tenant and site configuration monitoring
• Configuration-drift detection for Exchange Online and SharePoint Online
• Configurable WARN/CRIT states and thresholds through Checkmk rules
• High-cardinality checks such as per-user, per-mailbox and per-site monitoring can be enabled selectively.

Requirements

• Checkmk 2.5
• Microsoft Entra application registration with the required permissions
• Network access from the Checkmk server to Microsoft 365 APIs
• PowerShell 7.6+ for Exchange Online and SharePoint Online monitoring
• ExchangeOnlineManagement PowerShell module for Exchange Online
• PnP.PowerShell module for SharePoint Online
• Password-protected PFX certificate for certificate-based authentication

The PowerShell modules can be installed directly as the Checkmk OMD site user with -Scope CurrentUser.

Microsoft Graph monitoring does not require PowerShell modules.

Installation

Install the MKP using mkp add / mkp enable, or via Setup > Extension packages.

After installation, configure one or more of the following special-agent rules:

• Microsoft 365 via Microsoft Graph
• Microsoft 365 Exchange Online via PowerShell
• Microsoft 365 SharePoint Online via PnP PowerShell

Secrets and PFX passwords can be stored in the Checkmk password store.