Contexte
Le check Broker - $KEY$ - Module Livedata affiche les statistiques des requêtes effectuées comme :
- le nombre de requêtes effectuées sur la dernière heure,
- et le temps de réponse moyen des requêtes.
Paramétrage
Le check utilise la ligne de commande suivante :
$PLUGINSDIR$/check_shinken -H "$HOSTADDRESS$" -p "$ARG2$" --shinkenversion "$SHINKENVERSION$" -t broker -m $ARG1$ -n $ARG3$ --livedata_warning "$_HOSTLIVEDATA_WARNING$" --livedata_error_displayed_limit "$_HOSTLIVEDATA_DISPLAYED_ERROR_LIMIT$" --timeout "$_HOSTCHECK_SHINKEN_TIMEOUT$"
Les données
Données utilisées provenant du modèle
Provenant du modèle shinken-daemon
| Nom | Modifiable sur | Unité | Défaut | Valeur par défaut à l'installation de Shinken | Description |
|---|---|---|---|---|---|
THRESHOLD_CPU_STOLEN_CRITICAL | l'Hôte ( Onglet Données ) | % | 10 | 10 | Seuil de CPU volé sur une machine virtuelle supervisée par VMware avant de déclencher un critique. |
THRESHOLD_CPU_STOLEN_WARNING | l'Hôte ( Onglet Données ) | % | 5 | 5 | Seuil de CPU volé sur une machine virtuelle supervisée par VMware avant de déclencher un warning. |
Données spécifiques pour ce check
| Nom | Modifiable sur | Unité | Défaut | Valeur par défaut à l'installation de Shinken | Description |
|---|---|---|---|---|---|
LIVEDATA_WARNING | L'hôte ( Onglet Données ) | --- | 1 | 1 | Permet de ne pas mettre le check en avertissement si des requêtes sont en erreur ou qu'il y a un avertissement lié à un problème de configuration.
|
LIVEDATA_DISPLAYED_ERROR_LIMIT | L'hôte ( Onglet Données ) | --- | 5 | 5 | Détermine le nombre limite des derniers retours d'erreur affichés dans le résultat long. |
LIVEDATA_MODULE_NAME | L'hôte ( Onglet Données ) | --- | broker-module-livedata | broker-module-livedata | Nom du module livedata à superviser ( replace $ARG3$ dans la commande ) |
Les données DFE ( Duplicate Foreach )
l'Hôte ( Onglet Données ) Liste des machines ayant les module Livedata ( voir la page Module broker-module-livedata )Nom Modifiable sur Unité Défaut Valeur par défaut à l'installation de Shinken Description MODULE_LIVEDATA_LIST
--- --- ---
Check(s) impacté(s) :
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
Interprétation
Statut
Il peut prendre deux valeurs OK / 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 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
- statistique du nombre d'événements géré dans la dernière minute
Résultat Long
Pas de résultat long pour ce check.
Description des erreurs
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
Cas supplémentaire
En plus de donner les statistiques de requêtes, le check affiche le nombre de requêtes en erreur sur la dernière heure avec dans la colonne résultat long, les retours d'erreur des dernières requêtes n'ayant pas réussi à s'effectuer.
Cela permet à l'utilisateur de voir si toutes les requêtes sont correctement effectuées et de voir quel est la nature des dernières erreurs. L'affichage des retours d'erreur est paramétrable via la donnée LIVEDATA_DISPLAYED_ERROR_LIMIT ( voir ci-dessous ).
Ci-contre, il y a une requête en erreur, car il n'y a soit aucun token donné, soit que le token donné au moment de la requête n'est pas le bon.
Le check affiche aussi les informations liées à la configuration du module et les éventuelles erreurs de configuration. Comme dans l'exemple ci-contre où le token du module n'a pas été changer lors de la configuration du module et utilise toujours celui par défaut.
Le check informe sur quel type de connexion sont les requêtes sont effectuées HTTP ou HTTPS.
Métriques
| Nom | Unité | Description |
|---|---|---|
livedata_average_response_time | seconde | Temps moyen des réponses |
livedata_error_percent | % | Pourcentage de requêtes en erreur |
livedata_nb_error_last_hour | --- | Nombre de requêtes en erreur sur la dernière heure |
livedata_nb_request_last_hour | --- | Nombre de requêtes traité sur la dernière heure |