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 Alias | Service Template | Service Description | Default |
|---|---|---|---|
| Directory-Quota | Cloud-Microsoft-Office365-AzureAD-Directory-Quota-Api | Check Azure AD Directory Quota usage | X |
Collected metrics & status
- Directory-Quota
| Metric Name | Unit |
|---|---|
| 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
- Online License
- Offline License
- Install the package on every Centreon poller expected to monitor Azure AD resources:
yum install centreon-plugin-Cloud-Microsoft-Office365-AzureAD-Api
- On the Centreon web interface, on page Configuration > Monitoring Connectors Manager, install the Office 365 Azure AD Centreon Monitoring Connector.
- Install the package on every Centreon poller expected to monitor Azure AD resources:
yum install centreon-plugin-Cloud-Microsoft-Office365-AzureAD-Api
- Install the Office 365 Azure AD Centreon Monitoring Connector RPM on the Centreon central server:
yum install centreon-pack-cloud-microsoft-office365-azuread
- On the Centreon web interface, on page Configuration > Monitoring Connectors 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.
| Mandatory | Macro | Description |
|---|---|---|
| x | OFFICE365CLIENTID | |
| x | OFFICE365CLIENTSECRET | |
| OFFICE365EXTRAOPTIONS | Any extra option you may want to add to every command line (eg. a --verbose flag) | |
| x | OFFICE365TENANT |
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.