Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Make by tools (01.00.01) - action=merge_page
Scroll Ignore
scroll-viewporttrue
scroll-pdftrue
scroll-officetrue
scroll-chmtrue
scroll-docbooktrue
scroll-eclipsehelptrue
scroll-epubtrue
scroll-htmlfalse
Panel
titleSommaire

Table of Contents
stylenone

Présentation

 Pour une raison de simplicité de gestion, les dispositions par défaut et le reste de la configuration du module son t découpées en plusieurs parties qui se trouvent par défaut dans les fichiers suivants :


Info
Info

Si vous faites plusieurs modules de météosmétéo, vous devez choisir soit de :

  • Faire un nouveau répertoire. Le nom du répertoire est libre, mais nous vous conseillons de l'appelé appeler du même nom que votre module pour que votre configuration soit plus simple à maintenir.
    • Exemple : /etc/shinken-user/configuration/daemons/brokers/modules/webui/modules/Mon-Module-Webui-Module-Service-Weather
    • Voir la page Module webui-module-service-weather pour plus de détail pour le choix du nom du module
  • Garder la configuration dans le même répertoire pour uniformiser la configuration des de toutes les météos.

Configuration du module

Exemple de fichier de configuration

Code Block
languagejs
themeConfluence
#================================================================================
# webui-module-service-weather
#================================================================================
# Modules that can load this module:
# - WebUI
# This module display service-weather in WebUI
#================================================================================

