...
La surcharge est un mécanisme permettant de réécrire localement une partie de la configuration d'un check au niveau de chaque hôte ou modèle d'hôte. Cette surcharge s'applique sur les données et les propriétés d'un check.
Ce mécanisme intervient dans la problématique suivante : un hôte avec des checks est proposé à la supervision d'un équipement, mais la configuration des checks ne convient pas à la situation. Au lieu de créer de nouveaux checks et entraîner à la longue une multiplication du nombre de checks, il suffit de surcharger les propriétés ou les données des checks directement sur l'hôte.
| Note |
|---|
Si vous n'êtes pas familier avec le Cette fonctionnalité suppose la connaissance du fonctionnement et l'édition d'un check, il vous est vivement conseillé de commencer par lire la documentation des checks( voir la page Les Checks ). |
Accéder à la surcharge
La surcharge est accessible dans l'onglet Checks de la page d'édition d'un hôte ou d'un modèle d'hôte.
...
Dans l'onglet Checks, il faut activer le mode surcharge ( voir les modes de l'onglet checksla page Éditer un Hôte ) pour pouvoir faire apparaître les boutons d'activation de la surcharge ( Activer la surcharge ou Surchargé ).
| Panel |
|---|
|
Ouvrir le formulaire de surcharge
Un clic sur un bouton Activer la surcharge ou Surchargé ouvrira le formulaire de surcharge d'un check.
| Panel |
|---|
|
| Panel | ||
|---|---|---|
| ||
|
Présentation visuelle
Le formulaire de la surcharge reprend les propriétés proposées lors de l'édition du check
...
et est composé de
...
quatre sections :
- La barre de navigation reprend les mêmes onglets que l'édition d'un élément.
- La partie édition est découpée en trois sections :
- Le nom des propriétés
- Champs d'édition
- La valeur originale du check
| Panel |
|---|
|
Surcharger une propriété
Réaliser une surcharge
La surcharge se fait en saisissant ou en sélectionnant une valeur sur une propriété ou une donnée comme
...
lors de l'édition classique d'un élément.
Une fois faite, la valeur de surcharge apparaîtra en bleu et la valeur originale du check apparaîtra en grisé .
| Info |
|---|
Sans modification, ce sont les valeurs originales du check ( en violet ) qui seront prises en compte. |
| Panel |
|---|
|
Revenir à la valeur initiale du check
Pour supprimer une surcharge uniquement sur une propriété ou une donnée, il faut :
- Pour un champ texte, supprimer la saisie.
- Pour un champ sélecteur (simple ou multiple), sélectionner dans la liste des options, l'option "-- Valeur du check --"
- Pour les autres types de champ, il faut cliquer sur le bouton "Valeur du check"
| Note |
|---|
Attention, l'icône de balai |
| Info |
|---|
|
| Info |
|---|
|
| Info |
|---|
|
Cas spécifiques
...
Dans le formulaire de la surcharge, certaines propriétés ne sont pas éditables, car cela modifierait l’intégrité du check et ainsi le but de celui-ci. Ces champs sont reconnaissables, car ils apparaissent avec l'icône 
.
La valeur de ces propriétés apparaît dans la colonne de la Valeur sur le check.
| Panel |
|---|
|
Liste des champs non éditables pour tout le monde :
- Nom du Check
- Modèle de Check hérité
- Commande de vérification
- Commande lancée par le gestionnaire d'événement
Ces champs ne peuvent être surchargés puisque cela dénaturerait le Check.
Il est conseillé de créer un nouveau Check pour surcharger cette valeur.
| Note |
|---|
Pour remplacer la commande de check par un autre, la bonne pratique est d'exclure le check pour cet hôte, et d'en créer un nouveau, puis d'attacher le nouveau Check à l'hôte ( ou modèle ). |
Certains champs ne sont verrouillés que pour les admins SI :
- Actif activé
- Passif activé
- Vérification que l'état reçu des outils externes ne soit pas expiré
- Lire et stocker les métriques
Ces champs ne peuvent être surchargés car cela dénaturerait le Check.
Il est conseillé de créer un nouveau Check pour surcharger cette valeur.
| Note |
|---|
Pour remplacer la commande de check par un autre, la bonne pratique est d'exclure le check pour cet hôte, et d'en créer un nouveau, puis d'attacher le nouveau Check à l'hôte ( ou modèle ). |
Les champs de type commande
Les champs de type commande sont des propriétés partiellement éditables. En effet, seuls les arguments de la commande peuvent être surchargés.
| Panel |
|---|
|
Les données
Les données peuvent être surchargées, mais il n'est pas possible de créer une nouvelle donnée à partir d'une surcharge.
| Panel |
|---|
|
Modèles d'hôte hérités
L'ouverture d'un formulaire de surcharge d'un check empêche la sélection ou la suppression d'un modèle dans le champ "Modèles d'hôte hérités" de l'hôte ou du modèle. En effet, la modification de ce champ peut entraîner une perte des surcharges non sauvegardées.
| Panel |
|---|
|
Les compteurs
...
Dans la barre de navigation du formulaire de surcharge, un compteur est présent sur chaque onglet afin de faciliter la recherche des surcharges sur le check.
| Info |
|---|
|
Les compteurs d'avertissement et d'erreur
| Panel |
|---|
|
Ces deux types de compteurs ont pour but d'indiquer qu'une erreur ou un avertissement est présent dans les surcharges d'un check. Ces compteurs ont été placés à plusieurs endroits :
- Sur la propriété ou donnée à l'origine du problème
- Dans les onglets de la barre de navigation
- Sur le bouton "Surchargé"
- La ligne du check
- Sur l'onglet "Check" de la barre de navigation du formulaire d'édition de l'hôte
- Sur le bouton "Sauvegarder"
Erreur spécifique
Les surcharges dupliquées
Deux surcharges sont dupliquées si ces surcharges sont sur le même hôte, sur le même check et la même propriété.
- Certaines surcharges peuvent se dupliquer ( ex : renommer un check vers un nom existant auparavant ).
- Shinken ne pouvant définir de valeur à prioriser, la première valeur est appliquée, le temps que le problème soit résolu.
- Le message d'erreur propose de choisir entre les différentes valeurs en doublon.
Tant que cette erreur est présente, il n'est pas autorisé de choisir une valeur pour la propriété.
- Le cadenas
présent matérialise ce blocage.
| Panel |
|---|
 |
