Aller au contenu principal

Azure InsightsMetrics

Vue d'ensemble

Ce Pack est fourni à titre expérimental (version 2.x.x).

Le Pack Centreon Azure InsightsMetrics permet de superviser des métriques additionelles relatives aux resources Azure. Pour cela, elle se base sur l'API LogAnalytics d'Azure et exécutes des requêtes KustoQL sur la base de données InsightsMetrics. Ce Pack permet par exemple de récupérer et de superviser les indicateurs système (CPU, mémoire, disques...) de Virtual Machines directement sur Azure.

Le Plugin associé est uniquement compatible avec le custom-mode 'api'.

Contenu du Pack

Objets supervisés

  • Azure Virtual Machines
    • CPU
    • Memory
    • Logical-Disks

Métriques & statuts collectés

Metric NameDescriptionUnit
instance#azure.insights.cpu.average.utilization.percentageAverage utilization percentage%
instance~ID#azure.insights.cpu.core.utilization.percentageCurrent utilization per core%

Règles de découverte

Rule nameDescription
Cloud-Azure-Management-InsightsMetrics-Api-VirtualMachine-Logical-Disks-NameDiscover logical disks associated to Azure Virtual Machines

Prérequis

Identifiants

Le Plugin associé au Pack Centreon Azure InsightsMetrics est uniquement compatible avec le custom-mode 'api'.

Récupérez les informations d'identification associées en suivant la procédure ci-dessous (en anglais) et notez celles-ci en lieu sûr. Elles seront en effet indispensables lors de la configuration des ressources dans Centreon.

  • Create an application in Azure Active Directory:

    • Log in to your Azure account.
    • Select Azure Active directory in the left sidebar.
    • Click on App registrations.
    • Click on + Add.
    • Enter Centreon as the application name (or any name of your choice), select application type(api) and sign-on-url.
    • Click on the Create button.
  • Get Subscription ID

    • Log in to your Azure account.
    • Select Subscriptions in the left sidebar.
    • Select whichever subscription is needed.
    • Click on Overview.
    • Copy the Subscription ID.
  • Get Tenant ID

    • Log in to your Azure account.
    • Select Azure Active directory in the left sidebar.
    • Click on Properties.
    • Copy the directory ID.
  • Get Client ID

    • Log in to your Azure account.
    • Select Azure Active directory in the left sidebar.
    • Click on Enterprise applications.
    • Click on All applications.
    • Select the application previously created.
    • Click on Properties.
    • Copy the Application ID.
  • Get Client secret

    • Log in to your Azure account.
    • Select Azure Active directory in the left sidebar.
    • Click on App registrations.
    • Select the application previously created.
    • Click on All settings.
    • Click on Keys.
    • Enter the key description and select the duration.
    • Click on Save.
    • Copy and store the key value. You won't be able to retrieve it after you leave this page.

Installation

  1. Installer le Plugin sur tous les collecteurs Centreon devant superviser des resources via InsightsMetrics:
yum install centreon-plugin-Cloud-Azure-Management-InsightsMetrics-Api
  1. Sur l'interface Web Centreon, installer le Pack Azure InsightsMetrics depuis la page Configuration > Plugin packs > Manager.

Configuration

Hôte

  • Ajoutez un Hôte à Centreon, remplissez le champ Adresse IP/DNS avec l'adresse 127.0.0.1 et appliquez-lui le Modèle d'Hôte Cloud-Azure-Management-InsightsMetrics-XXX-custom approprié au type de ressource à superviser (par exemple Cloud-Azure-Management-InsightsMetrics-VirtualMachine-custom pour une resource Azure VM).
  • Une fois le modèle appliqué, les Macros ci-dessous indiquées comme requises (Mandatory) doivent être renseignées:
MandatoryNomDescription
XAZURECUSTOMMODECustom mode 'api'
XAZURELOGANALYTICSENDPOINTLogAnalytics endpoint (default: https://api.loganalytics.io)
XAZURESUBSCRIPTIONSubscription ID
XAZUREWORKSPACEIDLogAnalytics workspace ID
XAZURETENANTTenant ID
XAZURECLIENTIDClient ID
XAZURECLIENTSECRETClient secret
XAZURERESOURCEfull ID of the resource to monitor

FAQ

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_azure_management_insightsmetrics_api.pl \
--plugin=cloud::azure::management::insightsmetrics::plugin \
--mode=cpu --custommode='api' --management-endpoint='https://api.loganalytics.io' \
--subscription='xxxxxxxxx' --tenant='xxxxxxx' --client-id='xxxxxxxx' --client-secret='xxxxxxxxxx' \
--workspace-id='xxxxxxxxxxxxxxx' \
--filter-resourceid='/subscriptions/XXXX/resourcegroups/my_resourcegroup1/providers/microsoft.compute/virtualmachines/my_vm1' \
--warning-average-utilization-percentage='90' \
--critical-average-utilization-percentage='95'

La commande devrait retourner un message de sortie similaire à:

OK: 2 CPU(s) average utilization: 2.18 % - All CPUs are ok | 'azure.insights.cpu.average.utilization.percentage'=2.18%;0:90;0:95;0;100
'1#azure.insights.cpu.core.utilization.percentage'=2.12%;;;0;100 '2#azure.insights.cpu.core.utilization.percentage'=2.25%;;;0;100
Computer 'my_vm1'
2 CPU(s) average utilization: 2.18 %
CPU #1 usage : 2.12 %
CPU #2 usage : 2.25 %

La commande ci-dessus contrôle le CPU d'une ressource Azure VM via les indicateurs InsightsMetrics (--plugin=cloud::azure::management::insightsmetrics::plugin --mode=cpu --custommode='api').

Les éléments récupérés dans la partie prérequis pour l'authentification sont ajoutés pour l'obtention d'un token (--subscription='xxxxxxxxx' --tenant='xxxxxxx' --client-id='xxxxxxxx' --client-secret='xxxxxxxxxx').

Les options utilisées pour ce mode permettent de spécifier le workspace dans lequel sera lancée la requête (--workspace-id='xxxxxxxxxxxxxxx') ainsi que l'URL de l'API LogAnalytics à utiliser ( --management-endpoint='https://api.loganalytics.io').

Dans cet exemple, une alarme de type WARNING sera déclenchée si l'utilisation CPU moyenne est supérieure à 90% (--warning-average-utilization-percentage='90'); l'alarme sera de type CRITICAL au-delà de 95% d'utilisation (--critical-average-utilization-percentage='95').

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_azure_management_insightsmetrics_api.pl \
--plugin=cloud::azure::management::insightsmetrics::plugin \
--mode=cpu \
--help