Versions Compared

Old Version 1

changes.mady.by.user Soubrié Grégoire

Saved on

compared with

New Version Current

changes.mady.by.user Soubrié Grégoire

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Make by tools (01.00.01) - action=clean_macro_parameter
Scroll Ignore
scroll-pdftrue
scroll-officetrue
scroll-chmtrue
scroll-docbookhtmltruefalse
scroll-eclipsehelpdocbooktrue
scroll-epubeclipsehelptrue
scroll-htmlepubtrue
Panel
titleSommaire

Table of Contents
stylenone

Contexte

Le check Broker - $KEY$ - Module Visualisation UI - Event Manager Reader permet de superviser la lecture des données par le module Event Manager au niveau du module WebUI du démon broker- Service Weather - Running Well permet de connaitre l'état du module.

En vérifiant si :

  • Si la connexion avec la base MongoDB est en vie

  • Si le cache du module de la Météo des services fonctionne correctement

  • Le nombre des météos services les plus utilisés

  • Le nombre des liens externes les plus utilisés

Et affiche plusieurs informations sur l’utilisation du module :

  • Le nombre de services météo affiché

  • Le nombre de services météo géré

  • Le nombre de liens externes

  • Le nombre de requêtes effectuées sur les météos sur les 5 dernières minutes

Info

Si aucune météo n'a été visitée depuis ces 5 dernières minutes, alors la partie "Résultat long" du check ne sera pas affichée ( contenant des statistiques des météos les plus populaires lors des 5 dernières minutes ).

Panel

Image Added

Panel

Image Removed

Paramétrage

Le check utilise la ligne de commande suivante :

Code Block
languagetext
themeEmacs
$PLUGINSDIR$/check_shinken_broker_module_visualisation_ui_eventservice_manager_readerweather.py -H "$HOSTADDRESS$" -p "$ARG1$" -t broker -m $ARG2$ -M $ARG3$ -n 
-w "$ARG2$" --shinkenversion "$SHINKENVERSION$" -m "$_HOSTMINUTES_OF_STATS$" --timeout "$_HOSTCHECK_SHINKEN_TIMEOUT$$ARG4$ --timeout "$_HOSTCHECK_SHINKEN_TIMEOUT$" --threshold-count-service-weather-warning "$_HOSTTHRESHOLD_COUNT_SERVICE_WEATHER_WARNING$" 
--threshold-count-service-weather-critical "$_HOSTTHRESHOLD_COUNT_SERVICE_WEATHER_CRITICAL$" 
--threshold-of-maximum-requests-last-5-minutes-counter-ddos "$_HOSTTHRESHOLD_OF_MAXIMUM_REQUESTS_LAST_5_MINUTES_COUNTER_DDOS$" 
--threshold-average-slowest-5-last-run-service-weather-computing-by-cache-warning "$_HOSTTHRESHOLD_AVERAGE_SLOWEST_5_LAST_RUN_SERVICE_WEATHER_COMPUTING_BY_CACHE_WARNING$" 
--threshold-average-slowest-5-last-run-service-service-weather-computing-by-cache-critical "$_HOSTTHRESHOLD_AVERAGE_SLOWEST_5_LAST_RUN_SERVICE_WEATHER_COMPUTING_BY_CACHE_CRITICAL$"

Données utilisées provenant du modèle

Données communes pour les checks du modèle

Excerpt Include
Modèle shinken
Modèle shinken
nopaneltrue

Données spécifiques pour ce check

NomModifiable sur UnitésDéfautValeur par défaut à l'installation de ShinkenDescription
No Format
THRESHOLD_COUNT_SERVICE_WEATHER_WARNING

Modèle d'hôte

( Onglet Données )

---10 10
No FormatMINUTES_OF_STATS

Seuil du nombre maximum de météos des services créés avant que le statut du check ne passe en  WARNING .

No Format
THRESHOLD_COUNT_SERVICE_WEATHER_CRITICAL

Modèle d'hôte

( Onglet Données )

---
11Nombre des X dernières minutes utilisées pour calculer les statistiques
20 20

Seuil du nombre maximum de météos des services créés avant que le statut du check ne passe en   CRITICAL .

No Format
THRESHOLD_AVERAGE_SLOWEST_5_LAST_RUN_SERVICE_WEATHER_COMPUTING_BY_CACHE_WARNING

