Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Panel
titleSommaire

Table of Contents
maxLevel3
stylenone


Présentation

Le module architecture-export effectue deux types d'actions distinctes :

  • Modification de la configuration de NagVis afin de permettre la communication entre NagVis et Shinken
  • Création des cartes d'une architecture Shinken pour NagVis

Chaque action est retranscrite dans les logs de l'arbiter

Panel
titleSommaire
Table of Contentsstylenone

Les logs de modification de la configuration de NagVis

Lecture de la configuration du module

Au démarrage du module, celui-ci va commencer par lire sa propre configuration afin de vérifier que les informations sont bonnes (voir Module architecture-export)

En INFO seront affichés les étapes de lecture de la configuration. En DEBUG seront affichés les détails de lecture de la configuration, tels que les paramètres récupérés.

Exemple


Note

Tous les logs de modification/lecture sont écrits deux fois. Ceci est dû au fait que nous fournissons deux installations NagVis distinctes, chacune d'entre elles est concernée par ces modifications/lectures : 

nagvis-shinken-architecture, qui est celui sur lequel nous mettons à disposition des cartes générées automatiquement

nagvis, qui lui ne contient aucune carte générée par Shinken


Lecture de la configuration du module [ READING CONFIGURATION ]

Au démarrage du module, celui-ci va commencer par lire sa propre configuration afin de vérifier que les informations sont bonnes ( voir Module architecture-export )

Il est ainsi possible de voir toutes les étapes de la lecture de la configuration.

Exemple

Voici un exemple d'une lecture de configuration du module ayant réussie :

