HYPHApar S33D
Documentation › Intégrations

Hyperviseurs : vSphere, Proxmox VE, Hyper-V, KVM et VirtualBox

L'état des hyperviseurs et de leurs VM, lu en lecture seule, à côté des agents installés dans les VM.

VMware vSphere (ESXi et vCenter)

On n'installe pas d'agent sur un ESXi : un agent de votre parc interroge l'API vSphere avec un compte au rôle ReadOnly.

integrations:
  vsphere:
    interval: 60s
    targets:
      - name: vcenter
        url: https://vcenter.exemple/sdk
        username: hypha@vsphere.local
        password: "…"
        thumbprint: "AA:BB:…"     # empreinte SHA-1 d'un certificat autosigné
        # insecure: true          # à éviter : accepte n'importe quel certificat
        tags: {site: paris}

Ce que HYPHA relève :

Les hôtes ESXi et les VM deviennent des ressources dans Infrastructure. Une VM qui porte aussi un agent HYPHA est rapprochée de son hôte par son numéro de série (« VMware-… ») : une seule ligne, et sa fiche montre ce que vSphere en dit.

Proxmox VE

Deux façons de lire la grappe :

integrations:
  proxmox:
    url: https://pve.exemple:8006
    token_id: "hypha@pve!lecture"
    token_secret: "…"
    ca_file: /etc/hypha/pve-ca.pem

Contrôles : quorum de la grappe, nœud hors ligne, stockage indisponible, invité HA hors de l'état demandé, dernière sauvegarde (vzdump) de chaque nœud en échec, levé dès que la suivante réussit. Mesures des nœuds, des stockages et des invités (VM et conteneurs). Les tâches en échec deviennent des événements.

Hyper-V

Sous Windows, l'agent lit Get-VM quand le service Hyper-V est présent ; aucun réglage.

KVM et libvirt

Sur l'hôte, virsh en lecture seule (qemu:///system par défaut, réglable par uri).

VirtualBox

L'agent de l'hôte relève les VM déclarées et en marche, et signale une VM à démarrage automatique arrêtée (virtualbox.vm.running). Réglage user pour ne suivre qu'un compte.

Modèles de moniteurs

Famille Virtualisation du catalogue : connecteur vSphere en échec, hôte ESXi en défaut, datastore inaccessible ou presque plein, VM vSphere en défaut, instantané ancien ; Proxmox injoignable, quorum perdu, nœud hors ligne, stockage indisponible ou presque plein, invité HA hors de son état, sauvegarde en échec ; VM Hyper-V en défaut, point de contrôle ancien, réplication dégradée ; VM KVM en défaut, pool inactif ou presque plein.

Mise à jour : 19 novembre 2026