define module {

    # ┌─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐ #
    # │ ──────────────────────────────────────────────────────────    MODULE IDENTITY    ────────────────────────────────────────────────────────── │ #
    # └─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ #

    # ─── Module name [ Must be unique ]                                                                                              [ MANDATORY ] ───
    # ───                                                                                                                                           ───
    module_name                                         webui-module-service-weather-example

    # ─── Module type [ Do not edit ]                                                                                                 [ MANDATORY ] ───
    # ───                                                                                                                                           ───
    module_type                                         webui_module_service_weather

    # ┌─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐ #
    # │ ──────────────────────────────────────────────────────    EXTERNAL LINKS OPTIONS    ─────────────────────────────────────────────────────── │ #
    # └─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ #

    # ─── This option allows you to change the path for external links.                                                                             ───
    # ───       Use it for security reasons, to have external url with a different path than the                                                    ───
    # ───       default installation                                                                                                                ───
    # ───       ⚠ Change this parameter will change all your external links.                                                                        ───
    # ─── sample url : http://localhost:7767/service-weather/external/abcd01/xyz009                                                                 ───
    # ─── where :                                                                                                                                   ───
    # ───     "http://" is the value of the link protocol                                                                                           ───
    # ───     "localhost:7767" is the value of the base url                                                                                         ───
    # ───     "external" is the value of this parameter                                                                                             ───
    # ───     "abcd01" is the service weather uuid                                                                                                  ───
    # ───     "xyz009" is the external link configuration uuid                                                                                      ───
    # ─── The following characters are prohibited : ",',/ and space.                                                                                ───
    #                                                                                                                                               ───
    #           Default : external                                                                                                                  ───
    #                                                                                                                                               ───
    # broker__module_webui__module_service_weather__default_external_link__external_part_url external

    # ─── This option allows you to change the path for external links.                                                                             ───
    # ───       Use it for security reasons, to have external url with a different path than the                                                    ───
    # ───       default installation                                                                                                                ───
    # ───       ⚠ Change this parameter will change all your external links.                                                                        ───
    # ─── sample url : http://localhost:7767/service-weather/external/abcd01/xyz009                                                                 ───
    # ─── where :                                                                                                                                   ───
    # ───     "http://" is the value of the link protocol                                                                                           ───
    # ───     "localhost:7767" is the value of this parameter                                                                                       ───
    # ───     "external" is the value of the external_part_url                                                                                      ───
    # ───     "abcd01" is the service weather uuid                                                                                                  ───
    # ───     "xyz009" is the external link configuration uuid                                                                                      ───
    # ─── The following characters are prohibited : ",', and space.                                                                                 ───
    #                                                                                                                                               ───
    #           Default : Your broker base url                                                                                                      ───
    #                                                                                                                                               ───
    # broker__module_webui__module_service_weather__default_external_link__base_url 

    # ─── This option allows you to change the link protocol for your external links                                                                ───
    # ───       This can be useful if you want your links to be on a reverse proxy that doesn't use same protocol as the WebUI                      ───
    # ───       default installation                                                                                                                ───
    # ───       Change this parameter will change all your external links.                                                                          ───
    #                                                                                                                                               ───
    #           Default : protocol_from_webui => It will be equal to the use_ssl of the WebUI.                                                      ───
    #                                            If use_ssl is True, it will be HTTPS, else it will be HTTP                                         ───
    #           ...     : http                                                                                                                      ───
    #           ...     : https                                                                                                                     ───
    #                                                                                                                                               ───
    # broker__module_webui__module_service_weather__default_external_link__link_protocol protocol_from_webui

    # ─── This option allows you to change if the authentication is needed for an external link.                                                    ───
    #                                                                                                                                               ───
    #           Default : 1 ( authentication is needed )                                                                                            ───
    #           ...     : 0 ( authentication is not needed )                                                                                        ───
    #                                                                                                                                               ───
    # broker__module_webui__module_service_weather__default_external_link__authentication_needed 1

    # ┌─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐ #
    # │ ──────────────────────────────────────────────────────────────────────────────────────────────────────────────    WEATHER PERFORMANCEHISTORY OPTIONS    ────────────────────────────────────────────────────────────────────────────────────────────────────────────── │ #
    # └─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ #

    # ─── Maximal This option allows you to set the maximum number of widgetschanges saved in database for oneeach weather pageview.                                      ───
    # ───       /!\ If you decrease the value, the extra history will be deleted on daemon startup.                              ───
    # ─── Use this to limit your users and prevent them from making a weather page───
 that takes  # ───       /!\ Minimum value is 10.                                         ───
    # ─── all server resources.                                                           ───
    #                                                      ───
    # ───                                                                                    ───
    #           Default : 100                                      ───
    # broker__module_webui__module_service_weather__default_max_widget_number 100

    # ───────────────────────  CACHE  ─────────────────────────────────────────────────────────────────────────────────────────────────────────────── #

    # ─── The refresh interval in seconds between each cache data calculation.                                                  ───
    #                ───
    # ─── Increase this period if the cache takes too many resources on server.                                                                     ───
    # ─── Minimum value is 60 seconds.                               ───
    # broker__module_webui__module_service_weather__weather_history__nb_changes_kept 100

    # ┌─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐ #
    #  ───────────────────────────────────────────────────    INTERFACE VIEWS TRASH OPTIONS    ───────────────────────────────────────────────────  #
    # └─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ #

    # ────────────────  All Views Parameters  ─────────────────────────────────────────────────────────────────────────────────────────────────────── #

    # ─── This option allows you to set the maximum number of days that views are kept in the trash.        ───
    #                                    ───
    # ───       /!\ After this delay, the views are permanently DELETED.                                                                                       ───
    # ───       /!\ If you Defaultdecrease :the 60value, (the secondstoo )old views can be DELETED on daemon startup.                                                  ───
    # ───       /!\ Minimum value is 7 days.                                  ───
    #                                                                  ───
    #                                                                         ───
    # broker__module_webui__module_service_weather__cache__refresh_interval 60

    # ─── Define the limited time allowed to refresh the cache before raising a warning.                                              ───
    #          ───
 Default :  # ─── Thisuse_default_for_all => It will be usedequal byto the shinken-broker-module-weather-service checks to change its state'views_trash__delay_before_deletion__default_for_all' of the WebUI         ───
    #           ...     : A number of days (for example 30)               ───
    #                                                                      ───
    #                                                                     ───
    #           Default : 30 ( seconds )                                                      ───
    # broker__module_webui__module_service_weather__views_trash__delay_before_deletion__service_weather use_default_for_all

    # ┌─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐ #
    #  ────────────────────────────────────────────────────────    PERFORMANCE OPTIONS    ────────────────────────────────────────────────────────  #
    # └─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ #

    # ─── Maximal number of widgets for one weather page.      ───
    #                                                                                 ───
    # ─── Use this to limit your users and prevent them from making a weather page that takes                                          ───
    # broker__module_webui__module_service_weather__cache__time_taken_for_compute_warning 30

    # ─── Define the───
 limited time allowed to# refresh─── theall cacheserver beforeresources. raising an error.                                                             ───
    # ─── This will be used by the shinken-broker-module-weather-service checks to change its state                                    ───
    # ───        ───
    #                                                                                                                               ───
    # broker__module_webui__module_service_weather__default_max_widget_number 100

    # ───────────────────────  CACHE  ─────────────────────────────────────────────────────────────────────────────────────────────────────────────── ───#

    # ─── The refresh interval in seconds between each cache data Defaultcalculation. : 40 ( seconds )                                                                 ───
    # ─── Increase this period if the cache takes too many resources on server.                          ───
        #                                   ───
    # ─── Minimum value is 60 seconds.                                                                                                  ───
    # broker__module_webui__module_service_weather__cache__time_taken_for_compute_critical 40

    # ┌─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐ #───
    #  ─────────────────────────────────────────────────────────    INTERNAL OPTIONS    ──────────────────────────────────────────────────────────  #
    # └─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ #

    # ─── INTERNAL : DO NOT EDIT FOLLOWING PARAMETERS WITHOUT YOUR DEDICATED SUPPORT                                                                ───

    # ─── The time to wait before starting to refresh the cache                             ───
    #           Default : 60 ( seconds )                                    ───
    # ─── At start of the Broker, some element data are not directly available                                                       ───
    #           ───
    # ─── Increase this time if the module has "missing element" on every element at start                                                          ───
    # ─── This will give more time to the Scheduler to give all element data to the Broker and the module                               ───
    # broker__module_webui__module_service_weather__cache__refresh_interval 60

    #  ───
 Define the limited #time allowed to refresh the cache before raising a warning.                                                            ───
    # ─── This will be used by the shinken-broker-module-weather-service checks to change its state                                                 ───
    #               ───
    #           Default : 30 ( seconds )                                                                                                            ───
    #           Default : 30 ( seconds )                                                                                                            ───
    #               ───
       # broker__module_webui__module_service_weather__awaited_time_before_fetching_element_data 30

    [OVERRIDE_FROM] /etc/shinken-user/configuration/daemons/brokers/modules/webui/modules/webui_module_service_weather/webui                                                                                                                   ───
    # broker__module_webui__module_service_weather__defaultcache__grid_layout.cfg
    [OVERRIDE_FROM] /etc/shinken-user/configuration/daemons/brokers/modules/webui/modules/webui_module_service_weather/webui_module_service_weather__default_info_bar_layout.cfg
    [OVERRIDE_FROM] /etc/shinken-user/configuration/daemons/brokers/modules/webui/modules/webui_module_service_weather/webui_module_service_weather__default_widgets_layout.cfg 
	[OVERRIDE_FROM] /etc/shinken-user/configuration/daemons/brokers/modules/webui/modules/webui_module_service_weather/webui_module_service_weather__default_notifications_settings.cfg
 }
  

