| Scroll Ignore | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||
| Panel | ||||||||||||||
| ||||||||||||||
| ||||||||||||||
|
Un Pack additionnel, qu'est-ce que c'est ?
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
| Nom | Lien | ||
|---|---|---|---|
| Modèle proxmox-ve-by-API__resources | ||
| Modèle proxmox-ve-by-API__storage | ||
| Modèle proxmox-ve-by-API__availability | ||
| 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 :
Ceux-ci héritent des modèles suivants :
Les modèles finissant par "_shinken" contiennent toute la logique 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 | ||
|---|---|---|
| ||
./install.sh |
Le script trace les actions réalisées dans un retour terminal :
| Code Block | ||
|---|---|---|
| ||
=============================================
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 |
| Code Block | ||
|---|---|---|
| ||
service shinken-synchronizer restart |
Comment importer les nouveaux éléments dans Shinken ?
Après installation du pack via l'install-pack, une nouvelle source est disponible dans l'interface de configuration de Shinken :
Une fois activée, celle-ci propose les nouveaux changements dans l'interface de configuration :
Les nouveaux éléments sont proposés en jaune dans chaque partie correspondante :
Le pack additionnel proxmox importe :