Contexte

Le check Broker - $KEY$ - Module Livedata affiche les statistiques des requêtes effectuées comme :

  • le nombre de requêtes effectué 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$"

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

NomModifiable sur UnitésDéfautValeur par défaut à l'installation de ShinkenDescription
LIVEDATA_WARNING

Modèle d'hôte

( Onglet Données )

---11

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. 

  • 0 = désactive les avertissements
  • 1 = active les avertissements
LIVEDATA_DISPLAYED_ERROR_LIMIT

Modèle d'hôte

( Onglet Données )

---55

Détermine le nombre limite des derniers retours d'erreur affichés dans le résultat long.

LIVEDATA_MODULE_NAME

Modèle d'hôte

( Onglet Données )

---broker-module-livedatabroker-module-livedata

Nom du module livedata à superviser

( replace $ARG3$ dans la commande )

Les données DFE ( Duplicate Foreach )

 

Données utilisées provenant du check

Pas de données spécifiques pour ce check.

Données globales

Propriétés 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

  • 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

  • Si supérieur à CHECK_SHINKEN_TIMEOUT (  par défaut : 3 sec )
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, nous pouvons constater qu'il y a une requête en erreur, car il y a soit aucun token donnée soit que le token donnée 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.

Nous pouvons voir aussi que le check informe sur quel type de connexion sont les requêtes sont effectuées HTTP ou HTTPS.

Métriques

NomUnité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