Détails des sections composant le fichier de configuration

Identification du module

Il est possible de définir plusieurs instances de module de type "webui-module-service-weather" dans votre architecture Shinken .

  • Chaque instance devra avoir un nom unique.

Nom

Type

Unité

Défaut

Commentaire

Code Block
module_name 

Texte

---

webui-module-service-weather

Nous vous conseillons de choisir un nom en fonction de l'utilisation du module pour que votre configuration soit simple à maintenir.

Doit être unique.

Code Block
module_type 

Texte

---

webui_module_service_weather

Ne peut être modifié.

Options des liens externes

Code Block
languagejs
# ┌─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐ #
    # │ ──────────────────────────────────────────────────────    EXTERNAL LINKS OPTIONS    ─────────────────────────────────────────────────────── │ #
    # └─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ #

    # ─── This option allows you to change the path for external links.time_taken_for_compute_warning 30

    # ─── Define the limited time allowed to refresh the cache before raising an error.                                                             ───
    # ─── This will be used by the shinken-broker-module-weather-service checks to change its state                                                 ───
    #                                                                  ───
    # ───       Use it for security reasons, to have external url with a different path than the                                                    ───
    #  ───       default installation Default : 40 ( seconds )                                                                                                            ───
    # ───        Change this parameter will change all your external links.                                                                        ───
    # ─── sample url : http://localhost:7767/service-weather/external/abcd01/xyz009                                             ───
    # broker__module_webui__module_service_weather__cache__time_taken_for_compute_critical 40

    # ┌─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐ #
    #  ─────────────────────────────────────────────────────────  ───  INTERNAL OPTIONS    ────────────────────────────────────────────────────────── │ #
    # └─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ #

    # ─── whereINTERNAL : DO NOT EDIT FOLLOWING PARAMETERS WITHOUT YOUR DEDICATED SUPPORT                                                                ───

    # ─── The time to wait before starting to refresh the cache                                            ───
    # ───     "http://localhost:7767" is the value of the base url                        ───
    # ─── At start of the Broker, some element data are not directly available                                         ───
    # ───     "external" is the value of this parameter                ───
    # ─── Increase this time if the module has "missing element" on every element at start                                                          ───
    # ─── This will give more "abcd01"time isto the serviceScheduler weatherto uuidgive all element data to the Broker and the module                                           ───
    #                                          ───
    # ───     "xyz009" is the external link configuration uuid                                                                                      ───
    # ─── The following characters are prohibited : ",',/ and space. Default : 30 ( seconds )                                                                          ───
    #                              ───
    #                                                                                                             ───
    #           Default : external                 ───
           # broker__module_webui__module_service_weather__awaited_time_before_fetching_element_data 30      

    # ┌─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐ #
    #  ────────────────────────────────────────────────────    EXTENDED FILE CONFIGURATION    ────────────────────────────────────────────────────  #
    # └─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ #
      
	[OVERRIDE_FROM] /etc/shinken-user/configuration/daemons/brokers/modules/webui/modules/webui_module_service_weather/webui_module_service_weather__default_grid_layout.cfg
    [OVERRIDE_FROM] /etc/shinken-user/configuration/daemons/brokers/modules/webui/modules/webui_module_service_weather/webui_module_service_weather__default_info_bar_layout.cfg
    [OVERRIDE_FROM] /etc/shinken-user/configuration/daemons/brokers/modules/webui/modules/webui_module_service_weather/webui_module_service_weather__default_widgets_layout.cfg 
	[OVERRIDE_FROM] /etc/shinken-user/configuration/daemons/brokers/modules/webui/modules/webui_module_service_weather/webui_module_service_weather__default_notifications_settings.cfg
 }
  