Dès qu'une valeur est choisie, un bouton apparaitra proposant de valider le choix ( il est encore possible de changer de valeur ).
| Panel |
|---|
|
| Panel |
|---|
|
Dés validation, l'erreur disparait et il sera a nouveau possible de pousser les modification de cet hôte en production.
| Panel |
|---|
|
La surcharge dans les modèles d'hôte
La surcharge des checks est aussi disponible sur les modèles d'hôte, car cela évite de devoir effectuer une surcharge sur tous les hôtes qui héritent de ce modèle d'hôte.
| Info |
|---|
La réalisation de cette surcharge s'effectue de la même manière que pour un hôte. |
| Panel |
|---|
|
Affichage dans la surcharge sur l'hôte
Les surcharges effectuées au niveau du modèle d'hôte apparaîtront dans la colonne "Valeur sur le check" dans le formulaire de surcharge au niveau de l'hôte.
| Panel |
|---|
|
Surcharge et héritage additif
Pour les champs de sélection multiple où l'héritage additif est activé, les valeurs qui seront prises en compte pour la surcharge sont :
- La valeur sélectionnée par l'utilisateur (en bleu)
- La valeur originale du check (en violet)
| Note |
|---|
Lorsque l'héritage additif est actif, la valeur prise en compte sera la valeur originale du check et pas celle définie dans le modèle d'hôte. |
| Panel |
|---|
|
La surcharge et l'essai des checks
Même sans avoir sauvegardé l'élément, les surcharges effectuées sur les propriétés du check influencent le résultat de l'essai du check
Voici les propriétés concernées :
- Les arguments de la commande de vérification
- Modulation de données
- Modulation de résultat
- Les données
Surcharge inactive
Il est possible qu'une surcharge soit rendue inactive à la suite de la "disparition" du check surchargé de la configuration.
Les surcharges inactives sont listées à la fin de l'onglet Checks.
Les surcharges deviennent inactives dans différentes raisons :
- Suppression ou désactivation d'un check
- Suppression ou désactivation d'un modèle d'hôte
- Changer le champ "Modèle d'hôte hérité" de l'hôte
- Changer le champ "Attaché sur les modèles d'hôte" d'un check appliqué au modèle d'hôte.
- Modification d'une clé d'un check dupliqué automatiquement.
- Mauvaise définition d'une surcharge dans l'import d'une source
| Panel |
|---|
...
|
Rattacher une surcharge inactive
Pour rattacher une surcharge inactive à un check, il faut faire l'action inverse que ce qui a rendu la surcharge inactive.
C'est-à-dire soit :
- Recréer un check avec le même nom et l'attacher à l'hôte ou à un de ses modèles
- Rajouter un modèle d'hôte avec un check qui possède le même nom.
- Modifier la source pour attribuer la surcharge au bon check.
- Modifier la donnée d'un check duplicate for each pour
...
- qu'un des checks duplicate for each
...
- ait le bon nom.
Une fois ces modifications effectuées, les surcharges inactives se rattachent automatiquement à leur check.
| Info |
|---|
Le fait de rattacher les surcharges inactive à n'importe quel check qui revient avec le même nom permet de ne pas perdre la configuration. Exemple : Une surcharge de check configure le check CPU pour ne pas envoyer de notification → On décide de changer le check CPU de cet hôte d'une vérification par SSH en SNMP |
...
envoyées. Par contre, les paramètres des checks lié |
...
à la commande comme :
Resteront sur la surcharge du |
...
nouveau check mais ne seront surement plus |
...
utiles, il est préconisé de les modifier ou de les supprimer. |
Compteur de surcharge inactive
La présence de surcharges désactivées est indiquée par un compteur d'avertissements sur le nom de l'onglet Checks
| Panel |
|---|
|
Supprimer une surcharge inactive
Si une surcharge inactive n'est plus effective, il est possible de la supprimer à l'aide de lde l'icône de balai au niveau du nom du check ( 
) situé sur chaque ligne du tableau des surcharges désactivées.
Surcharges au format Cfg
Les surcharges réalisées sur les checks sont affichées au format Cfg sous la liste des checks. Cela peut être utile pour dupliquer la configuration avec des fichiers .cfg.
En survolant à l'aide de la souris, un bouton permettant de copier le texte apparaît.
| Panel |
|---|
|
