Aller au contenu principal

Office365 Exchange

Vue d'ensemble​

La suite Microsoft Office 365 comprend Exchange Online, la version hébergée de la plateforme de messagerie Exchange Server de Microsoft.

Les informations de supervision de la suite Office sont mises Ă  disposition par Microsoft au travers d'une API de gestion Office 365.

Les données mises à disposition par l'API de gestion Office 365 ne sont pas en temps réel et sont basées sur une période de 7 jours

Contenu du connecteur de supervision​

Objets supervisés​

  • ActivitĂ© Mail
  • Utilisation des boites mail

Métriques collectées​

Plus d'informations sur les métriques collectées sur la documentation officielle de Microsoft :

Metric nameDescription
active_usersNumber of active users
exchange.users.emails.sent.total.countNumber of total sent mails
exchange.users.emails.received.total.countNumber of total received mails
exchange.users.emails.read.total.countNumber of total read mails

Une fois l'hôte crée, les macros de services peuvent être configurées pour filtrer les métriques par utilisateurs ou par boites mail. Plus d'informations dans la section Configuration.

Prérequis​

Si vous n'avez pas encore créé votre compte sous Office 365, reportez-vous à la documentation d'Office 365 Management ou suivez le lien dans la partie 'Aide supplémentaire'.

Enregistrez une application​

Les API de gestion Office 365 utilisent Azure AD pour assurer l’authentification sécurisée des données dans Office 365. Pour accéder aux API de gestion Office 365, vous devez enregistrer votre application dans Azure AD. Le terme Application est utilisé comme concept, faisant référence non seulement au programme d’application, mais également à son inscription Azure AD et à son rôle lors des « dialogues » d’authentification/autorisation au moment de l’exécution. (https://docs.microsoft.com/fr-fr/azure/active-directory/develop/app-objects-and-service-principals)

Spécifiez les autorisations dont votre application a besoin pour accéder aux API de gestion Office 365​

Afin de récupérer les données d'Exchange Online, vous devez spécifier les autorisations que votre application requiert: dans le Portail de gestion Azure :

  • Microsoft Graph :
    • Reports.Read.All (Type : Application)
    • User.Read (Type : Delegated)
  • Office365 Management APIs :
    • ServiceHealth.Read (Type : Application)
    • ActivityFeed.Read (Type : Application)

Aide supplémentaire​

Suivez le guide pratique pour obtenir une explication complète sur la façon d’enregistrer une demande et d’obtenir un ID client et un ID secret : https://docs.microsoft.com/fr-fr/office/office-365-management-api/get-started-with-office-365-management-apis

Installation​

Pack de supervision​

Si la plateforme est configurée avec une licence online, l'installation d'un paquet n'est pas requise pour voir apparaître le pack dans le menu Configuration > Gestionnaire de connecteurs de supervision.

Au contraire, si la plateforme utilise une licence offline, installez le paquet sur le serveur central via la commande correspondant au gestionnaire de paquet associé à sa distribution :

dnf install centreon-pack-cloud-microsoft-office365-exchange

Quel que soit le type de la licence (online ou offline), installez le Pack Office365 Exchange depuis l'interface web et le menu Configuration > Gestionnaire de connecteurs de supervision.

Plugin​

À partir de Centreon 22.04, il est possible de demander le déploiement automatique du plugin lors de l'utilisation d'un pack. Si cette fonctionnalité est activée, et que vous ne souhaitez pas découvrir des éléments pour la première fois, alors cette étape n'est pas requise.

Plus d'informations dans la section Installer le plugin.

Utilisez les commandes ci-dessous en fonction du gestionnaire de paquets de votre système d'exploitation :

dnf install centreon-plugin-Cloud-Microsoft-Office365-Exchange-Api

Configuration​

Lors de la création de votre Hôte dans Centreon, choisissez le modèle Cloud-Microsoft-Office365-Exchange-Api-custom. Une fois celui-ci appliqué, certaines Macros liées à l'Hôte doivent être renseignées :

MandatoryNameDescription
XOFFICE365CUSTOMMODEAccess mode for the Plugin (default: 'graphapi')
XOFFICE365TENANTTenant-id of your Office 365 organization
XOFFICE365CLIENTIDClient-id of your registered application
XOFFICE365CLIENTSECRETSecret-if of your registered application
OFFICE365EXTRAOPTIONSAny extra option you may want to add to the command (eg. a --verbose flag)

La métrique perfdate enrengistre la date à laquelle celle-ci a été collectée. Vous pouvez la filter en paramétrant la macro OFFICE365EXTRAOPTIONS avec l'option --filter-perfdata='^(?!.*perfdate).*$'

Une fois l'hôte créé, il est également possible de paramétrer un ensemble de Macros de Service selon la configuration souhaitée:

MandatoryNameDescription
FILTERUSERFilter specific users
FILTERMAILBOXFilter specific mailboxes
FILTERCOUNTERFilter specific counters (default:'active|total')

FAQ​

Comment tester le Plugin Office 365 Exchange en ligne de commande et que signifient les options principales ?​

Une fois le Plugin installé, vous pouvez tester directement celui-ci en ligne de commande depuis votre collecteur Centreon avec l'utilisateur centreon-engine :

/usr/lib/centreon/plugins//centreon_office365_exchange_api.pl \
--plugin=cloud::microsoft::office365::exchange::plugin \
--mode=email-activity \
--tenant='abcd1234-5678-90ab-cd12-34567890abcd' \
--client-id='9876dcba-5432-10dc-ba98-76543210dcba' \
--client-secret='8/RON4vUGhAcg6DRmSxc4AwgxSRoNfKg4d8xNizIMnwg='

RĂ©sultat attentdu :

OK: Active mailboxes on 2019-03-10 : 141/1532 (9.20%) - Total (active mailboxes) 
Send Count: 9478, Receive Count: 62197, Read Count: 24401 |
'active_mailboxes'=141mailboxes;;;0;1532
'total_send_count'=9478;;;0;
'total_receive_count'=62197;;;0;
'total_read_count'=24401;;;0;

Les options des différents modes sont consultables via le paramètre --help du mode :

/usr/lib/centreon/plugins//centreon_office365_exchange_api.pl \
--plugin=cloud::microsoft::office365::exchange::plugin \
--mode=email-activity \
--custommode='graphapi'\
--help

Tous les modes disponibles dans le Plugin peuvent être listés via la commande suivante :

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

Diagnostic des erreurs communes​

Référez-vous à la documentation dédiée au dépannage des plugins basés sur HTTP/API.