| Scroll Ignore | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||
|
Contexte
Le check Broker - $KEY$ - Module Visualisation UI va afficher l'état d'une WebUI ainsi que les dernières configurations qu'elle a reçues
| Panel |
|---|
Paramétrage
Le check utilise la ligne de commande suivante :
| Code Block | ||||
|---|---|---|---|---|
| ||||
$PLUGINSDIR$/check_shinken_broker_module_visualisation_ui.py -H "$HOSTADDRESS$" -p "$ARG1$" -w "$ARG2$" --shinkenversion "$SHINKENVERSION$" --timeout "$_HOSTCHECK_SHINKEN_TIMEOUT$" -n "$_HOSTNB_LINE_UNAVAILABILITY$" |
Données utilisées provenant du modèle
Données communes pour les checks du modèle
Nom | Modifiable sur | Défaut | Valeur par défaut à l'installation de Shinken | Description |
|---|---|---|---|---|
CHECK_SHINKEN_TIMEOUT | l'Hôte ( Onglet Données ) | 3 | 3 | Temps maximum durant lequel les checks peuvent s'exécuter ( en secondes ). |
Données spécifiques pour ce check
| Nom | Modifiable sur | Unités | Défaut | Valeur par défaut à l'installation de Shinken | Description | ||
|---|---|---|---|---|---|---|---|
| Modèle d'hôte ( Onglet Données ) | --- | 5 | 5 | Quantité de configurations présentent dans le résultat long |
Les données DFE ( Duplicate Foreach )
Excerpt Include Modèle shinken-broker-module-visualisation-ui Modèle shinken-broker-module-visualisation-ui nopanel true
Données utilisées provenant du check
Pas de données spécifiques pour ce check.
Paramètre du check
- Vu que le check est exécuté sur un Poller, il faut permettre à ce dernier d'accéder aux serveurs graphite en SSH.
- D’où la nécessité de paramétrer les données SSH_KEY, SSH_KEY_PASSPHRASE, SSH_PORT, SSH_USER.
- REMARQUE : il est obligatoire en l’état du check actuel que cette même clef soit autorisée sur tous les serveurs graphites surveillés.
- Si un autre check Shinken a déjà été paramétré avec une clé SSH pour accéder au serveur graphite, vous pouvez bien sûr reprendre cette même clé.
Données globales
| Excerpt Include | ||||||
|---|---|---|---|---|---|---|
|
Propriétés de l'hôte
| Excerpt Include | ||||||
|---|---|---|---|---|---|---|
|
Résultat
Exemple
| Panel |
|---|
Interprétation
Statut
Il peut prendre deux 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 Graphite backend d'un royaume utilise un port non valide | CRITIQUE |
Le Graphite backend d'un royaume utilise n'a pas d'adresse | CRITIQUE |
Un ou plusieurs royaumes n'ont pas de Graphite backend | CRITIQUE |
Le Graphite backend d'un royaume n'utilise pas un protocole valide | CRITIQUE |
Un ou plusieurs royaumes n'est pas géré par le Broker | ATTENTION |
Le Broker est en cours d'arrêt | 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
Résultat Long
Ce check va afficher l'état d'une WebUI ainsi que les dernières configurations qu'elle a reçues
Pour chaque configuration qu'elle a reçue, nous avons :
- 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é de la WebUI
- Parties de configuration de surveillance reçues
- Le temps d'indisponibilité de la WebUI
Description des erreurs
Le Graphite backend d'un royaume utilise un port non valide
Si dans le graphite_backends d'une WebUI, une adresse utilise un port HTTP non valide, alors une erreur est remontée dans le check.
Par exemple, le graphite_backends suivant va remonter une erreur :
graphite_backends *:127.0.0.1:80, Italie:192.168.1.26:80, Japon:127.0.0.1:invalid_port
Les métriques ne seront alors pas disponibles pour ce royaume.
| Panel |
|---|
Le Graphite backend d'un royaume
utilisen'a pas d'adresse
Si dans la définition d'un Graphite backend d'un royaume, l'adresse ( ou l'IP ) est manquante, alors une erreur est remontée.
Par exemple, le graphite_backends suivant va remonter une erreur :
graphite_backends *:127.0.0.1:80, Italie::80, Japon:127.0.0.1:80
Les métriques ne seront alors pas disponibles pour ce royaume.
| Panel |
|---|
Un ou plusieurs royaumes n'ont pas de Graphite backend
Si dans la définition d'un graphite_backends, un ou plusieurs royaumes n'ont pas d'adresse définie, mais qu'
ilils sont quand même gérés par le Broker, alors une erreur sera remontée dans le check.
Par exemple, un Broker gère les royaumes suivants : All, France, Italie, Japon
Maintenant, une des WebUI du Broker a le graphite_backends suivant :
graphite_backends France:192.168.1.23:80
Alors, les royaumes "All, Italie et Japon" n'ont pas de Graphite backend défini par la WebUI, ce qui aura pour conséquence que les éléments de ces royaumes n'auront pas accès à leurs métriques.
| Panel |
|---|
Le Graphite backend d'un royaume n'utilise pas un protocole valide
Si la définition d'un Graphite backend utilise un protocole qui n'est pas valide, le check remonte une erreur pour le backend concerné.
Par exemple, le graphite_backends suivant va remonter une erreur :
graphite_backends *:192.168.1.23:80, France:htt://192.168.1.23:80
Les métriques ne seront alors pas disponibles pour ce royaume.
| Panel |
|---|
Un ou plusieurs royaumes
n'est pas géréne sont pas gérés par le Broker
Le check nous averti lorsqu'un royaume est présent dans la définition des graphite_backends de la WebUI et que celui-ci n'est pas géré par le Broker.
Par exemple, un Broker gère les royaumes : All, France, Italie, Japon
Mais la définition d'une de ses WebUI est la suivante :
graphite_backends *:127.0.0.1:80, Canada:192.168.1.44
Dans ce cas, le royaume Canada n'est pas géré par le Broker et sera donc ignoré.
Ce problème ne bloque pas le fonctionnement du module, il suffit juste d'enlever ou de corriger l'adresse de ce royaume dans la configuration de la WebUI pour enlever cet avertissement.
| Panel |
|---|
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
| Panel |
|---|
Métriques
| Nom | Unité | Description | |||||||
|---|---|---|---|---|---|---|---|---|---|
| --- | Nombre de checks géré par la WebUI | |||||||
| --- | Nombre de clusters géré par la WebUI | |||||||
| --- | Nombre de contacts géré par la WebUI | |||||||
| --- | Nombre d'hôtes géré par la WebUI | |||||||
| minute | Le temps d'indisponibilités de la WebUI par minutes |






