Azure Discover
Vue d'ensemble
Le Plugin Pack Centreon Azure Discover permet de découvrir l'ensemble des resources Azure rattachées à une souscription donnée. Il s'appuie sur les API Azure Monitor afin de récuperer les éléments de l'infrastructure. Il s'appuie sur la collection des Plugin Pack afin de modéliser une infrastructure Azure dans Centreon
Le Plugin Pack Centreon Azure Discover est uniquement compatible avec le custom-mode 'api'.
Contenu du Plugin Pack
Le Plugin Pack Azure Discover est un pack de découverte. Il ne fournit pas de modèles ni d'indicateurs de supervision en propre.
Règles de découverte
Le Plugin Pack Centreon Azure Discover fournit un provider de découverte d'Hôtes nommé Microsoft Azure Management Discover Celui-ci permet de découvrir l'ensemble des ressources Microsoft Azure rattachées à une souscription donnée:
Vous trouverez plus d'informations sur la découverte d'Hôtes et son fonctionnement sur la documentation du module: Découverte des hôtes
Prérequis
Rendez-vous sur la documentation dédiée afin d'obtenir les prérequis nécessaires pour interroger les API d'Azure.
Paramétrer une découverte
Le descriptif du fonctionnement général de la fonctionnalité Host Discovery est disponible ici
Paramètres d'accès
Après avoir sélectionné le provider Azure Management Discover, renseignez les paramètres d'authentification ainsi que les options d'accès à l'API comme ci-après:
- Sélectionnez le collecteur Centreon depuis lequel sera lancé la découverte
- Renseignez les paramètres relatifs à l'utilisation d'un proxy d'entreprise si besoin
- Sélectionnez le profil d'authentification Azure à utiliser
Dans le cadre d'une première utilisation, vous pouvez créer un nouveau profil d'accès à Azure en cliquant sur '+'. Renseignez ensuite les informations demandées comme ci-après:
Tous les champs du formulaire credentials doivent être renseignés
Cliquez sur confirm puis sur next pour afficher la page des paramètres de la découverte.
Paramètres de découverte
Renseignez si besoin les information ci-après:
Tous les champs de ce formulaire sont facultatifs
- Azure Location/Resource Group: permet de restreindre la découverte à une location ou un resource group donné
- Filter on namespace/type: permet de restreindre la découverte à un Service Azure spécifique, par exemple:
- *Resource namepsace*: 'Microsoft.Compute'
- *Resource type*: 'virtualMachines'Attention : pour l'utilisation de ce filtre, les champs Resource namepsace et Resource type doivent dans ce cas être tous les deux renseignés
Lancement de la découverte et affichage des résultats
L'étape 4 permet d'ajuster les mappers; ceux-ci sont déjà prédéfinis par le Plugin Pack, il n'est normalement pas nécessaire de les modifier dans le cadre d'un job de découverte standard. Si besoin, référez-vous à la documentation des mappers.
Les étapes 5 & 6 permettent d'ajuster la politique de modélisation des résultats si besoin. Rendez-vous ici pour plus d'informations.
Une fois la découverte terminé, vous pouvez afficher les résultats en cliquant sur job results. Les modèles relatifs aux types de resources Azure sont automatiquement appliqués:
Certains éléments peuvent ne pas avoir de modèle appliqué dans la liste des résultats:
- les éléments ne sont pas des ressources pouvant être supervisées
- ces ressources ne sont pas couvertes par les Plugin Pack Centreon
Sélectionnez les éléments à modéliser dans Centreon et Sauvegardez.
Diagnostic des erreurs communes
Les identifiants ont changé et la découverte ne fonctionne plus
Le Plugin de découverte utilise un fichier de cache pour conserver les informations de connexion afin de ne pas se ré-authentifier à chaque appel. Si des informations sur le Tenant, la Souscription ou les Client ID / Secret changent, il est nécessaire de supprimer le fichier de cache du Plugin.
Celui ci se trouve dans le répertoire /var/lib/centreon/centplugins/
avec le nom azureapi<md5>_<md5>_<md5>_<md5>
.
UNKNOWN: Login endpoint API returns error code 'ERROR_NAME' (add --debug option for detailed message)
le job de découverte renvoie le message suivant :
UNKNOWN: Login endpoint API returns error code 'ERROR_NAME' (add --debug option for detailed message)
.
Cela signifie que l'un des paramètres utilisés pour authentifier la requête est incorrect. Le paramètre en question est spécifié dans le message d'erreur en lieu et place de 'ERROR_NAME'.
Par exemple, 'invalid_client' signifie que le client-id et/ou le client-secret n'est (ne sont) pas valide(s).