Code Block
themeEmacs
[YYYY-

Voici un exemple d'une lecture de configuration du module ayant réussie

Code Block
languagejs
themeEmacs
[AAAA-MM-DD HH:MM:SS] INFO   : [ arbiter ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ READING CONFIGURATION ] Broker [ broker ] found from parameter [ architecture_export__broker_connection__broker_name ]
[AAAAYYYY-MM-DD HH:MM:SS] INFO DEBUG  : [ ARBITER_NAME    arbiter ] [ ARCHITECTURE-EXPORT ] [ READING CONFIGURATION ] Broker [ broker ] found
[AAAA-MM-DD HH:MM:SS] INFO   : [ arbiter ] [ ARCHITECTURE-EXPORT ] [ READING CONFIGURATION ] WebUI moduleWebUI module [ WebUI ] found from parameter [ architecture_export__broker_connection__broker_webui_target ]
[AAAAYYYY-MM-DD HH:MM:SS] INFO DEBUG  : [ ARBITER_NAME    arbiter ] [ ARCHITECTURE-EXPORT ] [ READING CONFIGURATION ] The WebUI address is [ localhost ], we will use its public address [ http://192.168.1.119:7767 ] for WebUI redirection
[AAAAYYYY-MM-DD HH:MM:SS] INFO DEBUG  : [ arbiter ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ READING CONFIGURATION ] Livestatus WebUImodule [ WebUILivestatus ] found, from itsparameter address is http://192.168.1.119:7767
[AAAA[ architecture_export__broker_connection__broker_livestatus ]
[YYYY-MM-DD HH:MM:SS] INFO DEBUG  : [ arbiter ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ READING CONFIGURATION ] The Livestatus address is [ localhost ], we will use its public address [ 192.168.1.119 ] for WebUI redirection
[AAAA-MM-DD HH:MM:SS] INFO   : [ arbiter ] [ ARCHITECTURE-EXPORT ] [ READING CONFIGURATION ] Livestatus module found from parameter [ :50000 ] 


Cas d'erreurs

Si le Broker renseigné dans le paramètre architecture_export__broker_connection__broker_name est introuvable, l'édition du fichier de configuration de NagVis sera annulée et ce message apparaîtra :

Code Block
themeEmacs
[YYYYlivestatus ]
[AAAA-MM-DD HH:MM:SS] DEBUGERROR  : [ ARBITER_NAME    arbiter ] [ ARCHITECTURE-EXPORT ] [ READING CONFIGURATION ] The LivestatusBroker [ Livestatusbroker ] found,set itswith addressparameter is 192.168.1.119:50000
Cas d'erreurs
[ architecture_export__broker_connection__broker_name ] do not exists. Abort edition of the nagvis config file


Si le paramètre architecture_export__broker_connection__broker_webui_communication_type est à "module" et que le module WebUI renseigné dans le paramètre architectureSi le Broker renseigné dans le paramètre architecture_export__broker_connection__broker_webui_name targetest introuvable, l'édition du fichier de la configuration de la communication entre NagVis et le module WebUI sera annulée et ce message apparaîtra :

Info

Pour plus d'informations sur ces paramètres, voir Module architecture-export


Code Block
theme
Code Block
languagejs
themeEmacs
[AAAAYYYY-MM-DD HH:MM:SS] ERROR  : [ ARBITER_NAME    arbiter ] [ ARCHITECTURE-EXPORT ] [ READING CONFIGURATION ] The WebUI brokermodule [ brokerWeb_UI ] set with parameter [ architecture_export__broker_connection__broker_webui_nametarget ] do not exists. Abort edition on the Broker [ broker-master ], we will not change the configuration of the nagvis config file communication between NagVis and the WebUI


Si le module WebUI Livestatus renseigné dans le paramètre architecture_export__broker_connection__broker_webui livestatus est introuvable, l'édition de la configuration de la communication entre NagVis et le module WebUI Livestatus sera annulée et ce message apparaîtra :

js
Code Block
language
themeEmacs
[AAAAYYYY-MM-DD HH:MM:SS] ERROR  : [ arbiter ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ READING CONFIGURATION ] The WebUILivestatus module [ WebUILivestatus ] set with parameter [ architecture_export__broker_connection__broker_webuilivestatus ] do not exists on the Broker [ broker-master ], we will not change the configuration of the communication between NagVis and the WebUI

Si le module Livestatus renseigné dans le paramètre architecture_export__broker_connection__broker_livestatus est introuvable, l'édition de la configuration de la communication entre NagVis et le module Livestatus sera annulée et ce message apparaîtra

Livestatus


Edition/Lecture de la configuration de NagVis [ CONFIGURATION ]

Après la lecture de la configuration du module, celui-ci va être face à deux options :

  • Si la configuration est bonne, la configuration de NagVis sera systématiquement mise à jour.
  • Sinon, il va simplement lire la configuration de NagVis afin de connaître son état actuel.

Exemples

Voici un exemple d'une modification de la configuration de NagVis ayant réussie :

js
Code Block
Code Block
language
themeEmacs
[AAAAYYYY-MM-DD HH:MM:SS] INFO ERROR  : [ ARBITER_NAME    arbiter ] [ ARCHITECTURE-EXPORT ] [ READING nagvis-shinken-architecture ] [ CONFIGURATION ] The Livestatus module [ Livestatus ] set with parameter [ architecture_export__broker_connection__broker_livestatus ] do not exists on the Broker [ broker-master ], we will not change the configuration of the communication between NagVis and the Livestatus

Si les paramètres architecture_export__broker_connection__broker_webui et architecture_export__broker_connection__broker_webui_redirect sont tous les deux renseignés, l'édition de la configuration de NagVis sera annulée et ce message apparaîtra

Code Block
languagejs
themeEmacs
[AAAA-MM-DD HH:MM:SS] ERROR  : [ arbiter ] [ ARCHITECTURE-EXPORT ] [ READING CONFIGURATION ] Can't use "architecture_export__broker_connection__broker_webui" and "architecture_export__broker_connection__broker_webui_redirect" at the same time. Abort edition of the NagVis config file

Edition/Lecture de la configuration de NagVis

Après la lecture de la configuration du module, celui-ci va être face à deux options :

  • Si la configuration est bonne, il va modifier la configuration de NagVis pour être en accord avec la sienne
  • Sinon, il va simplement lire la configuration de NagVis afin de connaître son état actuel

En INFO seront affichés les différentes étapes. En DEBUG seront affichés les détails, tels que les paramètres récupérés.

Exemples
 UPDATING connection between NagVis and Shinken modules
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ nagvis-shinken-architecture ] [ CONFIGURATION ] Editing /etc/shinken/external/nagvis/etc/nagvis.ini.php file
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ nagvis-shinken-architecture ] [ CONFIGURATION ]    - Setting WebUI connection to allow redirection on NagVis maps
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ nagvis-shinken-architecture ] [ CONFIGURATION ]        => "shinken_auth_protocol" parameter set to [ http ]
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ nagvis-shinken-architecture ] [ CONFIGURATION ]        => "shinken_auth_port" parameter set to [ 7767 ]
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ nagvis-shinken-architecture ] [ CONFIGURATION ]        => "shinken_auth_address" parameter set to [ 192.168.1.119 ]
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ nagvis-shinken-architecture ] [ CONFIGURATION ]        => "hosturl" parameter set to [ http://192.168.1.119:7767/detail-by-name/[host_name] ]
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ nagvis-shinken-architecture ] [ CONFIGURATION ]        => "serviceurl" parameter set to [ http://192.168.1.119:7767/detail-by-name/[host_name]/checks/[service_description] ]
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ nagvis-shinken-architecture ] [ CONFIGURATION ]    - Setting Livestatus connection to get Shinken objects status
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ nagvis-shinken-architecture ] [ CONFIGURATION ]        => "socket" parameter set to [ socket="tcp:192.168.1.119:50000" ]
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ nagvis-shinken-architecture ] [ CONFIGURATION ] File /etc/shinken/external/nagvis/etc/nagvis.ini.php edited
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ nagvis ] [ CONFIGURATION ] UPDATING connection between NagVis and Shinken modules
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ nagvis ] [ CONFIGURATION ] Edit /opt/nagvis/etc/nagvis.ini.php file
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ nagvis ] [ CONFIGURATION ]    - Setting WebUI connection to allow redirection on NagVis maps
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ nagvis ] [ CONFIGURATION ]        => "shinken_auth_protocol" parameter set to [ http ]
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ nagvis ] [ CONFIGURATION ]        => "shinken_auth_port" parameter set to [ 7767 ]
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ nagvis ] [ CONFIGURATION ]        => "shinken_auth_address" parameter set to [ 192.168.1.119 ]
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ nagvis ] [ CONFIGURATION ]        => "hosturl" parameter set to [ http://192.168.1.119:7767/detail-by-name/[host_name] ]
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ nagvis ] [ CONFIGURATION ]        => "serviceurl" parameter set to [ http://192.168.1.119:7767/detail-by-name/[host_name]/checks/[service_description] ]
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ nagvis ] [ CONFIGURATION ]    - Setting Livestatus connection to get Shinken objects status
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ nagvis ] [ CONFIGURATION ]        => "socket" parameter set to [ socket="tcp:192.168.1.119:50000" ]
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ nagvis ] [ CONFIGURATION ] File /opt/nagvis/etc/nagvis.ini.php edited


Si une erreur de configuration est présente, l'architecture-export lira simplement la configuration de NagVis afin d'afficher son état actuel :

