Aller au contenu principal

Proxmox VE Rest API

Contenu du Pack

Modèles

Le Pack Centreon Proxmox VE apporte un modèle d'hôte :

  • Virt-Proxmox-Ve-Restapi-custom

Il apporte les modèles de service suivants :

AliasModèle de servicesDéfautDécouverte
Node-UsageVirt-Proxmox-Ve-Node-Usage-RestapiXX
Storage-UsageVirt-Proxmox-Ve-Storage-Usage-RestapiXX
Vm-UsageVirt-Proxmox-Ve-Vm-Usage-RestapiXX

Règles de découverte

Nom de la règleDescription
Proxmox VMDécouverte des machines virtuelles Proxmox VE

Rendez-vous sur la documentation dédiée pour en savoir plus sur la découverte automatique d'hôtes.

Métriques & statuts collectés

Metric nameDescriptionUnit
node statusCurrent overall node status
node_id#node.cpu.utilization.percentageCPU utilization%
node_id#node.memory.usage.bytesMemory usedB
node_id#node.filesystem.usage.bytesSpace used for root filesystemB
node_id#node.swap.usage.bytesSwap usedB

Prérequis

Pour la supervision, un utilisateur avec les droits en lecture est nécessaire : VM.Monitor, VM.Audit, Datastore.Audit, Sys.Audit, Sys.Syslog.

Référez vous à la documentation officielle : https://pve.proxmox.com/wiki/Proxmox_VE_API

Installation

  1. Installer le plugin Centreon sur tous les collecteurs Centreon devant superviser des ressources Proxmox VE :
yum install centreon-plugin-Virtualization-Proxmox-Ve-Restapi
  1. Sur l'interface web de Centreon, installer le Pack Proxmox VE 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 Proxmox VE.
  • Appliquez le modèle d'hôte Virt-Proxmox-Ve-Restapi-custom.
  • Une fois le modèle appliqué, les macros ci-dessous indiquées comme requises (Obligatoire) doivent être renseignées.
ObligatoireNomDescription
XPROXMOXAPIPORTPort used (Default: 443)
XPROXMOXAPIPROTOSpecify http if needed (default: 'https')
XPROXMOXAPIUSERNAMEApi username
XPROXMOXAPIPASSWORDApi password
XPROXMOXAPIREALMApi username realm
PROXMOXAPIEXTRAOPTIONSAny extra option you may want to add to the command (eg. a --verbose flag)

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_proxmox_ve_restapi.pl \
--plugin=apps::proxmox::ve::restapi::plugin \
--mode=storage \
--hostname='10.0.0.1' \
--port='443' \
--proto='https' \
--api-username='my-username' \
--api-password='my-password' \
--realm='my-realm' \
--verbose

La commande devrait retourner un message de sortie similaire à :

OK: Storage 'storage/nuc/local' state: available, space total: 217.61 GB used: 145.86 GB (67.03%) free: 71.76 GB (32.97%) | 'storage/nuc/local#storage.space.usage.bytes'=156610641920B;;;0;233658822656

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_proxmox_ve_restapi.pl \
--plugin=apps::proxmox::ve::restapi::plugin \
--mode=storage \
--help

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

/usr/lib/centreon/plugins/centreon_proxmox_ve_restapi.pl \
--plugin=apps::proxmox::ve::restapi::plugin \
--list-mode

Diagnostic des erreurs communes

Rendez-vous sur la documentation dédiée des plugins basés sur HTTP/API.