Contexte
Le check Broker - $KEY$ - Module Report Builder - Running Well permet de contrôler le bon fonctionnement du module broker--module-report-builder ( voir la page Module broker--module-report-builder ) au niveau du démon Broker ( voir la page Le Broker ).
Paramétrage
Le check utilise la ligne de commande suivante :
$PLUGINSDIR$/check_shinken_broker_module_report_builder.py -H "$HOSTADDRESS$" -p "$ARG1$" -r "$ARG2$" -m "$ARG3$" --timeout "$_HOSTCHECK_SHINKEN_TIMEOUT$" --shinkenversion "$SHINKENVERSION$" -n "$_HOSTNB_LINE_UNAVAILABILITY$"
Données utilisées provenant du modèle
Données communes pour les checks du modèle
| Nom | Modifiable sur | Unité | Défaut | Valeur par défaut à l'installation de Shinken | Description |
|---|---|---|---|---|---|
CHECK_SHINKEN_TIMEOUT | l'Hôte ( Onglet Données ) | seconde | 3 | 3 | Temps maximum durant lequel le check va attendre une réponse du démon. |
Données spécifiques pour ce check
| Nom | Modifiable sur | Unité | Défaut | Valeur par défaut à l'installation de Shinken | Description |
|---|---|---|---|---|---|
BROKER_PORT | Modèle d'hôte ( Onglet Données ) | --- | 7772 | 7772 | Configuration du port de communication avec le Broker. |
REPORT_BUILDER_MODULE_NAME | Modèle d'hôte ( Onglet Données ) | --- | broker--module-report-builder | broker--module-report-builder | Nom du module de rapport pour lequel chercher les informations. |
NB_LINE_UNAVAILABILITY | l'Hôte ( Onglet Données ) | --- | 5 | 5 | Nombre des dernières configurations reçues, ainsi que le temps d'indisponibilité du module causé par leur réception à afficher dans le résultat long.. |
Les données DFE ( Duplicate Foreach )
| Nom | Modifiable sur | Unité | Défaut | Valeur par défaut à l'installation de Shinken | Description |
|---|---|---|---|---|---|
MODULE_REPORT_BUILDER_LIST | l'Hôte ( Onglet Données ) | --- | broker-master-broker--module-report-builder$($_HOSTBROKER_PORT$)$$($_HOSTREPORT_BUILDER_MODULE_NAME$)$$($_HOSTREPORT_BUILDER_MODULE_SLA_MODULE_NAME)$ | broker-master-broker--module-report-builder$($_HOSTBROKER_PORT$)$$($_HOSTREPORT_BUILDER_MODULE_NAME$)$ | Liste de modules à superviser sur le Broker. |
Données utilisées provenant du check
Pas de données spécifiques pour ce check.
Données globales
Nom | Modifiable sur | Unité | Défaut | Valeur par défaut à l'installation de Shinken | Description |
|---|---|---|---|---|---|
PLUGINSDIR | Non modifiable ( Sauf Admin Shinken ) | --- | /var/lib/shinken/libexec | /var/lib/shinken/libexec | Chemin absolu du dossier contenant la sonde ( non modifiable ). |
SHINKENVERSION | Non modifiable | --- | --- | --- | Numéro de version du shinken utilisé pour la comparaison avec le shinken surveillé. |
Propriétés de l'hôte
l'Hôte ( Onglet Général ) --- Adresse de l'hôteNom Modifiable sur Unité Défaut Valeur par défaut à l'installation de Shinken Description HOSTADDRESS
Nom de l'hôte Nom de l'hôte
Résultat
Exemple
Il n'y a pas de rapport en cours de génération
Un rapport est en cours de génération
Interprétation
Statut
Il peut prendre les valeurs OK / CRITIQUE / ATTENTION / INCONNU .
- Le statut va dépendre du retour de sonde et de la configuration spécifique du check pour les données suivantes :
- CHECK_SHINKEN_TIMEOUT
- CHECK_SHINKEN_TIMEOUT
Voici un tableau récapitulatif du statut attendu suivant le retour de sonde :
Les vérifications spécifiques
Situation | Statut |
|---|---|
Le module broker--module-report-builder n'est pas présent sur le Broker, ou son nom ne correspond pas. | CRITIQUE |
Le Broker est en cours d'arrêt. | ATTENTION |
La configuration de certains des paramètres d'accès au module mérite d'être revue. | ATTENTION |
Si la sonde n'a pas eu de réponse avant le temps maximum :
| INCONNU |
Résultat
Renvoi au format texte :
- Si le module fonctionne correctement.
- Un récapitulatif des paramètres d'accès au module.
Résultat Long
Ce check va afficher un récapitulatif sur les cinq dernières configurations reçues, ainsi que le temps d'indisponibilité qu'a pu générer le chargement de chaque configuration.
Pour chaque configuration reçue, les informations suivantes sont présentées :
- La date de création de la configuration ;
- Le nom de l'Arbiter ayant envoyé la configuration ;
- Le nom de l'architecture ;
- UUID de la configuration ;
- L'heure du début de l'indisponibilité du module ;
- Le nombre de parties de configuration reçues ( quand il y a plusieurs Schedulers ) ;
- Le temps d'indisponibilité du module.
Description des erreurs
Le module n'a pas été trouvé sur le Broker
Lorsqu'il est impossible de trouver un module de génération de rapport avec le bon nom sur le Broker, le check le remonte comme une erreur :
Le Broker est en cours d'arrêt
Lorsque le Broker est en cours d'arrêt, le check le signale, et les informations relatives au module ne sont plus disponibles :
Certains des paramètres d'accès au module mérite d'être revus
Utilisation du token par défaut
Le module est configuré avec la valeur par défaut du token :
Utilisation d'un token vide
Le module est configuré avec un token vide :
Métriques
| Nom | Unité | Description |
|---|---|---|
nb_checks | --- | Nombre de checks géré par le module. |
nb_clusters | --- | Nombre de clusters géré par le module. |
nb_contacts | --- | Nombre d'utilisateurs géré par le module. |
nb_hosts | --- | Nombre d'hôtes géré par le module. |
unavailability_time_per_minute | --- | Temps d'indisponibilité du module par minute. |