Modèle d'hôte

( Onglet Données )

seconde5 5

Seuil du temps moyen de calcul en seconde que le cache prend pour calculer une météo des services durant les cinq dernières périodes de temps de calcul du cache. Si le seuil est dépassé, le statut du check passera en  WARNING .

No Format
THRESHOLD_AVERAGE_SLOWEST_5_LAST_RUN_SERVICE_WEATHER_COMPUTING_BY_CACHE_CRITICAL

Modèle d'hôte

( Onglet Données )

seconde10 10

Seuil du temps moyen de calcul en seconde que le cache prend pour calculer une météo des services durant les cinq dernières périodes de temps de calcul du cache. Si le seuil est dépassé, le statut du check passera en CRITICAL .

No Format
THRESHOLD_OF_MAXIMUM_REQUESTS_LAST_5_MINUTES_COUNTER_DDOS

Modèle d'hôte

( Onglet Données )

---150 150

Seuil du nombre maximum de requêtes sur les liens externes des météos des services avant de considérer que le lien subit une attaque par DDoS (  Attaque par déni de services   ).
Si le seuil est dépassé, le check passera en CRITICAL .

Les données DFE ( Duplicate Foreach )

 

Excerpt Include
Modèle shinken-broker-module-visualisation-ui-eventservice-manager-readerweather
Modèle shinken-broker-module-visualisation-ui-eventservice-manager-readerweather
nopaneltrue

Données utilisées provenant du check

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

Données globales

Excerpt Include
Documentation sur les packs de supervision
Documentation sur les packs de supervision
nopaneltrue

Propriétés de l'hôte

Excerpt Include
Mise en place du Pack windows
Mise en place du Pack windows
nopaneltrue

Résultat

Exemple

Panel

Image RemovedImage Added



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 :
    • THRESHOLD_OF_MAXIMUM_REQUESTS_LAST_5_MINUTES_COUNTER_DDOS
    • CHECK_SHINKEN_TIMEOUT

  • Voici un tableau récapitulatif du statut attendu suivant le retour de sonde :

Les vérifications spécifiques

Situation

Statut

En fonction du nombre de requêtes sur les liens externes  :

  • Si c'est supérieur à THRESHOLD_OF_MAXIMUM_REQUESTS_LAST_5_MINUTES_COUNTER_DDOS ( par défaut : 10 sec  )

CRITIQUE

Le module WebUI n'a pas de sous module

CRITIQUE

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

Le résultat du check donne le statut de l'accès aux données de l'Event manager.

Le résumé sur la dernière minute contient: 

  • Le nombre d'appel à la page de l’Event manager.
  • Le temps de traitement par la WebUI pour répondre aux appels.
  • Le temps moyen par appel. 

Résultat Long

Deux tableaux d'information sont affichés.

Le premier indique le statut d'utilisation des météos des services.

Le second tableau affiche l'état du fonctionnement du module en vérifiant si le système de cache fonctionne correctement et si le module est toujours connecté avec la base MongoDB.


Panel

Image Added

Statut des météos des services

Le tableau du statut des météos des services comporte 4 lignes : 

Nom de la ligne

Description

Services weathers(s) displayed

Nombre de météos des services que le module affiche.

Ce paramètre a une influence sur le statut du check et est paramétrable via les données THRESHOLD_COUNT_SERVICE_WEATHER_WARNING et THRESHOLD_COUNT_SERVICE_WEATHER_CRITICAL .

Services weather(s) managed

Nombre de météos des services que le module gère. ( voir la page Fonctionnement du cache - Météo ).

External link(s)

Nombre total de liens externe généré. ( voir la page Voir les liens externes - Météo)

Requests in the last 5 minutes

Nombre total de requêtes HTTP sur les météos des services pendant les cinq dernières minutes.

Panel

Image Added

État du module

Le tableau sur l'état du module comporte 2 lignes : 

Nom de la ligne

Description

Cache running well

État du cache du module. ( voir la page Fonctionnement du cache - Météo).

Mongo connection

État de la connexion à MongoDB.

Panel

Image Added

Résultat Long

Deux tableaux sont affichés. Le premier affiche les météos des services les plus populaires durant les cinq dernières minutes.

Le second affiche les liens externes les plus populaires durant les cinq dernières minutes.

Info

