Présentation
Ce check recueille des métriques d’utilisation des ressources depuis votre cluster vSphere : charge processeur, disque, mémoire et réseau. Il surveille également votre serveur vCenter à la recherche d’événements et les envoie à Datadog.
Configuration
Installation
Le check vSphere est inclus avec le package de l’Agent Datadog : vous n’avez donc rien d’autre à installer sur votre serveur vCenter.
Configuration
Dans la section Administration de vCenter, ajoutez un utilisateur en lecture seule du nom de datadog-readonly.
Modifiez ensuite le fichier vsphere.d/conf.yaml dans le dossier conf.d/ à la racine du répertoire de configuration de votre Agent. Consultez le fichier d’exemple vsphere.d/conf.yaml pour découvrir toutes les options de configuration disponibles.
Redémarrez l’Agent pour commencer à envoyer des métriques et des événements vSphere à Datadog.
Remarque : l’Agent Datadog ne doit pas nécessairement être sur le même serveur que le logiciel vSphere. Lorsque le check vSphere est activé, l’Agent peut être configuré de façon à pointer vers le serveur vSphere (et ce, quel que soit le système d’exploitation sur lequel il s’exécute). Mettez à jour votre <HOSTNAME> en fonction.
Compatibilité
À partir de la version 5.0.0 du check (incluse avec l’Agent version 6.18.0/7.18.0), une nouvelle implémentation de l’intégration a été mise en place, ce qui signifie que le fichier de configuration a été modifié. Pour assurer la compatibilité avec les versions précédentes, un paramètre de configuration intitulé use_legacy_implementation est temporairement disponible.
Si vous mettez à jour l’intégration depuis une version plus ancienne, ce paramètre n’est pas défini dans la configuration, ce qui oblige l’Agent à utiliser l’ancienne implémentation.
Si vous configurez l’intégration pour la première fois ou si vous souhaitez bénéficier des nouvelles fonctionnalités (comme la collecte de tags et les options de filtrage avancées), reportez-vous à l’exemple de fichier de configuration vsphere.d/conf.yaml. En particulier, assurez-vous de définir use_legacy_implementation: false.
Validation
Lancez la sous-commande status de l’Agent et cherchez vsphere dans la section Checks.
Dépannage
Données collectées
En fonction du collection_level défini dans votre configuration du check, les métriques ci-dessous ne seront pas toutes recueillies. Consultez la documentation relative aux niveaux de collecte des données Vsphere pour découvrir les métriques collectées en fonction du niveau de collecte choisi.
Métriques
Recueillir des métriques par instance
Remarque : l’intégration vSphere offre la possibilité de recueillir des métriques par ressource (telles que celles liées aux CPU) ou par instance (telles que celles liées aux cœurs CPU). Certaines métriques sont donc uniquement recueillies par ressource ou par instance, tandis que d’autres sont recueillies pour les deux.
Une ressource correspond à une représentation physique ou virtuelle d’une machine. Les ressources peuvent être visualisées par VM, host, datastore ou cluster dans vSphere.
Une instance correspond à une entité distincte au sein d’une ressource. Pour en savoir plus sur les ressources vSphere, consultez le livre blanc VMWare Infrastructure Architecture Overview.
Par défaut, l’intégration vSphere recueille uniquement les métriques par ressource, ce qui signifie que certaines métriques par instance sont ignorées. Utilisez l’option collect_per_instance_filters pour modifier ce comportement. Voici un exemple :
collect_per_instance_filters:
host:
- 'disk\.totalLatency\.avg'
- 'disk\.deviceReadLatency\.avg'
Les métriques disk étant spécifiques à chaque disque du host, il est nécessaire d’utiliser l’option collect_per_instance_filters pour les recueillir.
Événements
Ce check surveille le gestionnaire d’événements de vCenter à la recherche d’événements et les envoie à Datadog. Il envoie les types d’événements suivants :
- AlarmStatusChangedEvent:Gray
- VmBeingHotMigratedEvent
- VmReconfiguredEvent
- VmPoweredOnEvent
- VmMigratedEvent
- TaskEvent:Initialize powering On
- TaskEvent:Power Off virtual machine
- TaskEvent:Power On virtual machine
- TaskEvent:Reconfigure virtual machine
- TaskEvent:Relocate virtual machine
- TaskEvent:Suspend virtual machine
- TaskEvent:Migrate virtual machine
- VmMessageEvent
- VmSuspendedEvent
- VmPoweredOffEvent
Checks de service
Consultez le fichier service_checks.json pour afficher la liste des checks de service fournis par cette intégration.
Pour aller plus loin
Lisez notre article de blog (en anglais) à propos de la surveillance des environnements vSphere avec Datadog.