Code Block
themeEmacs
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ CONFIGURATION ] =================================================================
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ CONFIGURATION ] DUE TO CONFIGURATION ERROR, The connection between NagVis and Shinken modules will NOT be updated
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ CONFIGURATION ] =================================================================
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ nagvis-shinken-architecture ] [ CONFIGURATION ] Reading /etc/shinken/external/nagvis/etc/nagvis.ini.php file
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ nagvis-shinken-architecture ] [ CONFIGURATION ]    - No WebUI redirection configuration found, we will keep previous NagVis configuration. Redirection to WebUI on NagVis maps may not work properly
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ nagvis-shinken-architecture ] [ CONFIGURATION ]        => "shinken_auth_protocol" parameter not changed. It is still [ http ]
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ nagvis-shinken-architecture ] [ CONFIGURATION ]        => "shinken_auth_port" parameter not changed. It is still [ 7767 ]
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ nagvis-shinken-architecture ] [ CONFIGURATION ]        => "shinken_auth_address" parameter not changed. It is still [ 192.168.1.119 ]
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ nagvis-shinken-architecture ] [ CONFIGURATION ]        => "hosturl" parameter not changed. It is still [ http://192.168.1.119:7767/detail-by-name/[host_name] ]
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ nagvis-shinken-architecture ] [ CONFIGURATION ]        => "serviceurl" parameter not changed. It is still [ http://192.168.1.119:7767/detail-by-name/[host_name]/checks/[service_description] ]
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ nagvis-shinken-architecture ] [ CONFIGURATION ]    - No Livestatus module found, we will keep previous NagVis configuration. Status of Shinken elements on NagVis maps may not work properly
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ nagvis-shinken-architecture ] [ CONFIGURATION ]        => "socket" parameter not changed. It is still [ socket="tcp:192.168.1.119:50000" ]
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ nagvis ] [ CONFIGURATION ] The connection between NagVis and Shinken modules will not be changed
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ nagvis ] [ CONFIGURATION ] Read /opt/nagvis/etc/nagvis.ini.php file
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ nagvis ] [ CONFIGURATION ]    - No WebUI redirection configuration found, we will keep previous NagVis configuration. Redirection to WebUI on NagVis maps may not work properly
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ nagvis ] [ CONFIGURATION ]        => "shinken_auth_protocol" parameter not changed. It is still [ http ]
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ nagvis ] [ CONFIGURATION ]        => "shinken_auth_port" parameter not changed. It is still [ 7767 ]
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ nagvis ] [ CONFIGURATION ]        => "shinken_auth_address" parameter not changed. It is still [ 192.168.1.119 ]
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ nagvis ] [ CONFIGURATION ]        => "hosturl" parameter not changed. It is still [ http://192.168.1.119:7767/detail-by-name/[host_name] ]
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ nagvis ] [ CONFIGURATION ]        => "serviceurl" parameter not changed. It is still [ http://192.168.1.119:7767/detail-by-name/[host_name]/checks/[service_description] ]
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ nagvis ] [ CONFIGURATION ]    - No Livestatus module found, we will keep previous NagVis configuration. Status of Shinken elements on NagVis maps may not work properly
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ nagvis ] [ CONFIGURATION ]        => "socket" parameter not changed. It is still [ socket="tcp:192.168.1.119:50000" ]
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ CONFIGURATION ] =================================================================


Les logs d'envoi/réception d'architecture [ NOM_DE_L'ARCHITECTURE ]

Un module architecture-export peut envoyer et recevoir une architecture.
Chaque architecture reçue sera cartographiée sur le module l'ayant reçu.

Envoi de son architecture

Au démarrage, l'architecture-export va envoyer son architecture à tous les "recipients" configurés dans le module.

Les logs montrent alors tous les envois effectués.

Exemple


Code Block
themeEmacs
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ ARCHITECTURE_NAME ] Sending architecture to 2 recipient(s)
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ ARCHITECTURE_NAME ] Sending architecture to [ http://127.0.0.1:7780 ]
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ ARCHITECTURE_NAME ] Sending architecture to [ http://192.168.0.15:7780 ]


Cas d'erreurs

Si une adresse ne commence pas par 'http' ou 'https' cette erreur apparaîtra :

Code Block
themeEmacs
[YYYY-MM-DD HH:MM:SS] ERROR  : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ Shinken ] External export module address "127.0.0.1" has an incorrect format ( does not start with "http://" or "https://" )
[YYYY-MM-DD HH:MM:SS] ERROR  : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ Shinken ] Due to address error, we will not send information to this address. 


Si le port d'une adresse n'a pas été spécifié, cette erreur apparaîtra :

Code Block
themeEmacs
[YYYY-MM-DD HH:MM:SS] ERROR  : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ Shinken ] No port specified in the external export module address "127.0.0.1"
[YYYY-MM-DD HH:MM:SS] ERROR  : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ Shinken ]  Due to address error, we will not send information to this address. 


Si l'adresse configuré est https mais que le port écoute en http, cette erreur apparaîtra :

Code Block
themeEmacs
[YYYY-MM-DD HH:MM:SS] ERROR  : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ Shinken ] Cannot send the architecture to [https://192.168.0.15:7780]; "[SSL: WRONG_VERSION_NUMBER] wrong version number (_ssl.c:618)" occurred, still 1 tries
[YYYY-MM-DD HH:MM:SS] ERROR  : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ Shinken ] Cannot send the architecture to [https://192.168.0.15:7780]; "[SSL: WRONG_VERSION_NUMBER] wrong version number (_ssl.c:618)" occurred, still 0 tries


Si l'adresse configuré est http mais que le port écoute en https, cette erreur apparaîtra :

Code Block
themeEmacs
[YYYY-MM-DD HH:MM:SS] ERROR  : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ Shinken ] An error occurred when sending the architecture to [http://192.168.1.59:7780]: 400 - The client sent a plain HTTP request, but this server only speaks HTTPS on this port.


Réception d'une architecture

Lors de la réception d'une architecture, nous la sauvegardons temporairement dans un fichier JSON afin de préserver son état. Ceci permet au redémarrage de l'Arbiter de connaître les architectures présentes sur son module.

Exemple


Code Block
themeEmacs
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ ARCHITECTURE_NAME ] [ 127.0.0.1 ] ask me to map its architecture
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ ARCHITECTURE_NAME ] The Architecture has been received, we will make its maps
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ ARCHITECTURE_NAME ] Save broks contents /var/lib/shinken/architecture_export_received.json