Détails des sections composant le fichier de configuration

Identification du module

Il est possible de définir plusieurs instances de module de type "webui-module-service-weather" dans votre architecture Shinken .

  • Chaque instance devra avoir un nom unique.

Nom

Type

Unité

Défaut

Commentaire

No Format
module_name 

Texte

---

webui-module-service-weather

Nous vous conseillons de choisir un nom en fonction de l'utilisation du module pour que votre configuration soit simple à maintenir.

Doit être unique.

No Format
module_type 

Texte

---

webui_module_service_weather

Ne peut être modifié.

Options des liens externes

Code Block
languagejs
themeConfluence
# ┌─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐ #
    # │ ──────────────────────────────────────────────────────    EXTERNAL LINKS OPTIONS    ─────────────────────────────────────────────────────── │ #
    # └─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ #

                                    ───
    #                                                                                                                                               ───
    # broker__module_webui__module_service_weather__default_external_link__external_part_url external

    # ─── This option allows you to change the path for external links.                                                                             ───
    # ───       Use it for security reasons, to have external url with a different path than the                                                    ───
    # ───       default installation                                                                                                                ───
    # ───       ⚠ Change this parameter will change all your external links.                                                                        ───
    # ─── sample url : http://localhost:7767/service-weather/external/abcd01/xyz009                                                                 ───
    # ─── where :                                                                                                                                   ───
    # ───     "http://localhost:7767" is the value of this parameterthe base url                                                                                  ───
    # ───     "external" is the value of the external_part_urlthis parameter                                                                                             ───
    # ───     "abcd01" is the service weather uuid                                                                                                  ───
    # ───     "xyz009" is the external link configuration uuid                                                                                      ───
    # ─── The following characters are prohibited : ",',/ and space.                                                                                 ───
    #                                                                                                                                               ───
    #           Default : Your broker base url external                                                                                                                  ───
    #                                                                                                                                               ───
    # broker__module_webui__module_service_weather__default_external_link__baseexternal_part_url external

    # ─── This option allows you to change the linkpath protocol for your external links.                                                                             ───
    # ───       Use  This can be useful if you want your links to be on a reverse proxy that doesn't use same protocol as the WebUIit for security reasons, to have external url with a different path than the                                                    ───
    # ───       default installation                                                                                                                ───
    # ───        Change this parameter will change all your external links.                                                                          ───
    # ─── sample url : http://localhost:7767/service-weather/external/abcd01/xyz009                                                                 ───
    # ─── where :                                                                    ───
    #           Default : protocol_from_webui => It will be equal to the use_ssl of the WebUI. 														───
                   #                            ───
    # ───     "http://localhost:7767" is the value of this Ifparameter use_ssl is True, it will be HTTPS, else it will be HTTP                                         ───
    #           ...     : http      ───
    # ───     "external" is the value of the external_part_url                                                                                      ───
    # ───     ───
