Versions Compared

Old Version 4

changes.mady.by.user Thomas Khedim

Saved on

compared with

New Version Current

changes.mady.by.user Thomas Khedim

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Scroll Ignore
scroll-pdftrue
scroll-officetrue
scroll-chmtrue
scroll-docbooktrue
scroll-eclipsehelptrue
scroll-epubtrue
scroll-htmltrue
Panel
titleSommaire

Table of Contents

stylenone
printablefalse

Un Pack additionnel, qu'est-ce que c'est ?

 Un pack de supervision, mis à dispositions par Shinken solutions, est un regroupement de commandes permettant de superviser un type d'équipement particulier.
Dans son état natif, Shinken embarque plusieurs de ces packs pour proposer une base standard de monitoring. Dans cette base, on retrouve notamment :

Contexte

Pour superviser les informations spécifiques à un nœud Proxmox, le pack proxmox-ve-by-API__shinken met à disposition les modèles d'hôte "node".

Ces modèles récupèrent l'ensemble des informations spécifiques au nœud Proxmox ciblé. Plusieurs niveaux de supervision sont proposés :

  • proxmox-ve-by-API__resources  qui permet de superviser l'ensemble des ressources gérées par un nœud Proxmox  (  CPU, mémoire, Network   ).
  • proxmox-ve-by-API__storage   qui permet  de superviser les disques et montages logiques propres au fonctionnement de Proxmox (  Disks status, Storage, ZFS Health  ).
  • proxmox-ve-by-API__availability  qui permet de relever les indicateurs spécifiques à la disponibilité du nœud Proxmox (  Services, Availability  ).
  • proxmox-ve-by-API__lifecycle  qui permet, en complément du modèle  proxmox-ve-by-API__resources , de relever des indicateurs spécifiques sur l'état applicatif (  Certificates Expiration, Licence  ).


Liste des modèles d'hôte

NomLien
No Format
proxmox-ve-by-API__resources
Modèle proxmox-ve-by-API__resources
No Format
proxmox-ve-by-API__storage
Modèle proxmox-ve-by-API__storage
No Format
proxmox-ve-by-API__availability
Modèle proxmox-ve-by-API__availability
No Format
proxmox-ve-by-API__lifecycle
Modèle proxmox-ve-by-API__lifecycle
Info

Afin de s'adapter à vos besoins précis, il est possible de directement modifier les modèles suivants :

  • proxmox-ve-by-API__resources
  • proxmox-ve-by-API__storage
  • proxmox-ve-by-API__availability
  • proxmox-ve-by-API__lifecycle

Ceux-ci héritent des modèles suivants :

  • proxmox-ve-by-API__resources_shinken
  • proxmox-ve-by-API__storage_shinken
  • proxmox-ve-by-API__availability_shinken
  • proxmox-ve-by-API__lifecycle_shinken

Les modèles finissant par "_shinken" contiennent toute la logique du pack.

  • Vous ne devez pas modifier ces modèles internes ( finissant par la particule '__shinken' ).
    • Vos modifications seront potentiellement écrasées lors des prochaines mises à jour du pack.
Info

Si vous avez besoin d'aide au fonctionnement des différents modèles, consultez la page Mise en place du Pack proxmox-ve-by-API__shinken

  • Le pack linux
  • Le pack Windows
  • Le pack cisco

Les packs additionnels permettent d'étendre les capacités de Shinken en ajoutant la possibilité de superviser de nouveaux types d'équipements. Ces packs s'installent de manière unitaire sur les serveurs Shinken, en fonction du besoin.

La structure d'un Pack additionnel

Les packs additionnels sont tous organisés de la même manière. 

On y retrouve :

  • un répertoire monitoring-definition, qui contient les différents fichiers de configuration qui vont permettre de créer les nouvelles commandes et modèles dans l'interface de Shinken.
  • un répertoire : probe, contient les sondes de supervision sur lequels s'appuirons les commandes pour contacter les équipements.
  • un répertoire : shinken-source-module, contient tous les éléments pour créer la source, qui permettra d'importer les nouveaux éléments dans l'interface de configuration de shinken.

Ainsi que :

  • un script d'installation, qui permet :
    • de créer la source
    • d'importer les cfg
    • d'importer les sondes
  • un script de désinstallation, qui permet :
    • de supprimer la source
    • de supprimer les cfg
    • de supprimer les sondes

Cet ensemble d'élément, complétement autonome, permet l'installation simple et rapide du pack additionnel sur une instance Shinken.

Comment installer un Pack additionnel ?

Pour chaque Pack additionnel, un script d'installation dédié est fourni avec celui-ci. Pour installer le pack, il suffit d'exécuter le script sans arguments.

Code Block
titleCommande d'installation de pack
./install.sh

Le script trace les actions réalisées dans un retour terminal :

Code Block
titleretour script d'installation
============================================= INSTALL PACK [ shinken-proxmox_by_api ] ============================================= ----------------------------- | COLLECTOR [ shinken-additional-packs-import ] => Collector cfg file already AVAILABLE - Path : /etc/shinken/sources/shinken-additional-packs-import.cfg => Deleting Collector DATA SPACE - Path : /etc/shinken-user/source-data/source-data-shinken-additional-packs-import => CREATING Collector DATA space - Path : /etc/shinken-user/source-data/source-data-shinken-additional-packs-import - Changing owner ( to "shinken" user ) - Setting rights ----------------------------- | MONITORING DEFINITION: => Installing definitions file in source-data folder ( Collector => shinken-additional-packs-import ) - Path : /etc/shinken-user/source-data/source-data-shinken-additional-packs-import - Changing owner ( to "shinken" user ) - Setting rights => Installing global data definitions file in SHINKEN directory ( => resource.d ) - Path : /etc/shinken/resource.d/shinken-additional-packs-import/ - Changing owner ( to "shinken" user ) - Setting rights ----------------------------- | PROBES: => Deleting previous probes => Installing probes - Path : /var/lib/shinken-user/libexec/shinken-additional-packs/proxmox/shinken-proxmox_by_api - Setting owner ( to "shinken" user ) - Setting rights