Aller au contenu principal

Office 365 Azure AD

Contenu du Pack​

Modèles​

Le connecteur de supervision Centreon Office 365 Azure AD apporte un modèle d'hôte :

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

Il apporte le modèle de service suivant :

AliasModèle de serviceDescriptionDéfaut
Directory-QuotaCloud-Microsoft-Office365-AzureAD-Directory-Quota-ApiContrôle le quota d'utilisation du répertoire Active DirectoryX

Métriques & statuts collectés​

Metric NameUnit
azure.ad.directory.usage.count

Prérequis​

Afin d'utiliser ce Pack de supervision, il est nécessaire d'attribuer les bons privilèges à votre application/client. Ces privilèges sont listés ici.

La procédure pour définir une application est disponible ici.

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 de OneDrive Online, vous devez spécifier les autorisations que votre application requiert: Dans le portail de gestion Azure :

  • Microsoft Graph :
    • Organization.Read.All (Application and Delegated)
    • Directory.Read.All (Application and Delegated)

La documentation officielle de Microsoft sur les permissions est disponible ici.

Installation​

  1. Installez le plugin sur tous les collecteurs Centreon devant superviser des ressources Azure AD :
yum install centreon-plugin-Cloud-Microsoft-Office365-AzureAD-Api
  1. Sur l'interface web de Centreon, installez le connecteur de supervision Office 365 Azure AD depuis la page Configuration > Packs de plugins.

Configuration​

Hôte​

  • Ajoutez un hĂ´te Ă  Centreon depuis la page Configuration > HĂ´tes.
  • ComplĂ©tez les champs Nom, Alias & IP Address/DNS correspondant Ă  votre serveur Azure AD.
  • Appliquez le modèle d'hĂ´te Cloud-Microsoft-Office365-AzureAD-Api-custom.
  • Une fois le modèle appliquĂ©, les macros ci-dessous indiquĂ©es comme requises (Obligatoire) doivent ĂŞtre renseignĂ©es.
ObligatoireMacroDescription
xOFFICE365CLIENTID
xOFFICE365CLIENTSECRET
OFFICE365EXTRAOPTIONSOptions supplémentaires à ajouter à l'ensemble des commandes de l'hôte (ex: --verbose)
xOFFICE365TENANT

Comment puis-je tester le plugin et que signifient les options des commandes ?​

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

/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

La commande devrait retourner un message de sortie similaire Ă  :

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

La liste de toutes les options complémentaires et leur signification peut être affichée en ajoutant le paramètre --help à la commande :

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

Tous les modes disponibles peuvent être affichés en ajoutant le paramètre --list-mode à la commande :

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

Diagnostic des erreurs communes​

Rendez-vous sur la documentation dédiée pour le diagnostic des erreurs communes des plugins Centreon.