| Scroll Ignore | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||
| Panel | ||||||||||||||
| ||||||||||||||
| ||||||||||||||
|
Un Pack, 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 noeud proxmox ciblé. Plusieurs niveaux de supervision sont proposés :
- docker-on-linux-by-SSH__all-containers qui permet la supervision de l'ensemble des conteneurs pour une vérification des fonctions principales ( CPU, mémoire, Status, Uptime ).
- docker-on-linux-by-SSH__all-containers__advanced qui permet, en complément du modèle docker-on-linux-by-SSH__all-containers , de relever des indicateurs plus poussés ( Image-age, Restarts ).
- docker-on-linux-by-SSH__all-containers __extra qui offre la possibilité de mettre sous surveillance des éléments de configuration spécifiques ( Santé interne d'un conteneur ).
Liste des modèles d'hôte
| Nom | Lien | ||
|---|---|---|---|
| Modèle docker-on-linux-by-SSH__all-containers | ||
| Modèle docker-on-linux-by-SSH__all-containers__advanced | ||
| Modèle docker-on-linux-by-SSH__all-containers__extra |
| 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 finiisant 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 docker-on-linux-by-SSH__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
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 ?
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 :