Documentation forServer & Application Monitor

Integrate Office 365 application monitor templates with Microsoft Graph in SAM

To use one of the following SAM application monitor templates, you'll need to add a PSMSGraph PowerShell module on the Orion server so PowerShell scripts can communicate with the Microsoft Graph API:

For tips on setting up templates, see this Success Center article. You can also use API poller templates to monitor Microsoft 365, formerly called Office 365. See the SAM API Poller Template Guide.

For details about Microsoft Graph, which offers a single REST API endpoint for Microsoft 365 services, see:

Requirements

  • Assign one of the Microsoft Office 365 templates listed above to a node. Review requirements for each templates and refer to Assign a template to a node.
  • Install and configure the PSMSGraph PowerShell module on the Orion server, as described next.
  • Register PSMSGraph as an Azure Active Directory (AD) app in Azure with the following permissions:
    • Reports.Read.All (Delegated)
    • Reports.Read.All (Applications)
  • While registering PSMSGraph in Azure, gather the following details to pass as arguments for component monitors:
    • App name
    • Client ID/Application ID
    • Tenant ID
    • Password

    Starting in SAM 2020.2.5, apiversion=v1.0 is required in PowerShell scripts for Microsoft Office 365 Teams and Microsoft Office 365 OneDrive application monitor templates, including related application monitors. Otherwise, scripts return [ERROR] The remote server returned an error: (404) Not Found. messages. Alternatively, use a Microsoft 365 API poller templates.

Set up the PSMSGraph module on the Orion server

The SAM templates listed at the beginning of this topic use the PSMSGraph module to access to the Graph API. To install and configure the PSMSGraph module on the Orion server:

  1. Obtain PSMSGraph from either of the following websites and install it.
  2. Verify the module is installed correctly.
    1. In the PowerShell console, type: Get-Module -ListAvailable -Name "psmsgraph"
    2. Compare the output to the following screenshot; it should be similar.

Register the app

To provide SAM application monitor templates with access to the Graph API, register the PSMSGraph module as an Azure AD app in the Microsoft Azure portal with the following permissions:

  • Reports.Read.All (Delegated)
  • Reports.Read.All (Applications)

When creating apps, use a recognizable name, such as "SAM Microsoft 365 Graph".

An Azure AD admin must authorize the endpoint before SAM can access the API.

To learn more, see these Microsoft resources:

All Microsoft links in this topic are © 2019 Microsoft Corp., available at https://docs.microsoft.com, obtained on May 8, 2019.