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.

ConnecteurCe qu'il surveilleServices documentés
Office 365 Managementétat des services, licences, expiration des identifiants d'applicationService-Status, Subscriptions, App-Credentials
Office365 Exchangeactivité des boîtes aux lettresEmail-Activity, Users-Activity-Exchange
Office365 Teamsactivité et appareils TeamsUsers-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 :

  1. Connectez-vous au centre d'administration Microsoft Entra avec au moins le rôle de développeur d'applications.
  2. Ouvrez Entra ID > Inscriptions d'application, puis Nouvelle inscription.
  3. Donnez un nom explicite, par exemple centreon-supervision, et choisissez Locataire unique, que Microsoft recommande pour la plupart des applications.
  4. 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 :

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 MicrosoftConséquence pour la supervision
La valeur du secret ne s'affiche plus une fois la page quittéecopiez-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ésla supervision s'arrêtera à l'échéance si personne ne le renouvelle
Un certificat est recommandé plutôt qu'un secret en productionles 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 :

MacroValeur à saisir
OFFICE365CLIENTIDl'ID d'application (client)
OFFICE365CLIENTSECRETla valeur du secret client
OFFICE365TENANTl'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 :

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.