Sommaire

Contexte

Le modèle proxmox-ve-by-API__storage offre une vue générale de l'utilisation et de l'état des disques et volumes sur le nœud Proxmox. L'ensemble des checks apportés par ce modèle d'hôtes permettent d'estimer rapidement le bon fonctionnement des espaces de stockage, et d'assurer qu'ils ne présentent pas d'anomalies majeures.

Ce modèle est efficace pour déterminer rapidement l'état général des espaces de stockage.


Si le besoin de modifier certains éléments ( commandes, checks ou modèles d'hôtes ) se présente, veuillez vous référer à la page ( Les bonnes pratiques d'utilisation d'un pack livré par Shinken ).

  • Il est possible également de directement modifier le modèle proxmox-ve-by-API__storage, car il hérite du modèle proxmox-ve-by-API__storage__shinken qui contient toute la logique du modèle.

Vous ne devez pas modifier les modèles internes finissant par la particule '__shinken', cela risque d'écraser vos modifications lors des mises à jour du pack.

Sommaire des checks

NomDescription
Node Disks Health by API

Vérifie l'état de santé des disques physiques montés sur le nœud Proxmox.

( voir la page  Node Disks Health by API )

Node Storage by API

Vérifie la consommation actuelle des espaces de stockage.

( voir la page Node Storage by API ) 

Node ZFS Health by API

Vérifie l'état de santé de la réplication ZFS ( Réplication de stockage utilisée par défaut sur Proxmox ).

( voir la page Node ZFS Health by API  ) 


Node Backup Tasks [$KEY$] by API

Vérifie la bonne exécution des backups pour une machine virtuelle spécifique.

( voir la page Node Backup Tasks [$KEY$] by API  ) 


Node Snapshots Age [$KEY$] by API

Vérifie l'âge des snapshots pour une machine virtuelle spécifique.

( voir la page Node Snapshots Age [$KEY$] by API  )


Les données

Les données communes pour tous les checks



NomModifiable surUnitéDéfautValeur par défaut à l'installation du packDescription
PROXMOX-VE-BY-API__NODE-NAME

l'Hôte

( Onglet Données )

--

$HOSTNAME$

 $HOSTNAME$

Le nom du nœud Proxmox supervisé. Il faut utiliser le nom du nœud correspondant à l'adresse IP de l'hôte :

  • exemple-shinken-proxmox-cluster01 : 172.17.0.14
  • exemple-shinken-proxmox-cluster01 : 172.17.0.15

Si l'adresse IP de l'hôte Shinken est 172.17.0.14, alors PROXMOX-VE-BY-API__NODE-NAME doit être exemple-shinken-proxmox-cluster01.

PROXMOX-VE-BY-API__PORT

l'Hôte

( Onglet Données )

--

8006

 8006

Le port utilisé pour accéder à l'API. Par défaut, il s'agit du même port que celui de l'interface de configuration et de gestion Proxmox.

PROXMOX-VE-BY-API__SSL__USE-SSL

l'Hôte

( Onglet Données )

--

True

 True

Le mode de gestion SSL : 

  • True : vérification activée avec les autorités de certification connues du système
  • False : vérification des certificats désactivée
  • /chemin/vers/cert : vérification du certificat pour une autorité de certification spécifique
PROXMOX-VE-BY-API__TOKEN

l'Hôte

( Onglet Données )

--

shinken:secret

 shinken:secret

Combinaison du nom de la clé API et de la clé API.

  • TOKEN-API-NAME:API-KEY
    • Exemple : SUP-SHINKEN:d2abf83e-da98-4583-bf4b-f3e7e292dadd
PROXMOX-VE-BY-API__USER

l'Hôte

( Onglet Données )

--

shinken@pve

 shinken@pve

Nom de l'utilisateur Proxmox à utiliser pour la connexion.

Les données spécifiques

NomModifiable surUnitéDéfautValeur par défaut à l'installation du packDescription
PROXMOX-VE-BY-API__NODE-DISKS__NODE-DISKS-EXCLUDE

l'Hôte

( Onglet Données )

--

None

 None

La liste des disques à exclure des vérifications.

Cette donnée n'est utilisée que pour le check "Node Disks Health by API".

PROXMOX-VE-BY-API__NODE-STORAGE__NODE-STORAGE-EXCLUDE

l'Hôte

( Onglet Données )

--

None

 None

La liste des espaces de stockage à exclure des vérifications.

Cette donnée n'est utilisée que pour le check "Node Storage by API".

PROXMOX-VE-BY-API__NODE-ZFS-HEALTH__NODE-ZFS-HEALTH-EXCLUDE

l'Hôte

( Onglet Données )

--

None

 None

La liste des réplications ZFS à exclure des vérifications.

Cette donnée n'est utilisée que pour le check "Node ZFS Health by API".

Les données DFE ( Duplicate Foreach )

NomModifiable sur UnitésDéfautValeur par défaut à l'installation de ShinkenDescription
PROXMOX-VE-BY-API__BACKUP-TASKS__BACKUP-TASKS-TO-CHECK

l'Hôte

( Onglet Données )

----- --

Indication de l'ID Proxmox de la machine virtuelle où l'exécution des backups doit être vérifiée / Intervalle de temps pour la vérification

exemple "prod01$(100)$$(24)$,prod2$(101)$$(12)$".

  • Sur la VM à l'ID 100, le check vérifiera si des backups ont été effectués dans les dernières 24h.
  • Sur la VM à l'ID 101, le check vérifiera si des backups ont été effectués dans les dernières 12h.


Check(s) impacté(s) :

PROXMOX-VE-BY-API__SNAPSHOTS-AGE__SNAPSHOTS-AGE-TO-CHECK

l'Hôte

( Onglet Données )

----- --

Indication de l'ID Proxmox de la machine virtuelle où la présence de snapshots doit être vérifiée.

Exemple : "prod01$(100)$,prod2$(101)$".

  • Sur les VM à l'ID 100 et 101, le check vérifiera la présence de snapshots.


Check(s) impacté(s) :

Comment appliquer un modèle d'hôte à un hôte

Dans les 2 méthodes suivantes, remplacer mon_modèle par le modèle voulu :

  • proxmox-ve-by-API__storage

Application du modèle via l'interface de Configuration

Dans l'interface de Configuration :

  • créer ou éditer un hôte ( voir la page Éditer un Hôte ),
  • ajouter le modèle "mon-modèle" ( selon vos besoins )  dans la propriété "Modèles d'hôte hérités" à l'aide du menu déroulant.



Application du modèle via un collecteur d'import de fichiers au format .cfg

Dans votre fichier de définition de vos éléments à importer via votre collecteur :

define host {
    host_name   mon_hôte
    use         mon-modèle
}





  • No labels