"abcd01" is the service #weather uuid          ...     : https                                                                                  ───
    # ───     "xyz009" is the external link configuration uuid                   ───
    #                                                               ───
    # ─── The following characters are prohibited : ",', and space.                                                                  ───
    # broker__module_webui__module_service_weather__default_external_link__link_protocol protocol_from_webui

    # ─── This option allows you───
 to change if the# authentication is needed for an external link.                                                    ───
    #                                                                                ───
    #           Default : Your broker base url                                           ───
    #           Default : 1 ( authentication is needed )                                     ───
    #                                                   ───
    #           ...     : 0 ( authentication is not needed )                                                                 ───
    # broker__module_webui__module_service_weather__default_external_link__base_url 

    # ─── This option allows you to change the link protocol for your ───
external links   #                                                             ───
    # ───       This can be useful if you want your links to be on a reverse proxy that doesn't use same protocol as the WebUI                      ───
    # ───       default installation                                                                                                                ───
    # broker__module_webui__module_service_weather__default_external_link__authentication_needed 1

Nom

Type

Unité

Défaut

Commentaire

 ───       Change this parameter will change all your external links.                                                                          ───
    #                                                                                                                                               ───
    #           Default : protocol_from_webui => It will be equal to the use_ssl of the WebUI. 														───
    #                                            If use_ssl is True, it will be HTTPS, else it will be HTTP                                         ───
    #           ...     : http                                                                                                                      ───
    #           ...     : https                                                                                                                     ───
    #                                                                                                                                               ───
    # broker__module_webui__module_service_weather__default_external_link__link_protocol protocol_from_webui

    # ─── This option allows you to change if the authentication is needed for an external link.                                                    ───
    #                                                                                                                                               ───
    #           Default : 1 ( authentication is needed )                                                                                            ───
    #           ...     : 0 ( authentication is not needed )                                                                                        ───
    #                                                                                                                                               ───
    # broker__module_webui__module_service_weather__default_external_link__authentication_needed 1

Nom

Type

Unité

Défaut

Commentaire

No Format
broker__module_webui__module_service_weather__default_external_link__external_part_url

Texte

---

external

Cette option vous permet de modifier le chemin d'accès aux liens externes.
Exemple d'url : http://localhost:7767/service-weather/external/abcd01/xyz009
Où :

  • http est la valeur du paramètre link_protocol
  • localhost:7767 est la valeur de la base url
  • external est la valeur de ce paramètre
  • abcd01 est l'uuid de la météo du service
  • xyz009 est l'uuid de configuration du lien externe

Le caractère "/" et les autres caractères interdits dans les URL ne sont pas autorisés dans ce paramètre.
Exemple de caractères interdit : !,#,$,&,',(,),*,+,,/,:,;,=,?,@,[,],<,>, caractères avec des accents…

No Format
broker__module_webui__module_service_weather__default_external_link__base_url
Texte--- La base url du Broker

Cette option vous permet de modifier la base url d'accès aux liens externes.
Exemple d'url : http://localhost:7767/service-weather/external/abcd01/xyz009
Où :

  • http est la valeur du paramètre link_protocol
  • localhost:7767 est la valeur de ce paramètre
  • external est la valeur du paramètre external_part_url
  • abcd01 est l'uuid de la météo du service
  • xyz009 est l'uuid de configuration du lien externe

Le caractère "/" et les autres caractères interdits dans les URL ne sont pas autorisés dans ce paramètre.
Exemple de caractères interdit : !,#,$,&,',(,),*,+,,/,:,;,=,?,@,[,],<,>, caractères avec des accents…

No Format
broker__module_webui__module_service_weather__default_external_link__link_protocol
Texte--- Le protocole du serveur WebUI

