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​

Rendez-vous sur la documentation dédiée afin d'obtenir les prérequis nécessaires pour interroger les API d'Azure.

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 > Gestionnaire de connecteurs de supervision.

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