Les logs de création de carte NagVis [ MAP GENERATOR ]

Récupération des hôtes existants sur le listener-shinken

Avant tout, il nous faut récupérer les hôtes existant sur le listener-shinken étant lié à l'architecture que nous allons cartographier.
Nous affichons alors des logs expliquant ce qui a été trouvé :

Exemple

Voici un exemple de récupération d'hôtes auprès du listener-shinken

Code Block
themeEmacs
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ ARCHITECTURE_NAME ] [ MAP GENERATOR ] Making maps
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ ARCHITECTURE_NAME ] [ MAP GENERATOR ]     - Retrieving host(s) corresponding to this architecture from the Synchronizer ( via listener-shinken )
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ ARCHITECTURE_NAME ] [ MAP GENERATOR ]         => Found [ Shinken - ALL - 192.168.1.119 ]
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ ARCHITECTURE_NAME ] [ MAP GENERATOR ]         => Found [ Shinken - BORDEAUX - 192.168.1.119 ]
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ ARCHITECTURE_NAME ] [ MAP GENERATOR ]         => Found [ Shinken - GRENOBLE - 192.168.1.119 ]
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ ARCHITECTURE_NAME ] [ MAP GENERATOR ]         => Found [ Shinken - LYON - 192.168.1.119 ]
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ ARCHITECTURE_NAME ] [ MAP GENERATOR ]         => Found 4 host(s)


Cas d'erreurs

Si l'architecture-export essaye de communiquer avec le listener-shinken en HTTPS alors qu'il ne l'est pas, une erreur apparaîtra et la création de la map sera abandonnée. Pour régler ce problème, il faut modifier la configuration du module  ( voir Module architecture-export ).

Code Block
themeEmacs
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ ARCHITECTURE_NAME ] [ MAP GENERATOR ]     - Retrieving host(s) corresponding to this architecture from the Synchronizer ( via listener-shinken )
[YYYY-MM-DD HH:MM:SS] ERROR  : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ ARCHITECTURE_NAME ] [ MAP GENERATOR ]         => Tried to request the listener with HTTPS, but it failed. Verify if your listener-shinken is on HTTPS


Si l'architecture-export essaye de communiquer avec le listener-shinken en HTTP alors qu'il ne l'est pas, une erreur apparaîtra et la création de la map sera abandonnée. Pour régler ce problème, il faut modifier la configuration du module  ( voir Module architecture-export ).

Code Block
themeEmacs
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ ARCHITECTURE_NAME ] [ MAP GENERATOR ]     - Retrieving host(s) corresponding to this architecture from the Synchronizer ( via listener-shinken )
[YYYY-MM-DD HH:MM:SS] ERROR  : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ ARCHITECTURE_NAME ] [ MAP GENERATOR ]           => An error occurred when calling the Listener Shinken at 192.168.1.119:7777/shinken/listener-shinken/v1/hosts/ status [ 400 ] gave response [ The client sent a plain HTTP request, but this server only speaks HTTPS on this port. ] 


Si les identifiants de connexion au listener-shinken sont incorrects, une erreur apparaîtra et la création de la map sera abandonnée. Pour régler ce problème, il faut modifier la configuration du module ( voir Module architecture-export ).

Code Block
themeEmacs
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ ARCHITECTURE_NAME ] [ MAP GENERATOR ]     - Retrieving host(s) corresponding to this architecture from the Synchronizer ( via listener-shinken )
[YYYY-MM-DD HH:MM:SS] ERROR  : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ ARCHITECTURE_NAME ] [ MAP GENERATOR ]         => Bad login and password for the listener


Si la communication avec le listener-shinken prend trop de temps, cette erreur apparaîtra et la création de la carte sera abandonnée. Pour régler ce problème, il faut vérifier que votre listener-shinken est bien joignable.

Code Block
themeEmacs
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ ARCHITECTURE_NAME ] [ MAP GENERATOR ]     - Retrieving host(s) corresponding to this architecture from the Synchronizer ( via listener-shinken )
[YYYY-MM-DD HH:MM:SS] ERROR  : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ ARCHITECTURE_NAME ] [ MAP GENERATOR ]         => Tried to request the listener, but it timed out. 


Si la communication avec le listener-shinken est refusée ( s'il est injoignable ), cette erreur apparaîtra et la création de la carte sera abandonnée. Pour régler ce problème, il faut vérifier que votre listener-shinken est bien joignable.

Code Block
themeEmacs
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ ARCHITECTURE_NAME ] [ MAP GENERATOR ]     - Retrieving host(s) corresponding to this architecture from the Synchronizer ( via listener-shinken )
[YYYY-MM-DD HH:MM:SS] ERROR  : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ ARCHITECTURE_NAME ] [ MAP GENERATOR ]         => Tried to request the listener, but we can't contact it. 


Création de la liste des hôtes à partir de l'architecture reçue

Une fois les hôtes déjà disponible sur le listener-shinken récupérés, nous devons en modifier/créer pour être en accord avec l'architecture reçue.

Exemple

Voici l'exemple d'une génération d'un hôte de l'architecture reçue :

Code Block
themeEmacs
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ ARCHITECTURE_NAME ] [ MAP GENERATOR ]     - Building host(s) from architecture description received
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ ARCHITECTURE_NAME ] [ MAP GENERATOR ]         => Host [ Shinken - ALL - localhost ] modified
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ ARCHITECTURE_NAME ] [ MAP GENERATOR ]         => Host [ Shinken - Paris - localhost ] generated
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ ARCHITECTURE_NAME ] [ MAP GENERATOR ]         => 2 host(s) generated