Cette option vous permet de modifier le protocole utilisé par les url d'accès aux liens externes.
Exemple d'url : http://localhost:7767/service-weather/external/abcd01/xyz009
Où :

  • http est la valeur de ce paramètre
  • localhost:7767 est la valeur de la base url
  • external est la valeur du paramètre external_part_url
  • abcd01 est l'uuid de la météo du service
  • xyz009 est l'uuid de configuration du lien externe


La valeur peut-être

  • "http"
  • "https"
  • "protocol_from_webui" (qui correspond au protocole du serveur WebUI :
    • "http" si "use_ssl" est à 0
    • "https" si "use_ssl" est à 1
No Format
broker__module_webui__module_service_weather__default_external_link__authentication_needed
Texte Booléen 1 Cette option permet de choisir si une authentification est nécessaire pour avoir accès aux liens externes de la météo.
Warning

La modification de ce paramètre entraîne la modification de tous vos liens externes.

Options de l'historique des météos

Code Block
languagejs
themeConfluence
    # ┌─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐ #
    # │ ──────────────────────────────────────────────────────    WEATHER HISTORY OPTIONS    ────────────────────────────────────────────────────── │ #
    # └─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ #

    # ─── This option allows you to set the maximum number of changes saved in database for each weather view.                                      ───
    # ───       /!\ If you decrease the value, the extra history will be deleted on daemon startup.                                                 ───
    # ───       /!\ Minimum value is 10.                                                                                                            ───
    #                                                                                                                                               ───
    #           Default : 100                                                                                                                       ───
    #                                                                                                                                               ───
    # broker__module_webui__module_service_weather__weather_history__nb_changes_kept 100

Nom

Type

Unité

Défaut

Commentaire

No Format
 broker__module_webui__module_service_weather__weather_history__nb_changes_kept
Entier positif--- 100

Limite du nombre d'entrées stockées dans l'historique des vues

Minimum : 10

Options de suppression des vues

No Format
languagejs
themeConfluence
    # ┌─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐ #
    # │ ───────────────────────────────────────────────────    INTERFACE VIEWS TRASH OPTIONS    ─────────────────────────────────────────────────── │ #
    # └─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ #

    # ────────────────  All Views Parameters  ─────────────────────────────────────────────────────────────────────────────────────────────────────── #

    # ─── This option allows you to set the maximum number of days that views are kept in the trash.                                                ───
    # ───       /!\ After this delay, the views are permanently DELETED.                                                                            ───
    # ───       /!\ If you decrease the value, the too old views can be DELETED on daemon startup.                                                  ───
    # ───       /!\ Minimum value is 7 days.                                                                                                        ───
    #                                                                                                                                               ───
    #           Default : use_default_for_all => It will be equal to the 'views_trash__delay_before_deletion__default_for_all' of the WebUI         ───
    #           ...     : A number of days (for example 30)                                                                                         ───
    #                                                                                                                                               ───
    # 
Code Block
broker__module_webui__module_service_weather__default_external_link__external_part_url

Texte

---

external

Cette option vous permet de modifier le chemin d'accès aux liens externes.
Exemple d'url : http://localhost:7767/service-weather/external/abcd01/xyz009
Où :

  • http est la valeur du paramètre link_protocol
  • localhost:7767 est la valeur de la base url
  • external est la valeur de ce paramètre
  • abcd01 est l'uuid de la météo du service
  • xyz009 est l'uuid de configuration du lien externe

Le caractère "/" et les autres caractères interdits dans les URL ne sont pas autorisés dans ce paramètre.
Exemple de caractères interdit : !,#,$,&,',(,),*,+,,/,:,;,=,?,@,[,],<,>, caractères avec des accents…

Code Block
broker__module_webui__module_service_weather__default_external_link__base_url
Texte--- La base url du Broker

Cette option vous permet de modifier la base url d'accès aux liens externes.
Exemple d'url : http://localhost:7767/service-weather/external/abcd01/xyz009
Où :

  • http est la valeur du paramètre link_protocol
  • localhost:7767 est la valeur de ce paramètre
  • external est la valeur du paramètre external_part_url
  • abcd01 est l'uuid de la météo du service
  • xyz009 est l'uuid de configuration du lien externe

Le caractère "/" et les autres caractères interdits dans les URL ne sont pas autorisés dans ce paramètre.
Exemple de caractères interdit : !,#,$,&,',(,),*,+,,/,:,;,=,?,@,[,],<,>, caractères avec des accents…

Code Block
broker__module_webui__module_service_weather__views_trash__delay_before_deletion__service_weather use_default_for_all
default_external_link__link_protocol

Cette option vous permet de modifier le protocole utilisé par les url d'accès aux liens externes.
Exemple d'url : http://localhost:7767/service-weather/external/abcd01/xyz009
Où :

  • http est la valeur de ce paramètre
  • localhost:7767 est la valeur de la base url
  • external est la valeur du paramètre external_part_url
  • abcd01 est l'uuid de la météo du service
  • xyz009 est l'uuid de configuration du lien externe
La valeur peut-être
  • "http"
  • "https"
  • "protocol_from_webui" (qui correspond au protocole du serveur WebUI :
    • "http" si "use_ssl" est à 0
    • "https" si "use_ssl" est à 1
defaultexternallinkauthenticationneeded
Texte--- Le protocole du serveur WebUI
Code Block

Nom

Type

Unité

Défaut

Commentaire

No Format
broker__module_webui__module_service_weather__views_trash__
delay_
before_
deletion__
service_
weather 
Texte / Entier positif
Booléen 1 Cette option permet de choisir si une authentification est nécessaire pour avoir accès aux liens externes de la météo.
Warning
jour use_default_for_all

Nombre de jours durant lesquels les météos seront sauvegardées dans la poubelle

Minimum : 7

La modification de ce paramètre entraîne la modification de tous vos liens externes.

Options de performances

Code Block
languagejs
themeConfluence
    # ┌─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐ #
    # │ ────────────────────────────────────────────────────────    PERFORMANCE OPTIONS    ──────────────────────────────────────────────────────── │ #
    # └─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ #

    # ─── Maximal number of widgets for one weather page.                                                                                           ───
    # ─── Use this to limit your users and prevent them from making a weather page that takes                                                       ───
    # ─── all server resources.                                                                                                                     ───
    # ───                                                                                                                                           ───
    # broker__module_webui__module_service_weather__default_max_widget_number 100

    # ───────────────────────  CACHE  ─────────────────────────────────────────────────────────────────────────────────────────────────────────────── #

    # ─── The refresh interval in seconds between each cache data calculation.                                                                      ───
    # ─── Increase this period if the cache takes too many resources on server.                                                                     ───
    # ─── Minimum value is 60 seconds.                                                                                                              ───
    #                                                                                                                                               ───
    #           Default : 60 ( seconds )                                                                                                            ───
    #                                                                                                                                               ───
    # broker__module_webui__module_service_weather__cache__refresh_interval 60

    # ─── Define the limited time allowed to refresh the cache before raising a warning.                                                            ───
    # ─── This will be used by the shinken-broker-module-weather-service checks to change its state                                                 ───
    #                                                                                                                                               ───
    #           Default : 30 ( seconds )                                                                                                            ───
    #                                                                                                                                               ───
    # broker__module_webui__module_service_weather__cache__time_taken_for_compute_warning 30

    # ─── Define the limited time allowed to refresh the cache before raising an error.                                                             ───
    # ─── This will be used by the shinken-broker-module-weather-service checks to change its state                                                 ───
    #                                                                                                                                               ───
    #           Default : 40 ( seconds )                                                                                                            ───
    #                                                                                                                                               ───
    # broker__module_webui__module_service_weather__cache__time_taken_for_compute_critical 40  
code

Nom

Type

Unité

Défaut

Commentaire

Code Blocknoformat
broker__module_webui__module_service_weather__default_max_widget_number

Entier positif

---

100


Nombre maximal de widgets pour une page météo. Utilisez ceci pour limiter vos utilisateurs et les empêcher de faire une page météo qui prend toutes les ressources du serveur.

Cache
codecode les checks shinken-broker-module-weather-service.

Nom

Type

Unité

Défaut

Commentaire

No Format
broker__module_webui__module_service_weather__cache__refresh_interval
Entier positifseconde 60

L’intervalle de rafraîchissement en secondes entre chaque calcul de données du cache. Augmentez cette période si le cache prend trop de ressources sur le serveur.


Minimum : 60 secondes

No Format
broker__module_webui__module_service_weather__cache__time_taken_for_compute_warning
Entier positif--- 30

Définie la limite de temps alloué pour rafraîchir le cache, avant de générer un avertissement dans les checks de Sup de Sup. Ceci sera utilisé par les checks shinken-broker-module-weather-service.

No Format
broker__module_webui__module_service_weather__cache__time_taken_for_compute_critical
Entier positifseconde 40

Définie la limite temps alloué pour rafraîchir le cache avant de générer une erreur dans les checks de Sup de Sup. Ceci sera utilisé par

Options internes

les checks shinken-broker-module-weather-service.

Options internes

Code Block
languagejs
themeConfluence
    # ┌─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐ #
    # │ ─────────────────────────────────────────────────────────    INTERNAL OPTIONS    ────────────────────────────────────────────────────────── │ #
    # └─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ #

    # ─── INTERNAL : DO NOT EDIT FOLLOWING PARAMETERS WITHOUT YOUR DEDICATED SUPPORT                                                                ───
Code Block
languagejs
    # ┌─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐ #
    # │ ─────────────────────────────────────────────────────────    INTERNAL OPTIONS    ────────────────────────────────────────────────────────── │ #
    # └─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ #

    # ─── INTERNAL : DO NOT EDIT FOLLOWING PARAMETERS WITHOUT YOUR DEDICATED SUPPORT                  The time to wait before starting to refresh the cache                                                                                     ───
    # ─── At start of the Broker, some element data are not directly available                                               ───

    # ─── The time to wait before starting to refresh the cache        ───
    # ─── Increase this time if the module has "missing element" on every element at start                                                          ───
    # ─── At start of the Broker, some This will give more time to the Scheduler to give all element data areto notthe directlyBroker availableand the module                                           ───
    #                     ───
    # ─── Increase this time if the module has "missing element" on every element at start                                                          ───
    # ─── This will give more time to the Scheduler to give all element data to the Broker and the module                      ───
    #           Default : 30 ( seconds ) ───
    #                                                                                                       ───
    #                                    ───
    #           Default : 30 ( seconds )                                                                                       ───
    #   broker__module_webui__module_service_weather__awaited_time_before_fetching_element_data 30


Nom

Type

Unité

Défaut

Commentaire

No Format
broker__module_webui__module_service_weather__awaited_time_before_fetching_element_data
Entier positifseconde 30

Temps d’attente avant de commencer à rafraîchir le cache.

Au démarrage du Broker, certaines données ne sont pas disponibles.

Augmentez cette durée si le module affiche "élément manquant" sur chaque élément au démarrage.

Cela donnera plus de temps au Scheduler pour donner les données au Broker et au module.

Surcharge de la configuration

Code Block
languagejs
themeConfluence
    #          ───┌───────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐ #
    #  ─────────────────────────────────────────    EXTENDED FILE CONFIGURATION    ─────────────────────────────────────  #
    # └───────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ #
                                                                                                                               ───
    # broker__module_webui__
	[OVERRIDE_FROM] /etc/shinken-user/configuration/daemons/brokers/modules/webui/modules/webui_module_service_weather/webui_module_service_weather__default_grid_layout.cfg
    [OVERRIDE_FROM] /etc/shinken-user/configuration/daemons/brokers/modules/webui/modules/webui_module_service_weather/webui_module_service_weather__default_info_bar_layout.cfg
    [OVERRIDE_FROM] /etc/shinken-user/configuration/daemons/brokers/modules/webui/modules/webui_module_service_weather/webui_module_service_weather__default_widgets_layout.cfg
    [OVERRIDE_FROM] /etc/shinken-user/configuration/daemons/brokers/modules/webui/modules/webui_module_service_weather/webui_module_service_weather__awaiteddefault_time_before_fetching_element_data 30notifications_settings.cfg

Temps d’attente avant de commencer à rafraîchir le cache.

Au démarrage du Broker, certaines données ne sont pas disponibles.

Augmentez cette durée si le module affiche "élément manquant" sur chaque élément au démarrage.

Cela donnera plus de temps au Scheduler pour donner les données au Broker et au module.
NomTypeUnitéDéfautCommentaire
No Format
Code Block
broker__module_webui__module_service_weather__awaited_time_before_fetching_element_data
Entier positifseconde 30
languagejs
themeConfluence
 [OVERRIDE_FROM]
Texte------

Ce paramètre permet de surcharger les paramètres du module webui-module-service-weather.