| Scroll Ignore | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||
|
Contexte
Shinken livre des packs qui ont pour objectif de proposer des commandes, des checks et des modèles traitant un même sujet ( par exemple le pack Switch-SNMP permet la supervision de vos switchs ).
Les packs livrés par Shinken sont importés via la source "cfg-file-shinken", ils sont utilisables directement en utilisant les modèles d'hôtes fournis dans vos hôtes.
Mais si vous devez modifier vos checks, Pour rappel, si vous devez modifier un élément ( check, commande ou modèle d'hôte ) livré par un pack Shinken pour un besoin précis, il est important de ne pas modifier directement les éléments présents dans le pack, mais de créer vos propres éléments qui eux utiliseront ( hériteront ) les éléments livrés.
Pourquoi ne pas modifier les éléments livrés dans le pack ?
- Vous pouvez réimporter la source "cfg-file-shinken" sans causer de différence lors du mélange des sources.
- Vous pouvez utiliser le pack comme base pour faire vos propres commandes, checks et modèles.
Cette page apporte des conseils sur l'utilisation optimale des packs ainsi livrés.
Cohabiter avec un pack livré Shinken
L'idée est de ne pas modifier les éléments importés par le pack, ce qui a plusieurs avantages :
- Vous pouvez réimporter la source "cfg-file-shinken" ( afin de bénéficier des mises à jour des packs s'il y en a ), sans causer de différence lors du mélange des sources.
- Vous pouvez utiliser le pack comme base pour faire vos propres commandes, checks et modèles dans le but d'être en phase avec vos besoins et vos usages.
Quelles méthodes utilisées pour faire vos propres éléments ( hériter ou cloner les éléments du pack )
Pour ne pas utiliser les éléments provenant des packs tout en bénéficiant de leurs configurations ( données, paramétrages, héritages... ) vous pouvez utiliser les fonctionnalités suivantes :
- le clonage
- l'héritage
En fonction du type d'élément Shinken, nous vous conseillons d'utiliser soit le clonage, soit l'héritage. Dans les parties ci-dessous, nous vous expliquons pourquoi et comment faire.
| Info |
|---|
Pour les exemples, nous utiliserons les commandes, les checks et les modèles du pack Switch-SNMP ( voir la page Pack Switch-SNMP - ( Snmp v1, v2 ) ). |
Le modèle d'hôte ou cluster
Pour un modèle, il est préférable d'en créer un nouveau afin qu'il hérite d'un modèle livré par le pack. Ce qui vous offre plusieurs avantages :
- Vous pouvez mettre à jour les packs livrés ( en important la source "cfg-file-shinken" ) sans avoir de différence lors du mélange des sources.
- Vous héritez de toutes les propriétés, toutes les données et de tous les checks du modèle en vous laissant la possibilité de :
- désactiver
- ajouter
- supprimer
- modifier
- surcharger
- exclure
sans que ça pose de problème lors du mélange des sources.
Exemple
Dans la barre de navigation, cliquer sur :
- Staging
- Hôte
- Modèle d'hôte
| Panel |
|---|
Sur la page de la liste des modèles d'hôtes, cliquer sur :
- "Ajouter [ Modèle d'hôte ]"
| Panel |
|---|
Sur la page de création d'un modèle d'hôte :
- Ajouter un nom à votre modèle ( dans l'exemple le nom est : Nouveau-Modèle-switch-SNMPv1v2 ).
- Dans "Modèles d'hôtes hérités", choisir le modèle d'hôte dont vous avez besoin dans le pack de votre choix livré par Shinken ( dans l'exemple le modèle utilisé est : switch-SNMPv1v2 ).
- Dans "Pack", renseigner la même valeur qu'il y a dans le champ "Pack" du modèle hérité ( dans l'exemple la valeur est : switch-snmp ). Vous pourrez alors filtrer les éléments par pack dans la liste des éléments Shinken.
| Panel |
|---|
important de créer le vôtre. Celui-ci utilisera le pack livré par Shinken, ce qui évitera de modifier directement l'élément concerné ( voir la page Les bonnes pratiques d'utilisation d'un pack livré par Shinken ).
La création d'un check permet d'exécuter des sondes dans des conditions correspondant à des besoins spécifiques, par exemple :
- pour un intervalle des nouvelles tentatives bien précis,
- pour un nombre maximum de tentatives bien précis,
- pour un intervalle entre les vérifications bien précis,
- etc.
Cette page permet d'avoir les différentes étapes pour ajouter un check sur un modèle d'hôte.
Ajout d'un check étape par étape
Création du check
Se rendre sur la liste des checks à appliquer aux modèles d'hôtes
Dans la barre de navigation :
- Cliquer sur "Staging"
- Survoler "Check"
- Cliquer sur "Check appliqué au modèle d'hôte"
| Panel |
|---|
Créer un check
Dans les onglets Données et Checks, vous pouvez vérifier que toutes les données et checks ont bien été hérités. Désormais, libre à vous de :
- Ajouter, exclure et surcharger un check
- Ajouter ou modifier des données
| Panel |
|---|
| Panel |
|---|
La commande
Pour une commande, il est préférable d'en cloner une existante livrée par le pack afin d'avoir toute la base de la commande. Ce qui vous offre plusieurs avantages :
- Vous pouvez mettre à jour les packs livrés ( en important la source "cfg-file-shinken" ) sans avoir de différence lors du mélange des sources.
- Vous avez déjà la base de la commande, ce qui vous fera gagner du temps.
Exemple
Sur la page de la liste des commandes, rechercher la commande que vous voulez cloner ( dans l'exemple la commande que je veux cloner est : check_switch_cpu ).
| Panel |
|---|
Une fois votre check affiché, sélectionner votre check plus cliquer sur "Cloner [ 1 ]".
| Panel |
|---|
Cliquer sur la nouvelle commande ( dans l'exemple la nouvelle commande est : check_switch_cpu [copie] ).
| Panel |
|---|
Sur la page de la commande clonée :
- Changer le nom de votre commande ( dans l'exemple le nouveau nom est : check_switch_blacklist_interfaces ).
- Dans "Ligne de Commande", vous pouvez modifier la ligne de commande pour que le résultat qu'elle retourne réponde à votre besoin.
| Panel |
|---|
Le check
Pour un check, il est préférable d'en créer un nouveau afin qu'il hérite d'un check livré par le pack. Ce qui vous offre plusieurs avantages :
- Vous pouvez mettre à jour les packs livrés ( en important la source "cfg-file-shinken" ) sans avoir de différence lors du mélange des sources.
- Vous héritez de toutes les propriétés et de toutes les données du check en vous laissant la possibilité de :
- désactiver
- ajouter
- supprimer
- modifier
sans que ça pose de problème lors du mélange des sources.
Exemple
Dans la barre de navigation, cliquer sur :
- Staging
- Check
- Check appliqué au modèle d'hôte
| Panel |
|---|
Sur la page de la liste des checks à appliquer aux modèles d'hôtes, cliquer sur : "Ajouter [ Check appliqué au modèle d'hôte ]"
| Panel |
|---|
Configurer un check
Sur la page de création d'un check appliqué au modèle d'hôte :
- Définir le nom ( propriété : Nom du check ).
- Il est recommandé de définir un modèle d'héritage ( propriété :
- Modèles de Check hérité
- ).
Pour rappel, le modèle "generic-service"
- défini les champs obligatoires à la validité du check ( Commande de vérification, Nombre maximum de tentatives de confirmation du statut du check
- , Intervalle entre les vérifications
- , Intervalle des nouvelles tentatives de confirmations d'état
- )
- Définir le nom du modèle sur lequel le check sera rattaché ( propriété : Attaché sur les modèles
- d'hôte
- ).
| Info |
|---|
Grâce à la propriété "Pack", vous |
pourrez alors filtrer les éléments par pack dans la liste des éléments Shinken. |
| Panel |
|---|
Dans l'onglet supervision, ajouter votre nouvelle commande ( dans l'exemple la nouvelle commande est : check_switch_blacklist_interfaces )propriété : Commande de vérification ).
| Panel |
|---|
Enregistrer un check
Sauvegarder le nouveau check attaché au modèle livré dans le pack Shinken.
| Panel |
|---|
