Envoi des hôtes au listener-shinken

Lorsque tous les hôtes liés à l'architecture sont générés, nous les envoyons au listener-shinken.

Exemple

Voici un exemple de l'envoi d'un hôte vers le listener-shinken :

Code Block
themeEmacs
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ ARCHITECTURE_NAME ] [ MAP GENERATOR ]     - Sending host(s) to Synchronizer ( via listener-shinken )
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ ARCHITECTURE_NAME ] [ MAP GENERATOR ]         => Sending [ Shinken - ALL - localhost ]
[YYYY

Voici un exemple d'une modification de la configuration de NagVis ayant réussie

Code Block
languagejs
themeEmacs
[AAAA-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME    arbiter ] [ ARCHITECTURE-EXPORT ] [ nagvis-shinken-architectureARCHITECTURE_NAME ] [ MAP CONFIGURATIONGENERATOR ]      UPDATING  connection between=> NagVisSending and[ Shinken modules - Paris - localhost ]
[AAAAYYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ ARCHITECTURE_NAME ] [ MAP arbiterGENERATOR ] [  ARCHITECTURE-EXPORT ] [ nagvis-shinken-architecture ] [ CONFIGURATION=> ] Edit /etc/shinken/external/nagvis/etc/nagvis.ini.php file
[AAAA2 host(s) sent


Cas d'erreurs

Si l'architecture-export essaye de communiquer avec le listener-shinken en HTTPS alors qu'il ne l'est pas, une erreur apparaîtra et la création de la carte sera abandonnée. Pour régler ce problème, il faut modifier la configuration du module ( voir Module architecture-export ).

Code Block
themeEmacs
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME    arbiter ] [ ARCHITECTURE-EXPORT ] [ nagvis-shinken-architectureARCHITECTURE_NAME ] [ MAP CONFIGURATIONGENERATOR ]     - Setting WebUI connectionSending host(s) to allowSynchronizer redirection( onvia NagVislistener-shinken maps)
[AAAAYYYY-MM-DD HH:MM:SS] DEBUGERROR  : [ arbiter ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ ARCHITECTURE_NAME ] [ nagvis-shinken-architecture ] [ CONFIGURATION ]        => "shinken_auth_protocol" parameter  MAP GENERATOR ]         => Tried to request the listener with HTTPS, but it failed. Verify if your listener-shinken is on HTTPS


Si les identifiants de connexion au listener-shinken sont incorrect, une erreur apparaîtra et la création de la map sera abandonnée. Pour régler ce problème, il faut modifier la configuration du module ( voir Module architecture-export ).

