Skip to main content

Office 365 Azure AD

Pack Assets​

Templates​

The Centreon Monitoring Connector Office 365 Azure AD brings a host template:

  • Cloud-Microsoft-Office365-AzureAD-Api-custom

It brings the following service template:

Service AliasService TemplateService DescriptionDefault
Directory-QuotaCloud-Microsoft-Office365-AzureAD-Directory-Quota-ApiCheck Azure AD Directory Quota usageX

Collected metrics & status​

Metric NameUnit
azure.ad.directory.usage.count

Prerequisites​

Register an application​

Refer to the documentation available here to register your application.

Office365 Management API authorization​

To collect data from OneDrive Online, you need to specify the following authorization:

  • Microsoft Graph :
    • Organization.Read.All
    • Directory.Read.All

Check out the endpoint documentation here. It describes the required privileges to obtain information about the organization directory quota.

Setup​

  1. Install the package on every Centreon poller expected to monitor Azure AD resources:
yum install centreon-plugin-Cloud-Microsoft-Office365-AzureAD-Api
  1. On the Centreon web interface, on page Configuration > Monitoring Connector Manager, install the Office 365 Azure AD Centreon Monitoring Connector.

Configuration​

Host​

  • Log into Centreon and add a new host through Configuration > Hosts.
  • Fill the Name, Alias & IP Address/DNS fields according to your Azure AD server settings.
  • Apply the Cloud-Microsoft-Office365-AzureAD-Api-custom template to the host.
  • Once the template is applied, fill in the corresponding macros. Some macros are mandatory.
MandatoryMacroDescription
xOFFICE365CLIENTID
xOFFICE365CLIENTSECRET
OFFICE365EXTRAOPTIONSAny extra option you may want to add to every command line (eg. a --verbose flag)
xOFFICE365TENANT

How to check in the CLI that the configuration is OK and what are the main options for?​

Once the plugin is installed, log into your Centreon poller's CLI using the centreon-engine user account (su - centreon-engine) and test the plugin by running the following command:

/usr/lib/centreon/plugins//centreon_office365_azauread_api.pl \
    --plugin=cloud::microsoft::office365::azuread::plugin \
    --mode=directory-size-usage \
    --tenant='abcd1234-5678-90ab-cd12-34567890abcd' \
    --client-id='9876dcba-5432-10dc-ba98-76543210dcba' \
    --client-secret='8/RON4vUGhAcg6DRmSxc4AwgxSRoNfKg4d8xNizIMnwg=' \
    --warning-usage='90' \
    --critical-usage='95' \
    --units='%' \
    --verbose \
    --use-new-perfdata

The expected command output is shown below:

OK: Directory size usage : 265079/309000 (85.79%) | 'azure.ad.directory.usage.count'=265079;0:278100;0:293550;0;309000

All available options for a given mode can be displayed by adding the --help parameter to the command:

/usr/lib/centreon/plugins//centreon_office365_azauread_api.pl \
    --plugin=cloud::microsoft::office365::azuread::plugin \
    --mode=directory-size-usage \
    --help

All available modes can be displayed by adding the --list-mode parameter to the command:

/usr/lib/centreon/plugins//centreon_office365_azauread_api.pl \
    --plugin=cloud::microsoft::office365::azuread::plugin \
    --list-mode

Troubleshooting​

Please find the troubleshooting documentation for Centreon Plugins typical issues.