Versions Compared

Key

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

Explication

Le module WebUI permet de générer l'interface de visualisation. Il est possible de modifier les paramètres (Langue de l'interface, port d'écoute) via le fichier de configuration ci-dessous.

Mécanisme des données manquantes


Info

 Voir  : Détermination de l'état de l'hôte ( pour plus d'information sur les cas particuliers )


Configuration

MongoDB

Le module WebUI a besoin de se connecter à une base MongoDB pour stocker les portails, tableaux de bords et favoris des utilisateurs. Le paramétrage pour la connexion à cette base Mongo est décrit dans la page du Module MongoDB

Récupération des broks

Le fonctionnement du thread de récupération des broks peut être configuré via certains paramètres.

Warning

Une mauvaise configuration de ces paramètres peut compromettre le bon fonctionnement du module, se rapprocher du support pour toutes éditionstoute modification


CléTypeValeur par défautDescription


Code Block
webui__broks_getter__include_deserialisation_and_catchup_in_lock


Booléen0

Prendre le lock dès la récupération d'un premier brok set, la récupération des broks en retard, et la dé-sérialisation se font alors dans la session critique (Locké) pour disposer d'un maximum de temps CPU :

  • 1 : Activer
  • 0 Désactiver



Code Block
webui__broks_getter__activate_late_set_catchup


Booléen1

Utilisation de la fonctionnalité de rattrapage pour absorber des broks en retard :

  • 1 : Activer
  • 0 Désactiver


Code Block
webui__broks_getter__nb_late_set_allowed_before_catchup


Entier10Nombre de sets en attente tolérés.
Au dessus de ce nombre, les sets sont immédiatement récupérés par l'algorithme de rattrapage pour être traités maintenant


Code Block
webui__broks_getter__catchup_broks_managed_by_module_in_a_catchup_loop


Entier200000Nombre maximal de broks en retard que l'algorithme de rattrapage récupère avant de lancer le traitement


Code Block
webui__broks_getter__catchup_run_endless_until_nb_late_set_allowed_reached


Booléen1

Après traitement des broks, si le nombre de broks sets en retard est trop élevé,

  • arrêter l'absorption des broks et rendre le lock
  • 1 continuer le rattrapage et absorber des broks en retard



Fichier de configuration

Voici le fichier CFG de configuration présent dans : /etc/shinken/modules/webui.cfg

Code Block
languagebash
#===============================================================================
# WebUI
#===============================================================================
# Daemons that can load this module:
# - broker
# This module is the visualization interface
#===============================================================================


define module {

# Shinken Enterprise. Lines added by import core. Do not remove it, it's used by Shinken Enterprise to update your objects if you re-import them.
    _SE_UUID             core-module-2e0f08c45adc11e59a90080027f08538
    _SE_UUID_HASH        99215795c7e21b658e7c34989e872fcc
# End of Shinken Enterprise part

    #======== Module identity =========
    # Module name. Must be unique
    module_name               WebUI

    # Module type (to load module code). Do not edit.
    module_type               webui



    #======== Listening address =========
    # host: IP address to listen to.
    #       note: 0.0.0.0 = all interfaces.
    host                      0.0.0.0
    # port to listen
    port                      7767

    # HTTPs part, enable if you want to set the visualisation interface listen in HTTPs mode
    # disabled by default. Set your own certificates.
    use_ssl                   0
    ssl_cert                  /etc/shinken/certs/server.cert
    ssl_key                   /etc/shinken/certs/server.key


    #======== Security =========
    # auth_secret: secret key used to crypt cookie.
    # note: must be the same as the configuration UI
    auth_secret                 AUTH-SECRET-22316-4472-3256

    # Allow or not HTML chars in plugins output
    allow_html_output           0

    # Use users ACL or enable all for everyone
    manage_acl                  1

    # Remote application authentification
    # if 1: allow the user to be load from a HTTP Header
    remote_user_enable          1

    # which HTTP header to get user name if remote_user_enable is 1
    remote_user_variable       X-Forwarded-User

    # if remote_user_enable is 1,
    # http_remote_user_case_sensitive to 1 enable case check on remote user login
    # http_remote_user_case_sensitive to 0 disable case check on remote user login
    # default value : 1, login is case sensitive
    remote_user_case_sensitive  1

    # Maximum output length for plugin output, 0=no limit
    max_output_length           0



    #======== Lang =========
    # Select the lang that will be used by default on the UIs
    # Currently managed:
    # -en    (english)
    # -fr    (francais)
    lang                                fr



    #======== Paths =========
    share_dir                  /var/lib/shinken/share
    photo_dir                  /var/lib/shinken/photos

    #======== Modules =========
    # Modules loaded by the Visualisation interface
    # Available:
    # - Cfg_password          : check password from the user configuration
    # - auth-active-directory : check password from active directory
    # - Mongodb               : [mandatory] use to save user data (hive, favorites, ...)
    # - webui-enterprise      : [mandatory]
    # - sla                   : [mandatory] read sla from this module definition
    modules                   Cfg_password, Mongodb,webui-enterprise, sla


    #======== Metrology access =========
    # Multi-realm graphite parameter
    graphite_backends	      *:127.0.0.1

    # Before a graphite query is done, the graphite server is tested
    # Timeout for the alive timeout
    # default: 10 (seconds)
    metrology__ping_timeout    10

    # Timeout for graphite queries
    # default: 20 (seconds)
    metrology__query_timeout    20

    # If the test does fail, the graphite server will be exclude during this time
    # to avoid to lock query for timeouts
    # default: 120 (seconds)
    metrology__after_error_wait_before_retry   120


    #======== Broks getter in WebUI =========
    # These parameters allow some internal tuning in broks management in WebUI
  
    # Take the lock as soon as getter thread has some broks to manage
    # in order to attempt to reduce concurrent usage of CPU
    # webui__broks_getter__include_deserialisation_and_catchup_in_lock 				0

	# Enable or disable late broks sets catchup
	# webui__broks_getter__activate_late_set_catchup								1
  
    # Take extra broks sets to manage if more than this parameter sets are waiting
    # webui__broks_getter__nb_late_set_allowed_before_catchup	                    10
  
    # Stop taking extra broks sets in catchup when we reach this number of broks
    # webui__broks_getter__catchup_broks_managed_by_module_in_a_catchup_loop        200000
  
    # Continue catchup if too much late broks sets remains after 
    # webui__broks_getter__catchup_run_endless_until_nb_late_set_allowed_reached	1
 

    #======== Extended configuration ========
    [OVERLOAD_FROM]            /etc/shinken/_default/daemons/brokers/modules/webui.cfg
    [OVERLOAD_FROM]            /etc/shinken-user/configuration/daemons/brokers/modules/webui/webui_cfg_overload.cfg

}