Supervision Office 365 et Microsoft 365 avec Centreon
Un service cloud ne se supervise ni en SNMP ni avec un agent : Centreon interroge les API de Microsoft avec une application inscrite dans votre locataire. Ce qui compte, ce sont les droits accordés à cette application et la date d'expiration de son secret.
Les services que l'on appelait Office 365 sont aujourd'hui présentés par Microsoft sous le nom Microsoft 365 : la page d'état des services du centre d'administration parle de « l'intégrité du service Microsoft 365 » et liste notamment Exchange Online, Microsoft Teams et Office sur le Web. Centreon a gardé l'ancien nom dans ses connecteurs de supervision (monitoring connectors, nommés Plugin Packs jusqu'en avril 2023) : cherchez « Office 365 » dans le catalogue.
Votre serveur Centreon ne voit pas les serveurs de Microsoft. Il ne peut donc superviser que ce que Microsoft expose par API : l'état de santé de chaque service, les abonnements et licences, l'activité des utilisateurs. La documentation Centreon indique que la sonde s'appuie sur l'API Microsoft Graph pour collecter ces informations.
Testez d'abord sur un locataire de test si vous en avez un, et notez chaque droit accordé : une application inscrite dans Entra ID est un accès permanent à votre locataire.
Les connecteurs Office 365 de Centreon
Le catalogue en propose plusieurs, un par périmètre. Celui qui sert de point de départ est Office 365 Management.
| Connecteur | Ce qu'il surveille | Services documentés |
|---|---|---|
| Office 365 Management | état des services, licences, expiration des identifiants d'application | Service-Status, Subscriptions, App-Credentials |
| Office365 Exchange | activité des boîtes aux lettres | Email-Activity, Users-Activity-Exchange |
| Office365 Teams | activité et appareils Teams | Users-Activity-Teams, Devices-Usage-Teams |
D'autres connecteurs existent pour SharePoint, OneDrive et Azure AD sur le même principe. Pour comprendre comment Centreon organise modèles d'hôte, modèles de service et sondes, voyez la supervision avec Centreon et ses connecteurs. Pour un serveur Exchange installé chez vous, la méthode est différente : c'est l'objet de la supervision d'Exchange avec NSClient++.
Préparer le locataire Microsoft 365
Inscrire une application dans Microsoft Entra ID
La documentation Centreon décrit encore l'inscription dans l'ancien portail Azure AD. La procédure actuelle, selon Microsoft Learn, se fait dans le centre d'administration Microsoft Entra :
- Connectez-vous au centre d'administration Microsoft Entra avec au moins le rôle de développeur d'applications.
- Ouvrez Entra ID > Inscriptions d'application, puis Nouvelle inscription.
- Donnez un nom explicite, par exemple
centreon-supervision, et choisissez Locataire unique, que Microsoft recommande pour la plupart des applications. - Sélectionnez Inscrire. Sur la page Vue d'ensemble, relevez l'ID d'application (client) et l'ID du locataire.
Accorder les droits Microsoft Graph
Centreon liste pour le connecteur Management les autorisations Microsoft Graph suivantes, à accorder en type Application :
ServiceMessage.Read.AlletServiceHealth.Read.Allpour l'état des services ;Reports.Read.Allpour les rapports d'usage ;Directory.Read.All,User.Read.AlletApplication.Read.Allpour les licences et les identifiants d'application.
Microsoft confirme que ServiceHealth.Read.All est l'autorisation requise, en type Application, pour lire la vue d'ensemble de l'intégrité des services. Les connecteurs Exchange et Teams demandent de leur côté Reports.Read.All dans Graph et des droits sur les Office 365 Management APIs (ServiceHealth.Read, ActivityFeed.Read). N'accordez que ce que vos services utilisent, puis faites donner le consentement administrateur.
Créer le secret client
Dans Certificats et secrets > Secrets client, créez un nouveau secret. Microsoft précise trois points :
| Règle Microsoft | Conséquence pour la supervision |
|---|---|
| La valeur du secret ne s'affiche plus une fois la page quittée | copiez-la immédiatement dans un coffre de mots de passe |
| Durée de vie limitée à 24 mois au maximum, moins de 12 mois recommandés | la supervision s'arrêtera à l'échéance si personne ne le renouvelle |
| Un certificat est recommandé plutôt qu'un secret en production | les macros Centreon documentées n'attendent qu'un secret : pesez ce choix |
C'est précisément la raison d'être du service App-Credentials : il surveille l'expiration des mots de passe et clés des applications du locataire, y compris celle de Centreon.
Configurer Centreon
Installez le connecteur depuis Configuration > Connectors > Monitoring Connectors. Avec une licence hors ligne, le paquet s'installe d'abord sur le serveur central :
dnf install centreon-pack-cloud-microsoft-office365-management
Si l'installation automatique des sondes, disponible depuis Centreon 22.04, est désactivée, installez la sonde sur le collecteur :
dnf install centreon-plugin-Cloud-Microsoft-Office365-Management-Api
Créez ensuite un hôte (par exemple m365-lab) dans Configuration > Hosts et appliquez le modèle Cloud-Microsoft-Office365-Management-Api-custom. Trois macros sont obligatoires :
| Macro | Valeur à saisir |
|---|---|
OFFICE365CLIENTID | l'ID d'application (client) |
OFFICE365CLIENTSECRET | la valeur du secret client |
OFFICE365TENANT | l'ID du locataire |
Le service Service-Status est créé avec le modèle d'hôte. Subscriptions et App-Credentials ne le sont pas : ajoutez-les manuellement en leur appliquant leur modèle de service.
Le collecteur doit pouvoir sortir en HTTPS. Par défaut, la sonde s'authentifie sur https://login.microsoftonline.com et interroge https://graph.microsoft.com ; si votre réseau impose un proxy, l'option --proxyurl se place dans la macro d'options supplémentaires.
Vérifier depuis le collecteur
Sous le compte centreon-engine, la documentation propose ce test du mode subscriptions :
/usr/lib/centreon/plugins/centreon_office365_management_api.pl \
--plugin=cloud::microsoft::office365::management::plugin \
--mode=subscriptions \
--tenant='<id-du-locataire>' \
--client-id='<id-application>' \
--client-secret='<secret-client>' \
--verbose
Un résultat commençant par OK: montre que l'authentification et les droits sont corrects. Une erreur d'authentification vise l'ID ou le secret ; une erreur d'autorisation signale un droit Graph manquant ou un consentement non donné.
Choisir les seuils
Les valeurs par défaut documentées sont des conditions d'état, pas des chiffres :
- Service-Status passe en critique quand l'état n'est ni
serviceOperationalniserviceRestored, et exclut par défaut les incidents résolus (EXCLUDERESOLVEDà1). Filtrez avecFILTERSERVICENAMEles services que vous n'utilisez pas, sans quoi un incident Dynamics 365 réveillera une équipe qui n'en a pas. - Subscriptions passe en alerte quand l'état d'un abonnement contient
warning. Les seuils d'usage des licences sont vides : réglez-les sur le délai qu'il vous faut pour en commander. - App-Credentials passe en critique quand un identifiant est expiré. Ajoutez un seuil d'alerte sur le délai avant expiration, assez long pour couvrir votre circuit de validation.
Si vous hésitez encore entre deux outils pour ce type de supervision, le comparatif Zabbix et Centreon pose les critères. Les autres tutoriels sont regroupés dans la rubrique Centreon.
Questions fréquentes
Centreon peut-il superviser Microsoft 365 sans agent ?
Oui. Rien n'est installé chez Microsoft : la sonde, exécutée sur le collecteur, interroge les API Microsoft avec une application inscrite dans votre locataire Entra ID et les droits que vous lui avez accordés.
Quels droits donner à l'application Centreon ?
Pour le connecteur Office 365 Management, Centreon liste six autorisations Microsoft Graph de type Application, dont ServiceHealth.Read.All et Reports.Read.All. Accordez seulement celles des services que vous activez, puis donnez le consentement administrateur.
Pourquoi la supervision Office 365 s'arrête-t-elle au bout de quelques mois ?
Le plus souvent parce que le secret client a expiré. Microsoft limite sa durée de vie à 24 mois et recommande moins de 12 mois. Le service App-Credentials sert à être prévenu avant l'échéance.
Office 365 et Microsoft 365, est-ce la même chose pour Centreon ?
Oui pour la supervision. Microsoft présente aujourd'hui ces services sous le nom Microsoft 365, tandis que les connecteurs Centreon s'appellent toujours Office 365. Ils interrogent les mêmes API.
Le collecteur a-t-il besoin d'un accès Internet ?
Oui, en HTTPS sortant. Par défaut, la sonde s'authentifie sur login.microsoftonline.com et interroge graph.microsoft.com. Un proxy peut être déclaré avec l'option --proxyurl.