S'il n'y a eu aucune requête sur les météos des services ou sur les liens externes ces cinq dernières minutes, alors les tableaux concernés ne seront pas affichés.

Panel

Image Added

Les liens externes des météos des services les plus populaires depuis les cinq dernières minutes

Le tableau comporte plusieurs paramètres :

Nom du paramètre

Description

Link Name

Nom du lien externe. ( voir la page Edition des liens externes - Edition - Météo ).

Service weather title

Nom de la météo des services. ( Nom basés sur le nom paramétré sur le widget titre, voir la page Widget Titre - Edition - Météo).

Total requests

Nombre total des requêtes sur le lien externe.

Threshold DDoS

Seuil du nombre maximum de requêtes sur les liens externes des météos des services avant de considérer que le lien subit une attaque DDoS ( Attaque par déni de services ).
Si le paramètre Total requests dépasse ce seuil, le check passera en CRITICAL .
Ce seuil est paramétrable en modifiant la valeur de la donnée THRESHOLD_OF_MAXIMUM_REQUESTS_LAST_5_MINUTES_COUNTER_DDOS

Panel

Image Added

Info

Seulement les trois liens externes des météos des services les plus populaires sont affichés.
Néanmoins, tous les liens externes dépassant le seuil DDoS seront affichés.

Les météos des services les plus populaires depuis les cinq dernières minutes

Le tableau sur Les météos des services les plus populaires comportent trois paramètres :

Nom du paramètre

Description

Services weather title

Nom de la météo des services. ( Nom basés sur le nom paramétré sur le widget titre, voir la pageWidget Titre - Edition - Météo).

Configuration issues

Nombre d'erreurs de configuration des météos des services.
Si une des météos des services parmi les plus populaires possède une erreur de configuration, le check passera en CRITICAL ou en WARNING en fonction de l'erreur.

Total requests

Nombre total des requêtes sur les météos des services. Le total prend en compte les liens externes générés.

Weather WidgetsNombre de Weather Widgets présente dans la météo des services.
Panel

Image Added

Info

Seulement les trois météos des services les plus populaires sont affichées.

Le résultat long donne le détail des informations des appels traités par la WebUI.

La partie In the last 1 minute donne les informations suivantes :

  • Le nombre d'appels traités.
  • Le temps passé pour traiter ces demandes.
  • Le nombre d'événements lu dans la base.

La partie Event info donne les informations suivantes : 

  • La date de l'événement le plus vieux en base.
  • La date de l'événement le plus vieux lu sur les dernières 24h.

La partie Top requests donne la liste des 5 appels les plus longs sur les dernières 24h

La liste contient l'appel avec ces paramètres et son filtre.

  • Request type :
    Les types sont : 
    •  History,
    • Widget,
    • Report.
  • Endpoint : contient les paramètres de l'appel, ce qui peut permettre de comprendre pourquoi un appel est long : Par exemple, un rapport sur une année entière et 200 éléments peut être long à générer.
    • Time taken :  temps par requête en millisecondes.
    Info

    Les informations sur les dernières 24h ne sont pas sauvegardées par le deamon donc si il redémarre ces informations sont remises à zéro.

    Panel

    Image Removed

    Description des erreurs

    Le module WebUI n'a pas de sous modules
    Panel

    Image Modified

    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

    Image RemovedImage Added

    Métriques

    La métrique oldest_event_read_from_now permet de mesurer la pertinence de la valeur day_keep_data.

    En effet si par exemple vous avez mis day_keep_data à 30 jours et que sur l'année dernière vous n'avez pas fait d'appel pour lire une donnée plus vielle que 5 jours vous pouvez réduire le nombre de jour sauvegardés et ainsi limiter la taille de la base sereinement

    Nom

    Unité

    Description

    eventtotal_page_readrequests_in_last_min
    		---

    Nombre d'événements lu dans la dernière minute

    request_time_in_last_min
    		seconde

    Temps de traitement des appels de la dernière minute

    oldest_event_read_from_nowthe_last_5_minutes
    		---

    Nombre de jours entre aujourd'hui et la date de l'événement le plus vieux lu dans les dernières 24h

    request_number_in_last_min
    		---

    Nombre d'appels dans la dernière minute

    Comment interpréter les données des métriques

    Configuration de day_keep_data 

    requêtes sur les météos des services durant les 5 dernières minutes.