Code Block
themeEmacs
[YYYYset to [ http ]
[AAAA-MM-DD HH:MM:SS] INFO DEBUG  : [ ARBITER_NAME    arbiter ] [ ARCHITECTURE-EXPORT ] [ nagvis-shinken-architectureARCHITECTURE_NAME ] [ MAP CONFIGURATIONGENERATOR ]     - Sending  => "shinken_auth_port" parameter set to [ 7767 ]
[AAAAhost(s) to Synchronizer ( via listener-shinken )
[YYYY-MM-DD HH:MM:SS] DEBUGERROR  : [ arbiter ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ nagvis-shinken-architectureARCHITECTURE_NAME ] [ MAP CONFIGURATIONGENERATOR ]         => "shinken_auth_address" parameter set to [ 192.168.1.119 ]
[AAAA Bad login and password for the listener


Si la communication avec le listener-shinken prend trop de temps (si il est injoignable), cette erreur apparaîtra et la création de la map sera abandonnée. Pour régler ce problème, il faut vérifier que votre listener-shinken est bien joignable.

Code Block
themeEmacs
[YYYY-MM-DD HH:MM:SS] INFO DEBUG  : [ arbiter ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ nagvis-shinken-architectureARCHITECTURE_NAME ] [ MAP GENERATOR ]  CONFIGURATION ]  - Retrieving host(s) corresponding to this => "hosturl" parameter set to [ http://192.168.1.119:7767/detail-by-name/[host_name] ]
[AAAAarchitecture from the Synchronizer ( via listener-shinken )
[YYYY-MM-DD HH:MM:SS] DEBUGERROR  : [ arbiter ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ nagvis-shinken-architectureARCHITECTURE_NAME ] [ MAP CONFIGURATIONGENERATOR ]         => Tried to request the listener, but it timed out. 


Désactivation des hôtes obsolètes

Des hôtes, trouvés dans le listener-shinken, liés à l'architecture reçue peuvent être obsolètes suite à une modification de l'architecture. Nous les désactivons alors du listener-shinken.

Exemple

Voici un exemple d'une désactivation d'hôtes obsolètes

Code Block
themeEmacs
[YYYY=> "serviceurl" parameter set to [ http://192.168.1.119:7767/detail-by-name/[host_name]/checks/[service_description] ]
[AAAA-MM-DD HH:MM:SS] INFO   : [ arbiter ] [ ARCHITECTURE-EXPORT ] [ nagvis-shinken-architectureARBITER_NAME     ] [ CONFIGURATION ]    - Setting Livestatus connection to get Shinken objects status
[AAAA-MM-DD HH:MM:SS] DEBUG  : [ arbiterARCHITECTURE-EXPORT ] [ ARCHITECTURE-EXPORT_NAME ] [ nagvis-shinken-architecture ] [ CONFIGURATIONMAP GENERATOR ]     - Disabling  => "socket" parameter set to [ socket="tcp:192.168.1.119:50000" ]
[AAAAold host(s) on Synchronizer ( via listener-shinken )
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME    arbiter ] [ ARCHITECTURE-EXPORT ] [ nagvis-shinken-architectureARCHITECTURE_NAME ] [ MAP CONFIGURATIONGENERATOR ]    File /etc/shinken/external/nagvis/etc/nagvis.ini.php edited
[AAAA-MM-DD HH:MM:SS] INFO => Old :host [ arbiterShinken ]- [BORDEAUX ARCHITECTURE-EXPORT- 192.168.1.119 ] disabled [on nagvissynchronizer ] [ CONFIGURATION ] UPDATING connection between NagVis and Shinken modules
[AAAAYYYY-MM-DD HH:MM:SS] INFO   : [ arbiter ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ nagvisARCHITECTURE_NAME ] [ MAP CONFIGURATIONGENERATOR ] Edit /opt/nagvis/etc/nagvis.ini.php file
[AAAA-MM-DD HH:MM:SS] INFO   : [ arbiter ] [ ARCHITECTURE-EXPORT ]=> Old host [ Shinken nagvis- ]GRENOBLE [ CONFIGURATION- 192.168.1.119 ] disabled on synchronizer  - Setting WebUI connection to allow redirection on NagVis maps
[AAAAYYYY-MM-DD HH:MM:SS] INFO DEBUG  : [ ARBITER_NAME    arbiter ] [ ARCHITECTURE-EXPORT ] [ nagvisARCHITECTURE_NAME ] [ MAP CONFIGURATIONGENERATOR ]         => "shinken_auth_protocol" parameter set to [ http ]
[AAAA Old host [ Shinken - LYON - 192.168.1.119 ] disabled on synchronizer     
[YYYY-MM-DD HH:MM:SS] INFO DEBUG  : [ arbiter ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ nagvisARCHITECTURE_NAME ] [ MAP CONFIGURATIONGENERATOR ]         => "shinken_auth_port" parameter set to [ 7767 ]
[AAAA 3 host(s) disabled  


Cas d'erreurs

Si l'architecture-export essaye de communiquer avec le listener-shinken en HTTPS alors qu'il ne l'est pas, une erreur apparaîtra et la création de la carte sera abandonnée. Pour régler ce problème, il faut modifier la configuration du module ( voir Module architecture-export ).

Code Block
themeEmacs
[YYYY-MM-DD HH:MM:SS] INFO DEBUG  : [ ARBITER_NAME    arbiter ] [ ARCHITECTURE-EXPORT ] [ nagvisARCHITECTURE_NAME ] [ MAP CONFIGURATIONGENERATOR ]     - Sending  => "shinken_auth_address" parameter set to [ 192.168.1.119 ]
[AAAAhost(s) to Synchronizer ( via listener-shinken )
[YYYY-MM-DD HH:MM:SS] DEBUGERROR  : [ ARBITER_NAME    arbiter ] [ ARCHITECTURE-EXPORT ] [ nagvisARCHITECTURE_NAME ] [ MAP CONFIGURATIONGENERATOR ]         => "hosturl" parameter set to [ http://192.168.1.119:7767/detail-by-name/[host_name] ]
[AAAA Tried to request the listener with HTTPS, but it failed. Verify if your listener-shinken is on HTTPS


Si les identifiants de connexion au listener-shinken sont incorrect, une erreur apparaîtra et la création de la map sera abandonnée. Pour régler ce problème, il faut modifier la configuration du module ( voir Module architecture-export ).

Code Block
themeEmacs
[YYYY-MM-DD HH:MM:SS] INFO DEBUG  : [ ARBITER_NAME    arbiter ] [ ARCHITECTURE-EXPORT ] [ nagvisARCHITECTURE_NAME ] [ MAP CONFIGURATIONGENERATOR ]     - Sending  => "serviceurl" parameter set to [ http://192.168.1.119:7767/detail-by-name/[host_name]/checks/[service_description] ]
[AAAAhost(s) to Synchronizer ( via listener-shinken )
[YYYY-MM-DD HH:MM:SS] INFO ERROR  : [ ARBITER_NAME    arbiter ] [ ARCHITECTURE-EXPORT ] [ nagvisARCHITECTURE_NAME ] [ CONFIGURATION ]    - Setting Livestatus MAP GENERATOR ]         => Bad login and password for the listener


Si la communication avec le listener-shinken prend trop de temps ( s’il est injoignable ), cette erreur apparaîtra et la création de la carte sera abandonnée. Pour régler ce problème, il faut vérifier que votre listener-shinken est bien joignable.

Code Block
themeEmacs
[YYYY connection to get Shinken objects status
[AAAA-MM-DD HH:MM:SS] INFO DEBUG  : [ ARBITER_NAME    arbiter ] [ ARCHITECTURE-EXPORT ] [ nagvisARCHITECTURE_NAME ] [ MAP CONFIGURATIONGENERATOR ]     - Retrieving host(s) corresponding to => "socket" parameter set to [ socket="tcp:192.168.1.119:50000" ]
[AAAAthis architecture from the Synchronizer ( via listener-shinken )
[YYYY-MM-DD HH:MM:SS] INFOERROR   : [ ARBITER_NAME    arbiter ] [ ARCHITECTURE-EXPORT ] [ nagvis ] [ CONFIGURATION ] File /opt/nagvis/etc/nagvis.ini.php editedARCHITECTURE_NAME ] [ MAP GENERATOR ]         => Tried to request the listener, but it timed out. 


Suppression des images des cartes NagVis obsolètes

Avant de créer les nouvelles cartes, il faut supprimer les anciennes afin de ne pas avoir de doublons et de ne pas charger le disque.

Les cartes sont découpées en deux parties :

  • Le fond, qui est une image générée par l'architecture-export
  • Le fichier de configuration, qui est généré par l'architecture-export et équivaut aux positions des éléments Shinken dans la carte


Nous commençons par supprimer les fonds.

Exemple

Voici un exemple d'une suppression de fonds de cartes NagVis

Code Block
themeEmacs
[YYYY

Si aucune modification n'est attendue, dû à une erreur de configuration, l'architecture-export lira simplement la configuration de NagVis afin d'afficher son état actuel

Code Block
languagejs
themeEmacs
[AAAA-MM-DD HH:MM:SS] INFO   : [ arbiter ] [ ARCHITECTURE-EXPORT ] [ nagvis-shinken-architecture ] [ CONFIGURATION ] The connection between NagVis and Shinken modules will not be changed
[AAAA-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME    arbiter ] [ ARCHITECTURE-EXPORT ] [ nagvis-shinken-architectureARCHITECTURE_NAME ] [ MAP CONFIGURATIONGENERATOR ] Read /etc/shinken/external/nagvis/etc/nagvis.ini.php file
[AAAA     - Removing obsolete NagVis map background(s)
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME arbiter ] [ ARCHITECTURE-EXPORT ] [ nagvis-shinken-architecture ] [ CONFIGURATIONARCHITECTURE-EXPORT ] [ ARCHITECTURE_NAME ] -[ NoMAP WebUIGENERATOR module] found, we will keep previous NagVis configuration. Redirection to=> WebUI on NagVis maps may not work properly
[AAAA[ /etc/shinken/external/nagvis/share/userfiles/images/maps/background_[Shinken]
_Royaume:_All2021519148-e1bca43a-cdac-4411-9691-870a625b911b.png ] removed
[YYYY-MM-DD HH:MM:SS] INFO DEBUG  : [ ARBITER_NAME    arbiter ] [ ARCHITECTURE-EXPORT ] [ nagvis-shinken-architectureARCHITECTURE_NAME ] [ MAP CONFIGURATIONGENERATOR ]         => [ "shinken_auth_protocol" parameter not changed. It is still [ http ]
[AAAA/etc/shinken/external/nagvis/share/userfiles/images/maps/background_[Shinken]
_Architecture_Shinken2021519148-e1bca43a-cdac-4411-9691-870a625b911b.png ] removed  


Suppression des fichiers de configuration des cartes NagVis obsolètes

Après avoir supprimé les fonds des cartes, il faut supprimer les fichiers de configuration.

Exemple

Voici un exemple d'une suppression de fichiers de configuration NagVis

Code Block
themeEmacs
[YYYY-MM-DD HH:MM:SS] INFO DEBUG  : [ ARBITER_NAME    arbiter ] [ ARCHITECTURE-EXPORT ] [ nagvis-shinken-architectureARCHITECTURE_NAME ] [ MAP CONFIGURATIONGENERATOR ]     - Removing obsolete => "shinken_auth_port" parameter not changed. It is still [ 7767 ]
[AAAANagVis map configuration(s)
[YYYY-MM-DD HH:MM:SS] DEBUG INFO   : [ ARBITER_NAME  : [ arbiter ] [ ARCHITECTURE-EXPORT ] [ nagvis-shinken-architectureARCHITECTURE_NAME ] [ MAP CONFIGURATIONGENERATOR ]         => "shinken_auth_address" parameter not changed. It is still [ 192.168.1.119 ]
[AAAA [ /etc/shinken/external/nagvis/etc/maps/shinken_global-e1bca43a-cdac-4411-9691-870a625b911b.cfg ] removed
[YYYY-MM-DD HH:MM:SS] INFO DEBUG  : [ ARBITER_NAME arbiter ] [ ARCHITECTURE-EXPORT ] [ nagvisARCHITECTURE-shinken-architectureEXPORT ] [ CONFIGURATIONARCHITECTURE_NAME ] [ MAP GENERATOR   ]  => "hosturl" parameter not changed. It is still=> [ http://192.168.1.119:7767/detail-by-name/[host_name] ]
[AAAA/etc/shinken/external/nagvis/etc/maps/shinken_architecture-e1bca43a-cdac-4411-9691-870a625b911b.cfg ] removed
[YYYY-MM-DD HH:MM:SS] INFO DEBUG  : [ ARBITER_NAME arbiter ] [ ARCHITECTURE-EXPORT ] [ nagvisARCHITECTURE-shinken-architectureEXPORT ] [ CONFIGURATIONARCHITECTURE_NAME ]   [ MAP GENERATOR ]  => "serviceurl" parameter not changed. It is still=> [ http://192.168.1.119:7767/detail-by-name/[host_/etc/shinken/external/nagvis/etc/maps/All-e1bca43a-cdac-4411-9691-870a625b911b.cfg ] removed


Calcul de la taille des royaumes pour les cartes NagVis

Les cartes NagVis sont sous forme de blocs imbriqués. Pour pouvoir les créer il faut alors assigner une taille de bloc à chaque royaume. Pour se faire, nous calculons leur taille selon leur contenu :

  • Taille initiale du royaume
  • Taille des sous-royaumes
  • Taille des hôtes
    • Nombre de checks

Exemple

Voici un exemple d'un calcul de la taille réussi

Code Block
themeEmacs
[YYYYname]/checks/[service_description] ]
[AAAA-MM-DD HH:MM:SS] INFO   : [ arbiter ] [ ARCHITECTURE-EXPORT ] [ nagvis-shinken-architecture ] [ CONFIGURATION ]    - No Livestatus module found, we will keep previous NagVis configuration. Status] INFO   : [ ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ ARCHITECTURE_NAME ] [ MAP GENERATOR ]     - Computing architecture objects size


Tri des royaumes

Nous trions les royaumes par taille afin d'avoir un rendu agréable à l'œil

Exemple

Voici un exemple d'un tri réussi

Code Block
themeEmacs
[YYYY of Shinken elements on NagVis maps may not work properly
[AAAA-MM-DD HH:MM:SS] INFO DEBUG  : [ ARBITER_NAME    arbiter ] [ ARCHITECTURE-EXPORT ] [ nagvis-shinken-architectureARCHITECTURE_NAME ] [ MAP CONFIGURATIONGENERATOR ]     - Sorting realms by size


Génération des cartes NagVis

C'est à cette étape que les cartes NagVis sont générées. Il y a au total 4 types de fichiers :

  • Un arbre représentant tous les royaumes,
  • Une carte détaillée de tous les royaumes,
  • Une carte détaillée par royaume,
  • Un fichier de configuration de rotation, permettant de faire défiler les cartes NagVis d'une même architecture,


Chaque création de fichier est affiché dans les logs.

Exemple

Voici un exemple de génération ayant réussie

Code Block
themeEmacs
[YYYY  => "socket" parameter not changed. It is still [ socket="tcp:192.168.1.119:50000" ]
[AAAA-MM-DD HH:MM:SS] INFO   : [ arbiter ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ nagvisARCHITECTURE_NAME ] [ CONFIGURATION ] The connection between NagVis and Shinken modules will not be changed
[AAAAMAP GENERATOR ]     - Generating Nagvis maps
[YYYY-MM-DD HH:MM:SS] INFO   : [ arbiter ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ nagvisARCHITECTURE_NAME ] [ MAP CONFIGURATIONGENERATOR ] Read /opt/nagvis/etc/nagvis.ini.php file
[AAAA         => Generating realms tree NagVis map
[YYYY-MM-DD HH:MM:SS] INFO   : [ ARBITER_NAME    arbiter ] [ ARCHITECTURE-EXPORT ] [ nagvis ] [ CONFIGURATION ]    - No WebUI module found, we will keep previous NagVis configuration. Redirection to WebUI on NagVis maps may not work properly
[AAAAARCHITECTURE_NAME ] [ MAP GENERATOR ]         => Generating detailed architecture NagVis map
[YYYY-MM-DD HH:MM:SS] INFO DEBUG  : [ ARBITER_NAME    arbiter ] [ ARCHITECTURE-EXPORT ] [ nagvisARCHITECTURE_NAME ] [ MAP CONFIGURATIONGENERATOR ]         => "shinken_auth_protocol" parameter not changed. It is still [ http ]
[AAAAGenerating NagVis map for realm [All]
[YYYY-MM-DD HH:MM:SS] INFO DEBUG  : [ arbiter ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ nagvisARCHITECTURE_NAME ] [ MAP CONFIGURATIONGENERATOR ]         => "shinken_auth_port" parameter not changed. It is still [ 7767 ]
[AAAAGenerating NagVis map for realm [Paris]
[YYYY-MM-DD HH:MM:SS] INFO DEBUG  : [ ARBITER_NAME    arbiter ] [ ARCHITECTURE-EXPORT ] [ nagvisARCHITECTURE_NAME ] [ MAP CONFIGURATIONGENERATOR ]         => "shinken_auth_address" parameter not changed. It is still [ 192.168.1.119 ]
[AAAA Generating rotation configuration for NagVis maps


Sauvegarde des hôtes listener-shinken dans un fichier de rétention

A chaque réception d'architecture, le module sauvegarde l'état des hôtes du listener-shinken dans un fichier.

Ce permet de n'envoyer de demande de creation / modification d'hôte que si il y a des nouveautés.

Exemple

Voici un exemple de sauvegarde de rétention ayant réussie

Code Block
themeEmacs
[YYYY-MM-DD HH:MM:SS] INFO DEBUG  : [ arbiter ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ nagvis ] [ CONFIGURATIONARCHITECTURE_NAME ] [ MAP GENERATOR ]    => "hosturl"- parameter not changed. It is still [ http://192.168.1.119:7767/detail-by-name/[host_name] ]
[AAAASaving host(s) sent to listener in retention file
[YYYY-MM-DD HH:MM:SS] INFO DEBUG  : [ ARBITER_NAME    arbiter ] [ ARCHITECTURE-EXPORT ] [ nagvisARCHITECTURE_NAME ] [ MAP CONFIGURATIONGENERATOR ]         => "serviceurl"listener parameterhosts not changed. It is still [ http://192.168.1.119:7767/mapping saved in /var/lib/shinken/architecture_export_hosts_mapping.json


Cas d'erreurs

Si l'architecture-export n'a pas les droits d'écriture sur le fichier de rétention, cette erreur apparaîtra et la sauvegarde sera abandonnée

Code Block
themeEmacs
[YYYYdetail-by-name/[host_name]/checks/[service_description] ]
[AAAA-MM-DD HH:MM:SS] INFO    : [ ARBITER_NAME  : [ arbiter ] [ ARCHITECTURE-EXPORT ] [ nagvisARCHITECTURE_NAME ] [ MAP CONFIGURATIONGENERATOR ]     - No Livestatus module found, we will keep previous NagVis configuration. Status of Shinken elements on NagVis maps may not work properly
[AAAASaving host(s) sent to listener in retention file
[YYYY-MM-DD HH:MM:SS] DEBUGERROR  : [ arbiter ARBITER_NAME     ] [ ARCHITECTURE-EXPORT ] [ nagvisARCHITECTURE_NAME ] [ MAP CONFIGURATIONGENERATOR ]         => "socket" parameter not changed. It is still [ socket="tcp:192.168.1.119:50000" ]
Note

La modification/lecture de la configuration de NagVis est visible 2 fois. Ceci est dû au fait que nous fournissons deux installations NagVis distincts : 

nagvis-shinken-architecture, qui est celui sur lequel nous mettons à disposition des cartes générées automatiquement

nagvis, qui lui ne contient aucune carte générée par Shinken
> Permission denied on /var/lib/shinken/architecture_export_hosts_mapping.json