| Scroll Ignore | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||
|
Concept
Cette page détaille les différentes options de configuration des modules de type webui__module_report_handler.
Activation du module
Configuration
Si aucun module de type webui__module_report_handler n'a été personnalisé, la configuration se trouve dans le fichier :
Le module webui--module-report-handler peut uniquement être activé sur un module de type webui.
L'activation du module d'effectue en ajoutant le nom de ce module dans le fichier de configuration du module WebUI/
Ouvrir le fichier de configuration du module WebUI ( exemple:- /etc/shinken/modules/webui--module-report-handler.cfg
La présence de ce module rend disponible la section Rapports dans le menu Les Synthèses de l'Interface de Visualisation.
Configuration
Un exemple de configuration se trouve également dans :
/etc/shinken-user-example/configuration/daemons/brokers/modules/webui/modules/
webui__module_report_handler
- /etc/shinken
/
modules/webui--module-report-handler
.cfg
Un exemple de configuration se trouve également dans :
/etc/shinken-user-example/configuration/daemons/brokers/modules/webui/modules/webui__module_report_handler/webui--module-report-handler-example.cfg
Exemple de fichier de configuration
| Code Block | ||||
|---|---|---|---|---|
| ||||
# CFG_FORMAT_VERSION 1 ( SHINKEN : DON'T TOUCH THIS LINE )
#================================================================================
# webui--module-report-handler
#================================================================================
# Modules that can load this module:
# - WebUI
# This module is used to handle reports generation on WebUI.
#================================================================================
define module {
# ┌───────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐ #
# │ ───────────────────────────────────────────── MODULE IDENTITY ───────────────────────────────────────────── │ #
# └───────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ #
# ─── Module name [ Must be unique ] [ MANDATORY ] ───
# ─── ───
module_name webui--module-report-handler
# ─── Module type [ Do not edit ] [ MANDATORY ] ───
# ─── ───
module_type webui__module_report_handler
# ┌───────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐ #
# │ ──────────────────────────────────────── REPORT BUILDER PARAMETERS ──────────────────────────────────────── │ #
# └───────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ #
# ──────────────────── PDF ConnectivityReports ─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────── #
# ─── This parameter definesActivates the externalPDF serverreports. addresses to use to generate reports. ───
# ─── Here is the syntax : <Protocol>://<Hostname>:<Port> ───
# ─── This option will add the PDF generation feature ( button in the reporting form, via URL ). ───
# ─── For now, the managed protocol are : http / https ───
# ─── /!\ The background task required to generate PDFs will consume up to 700 MB, PER WebUI MODULE AND ───
# ─── PER broker--module-report-builder MODULE, even when ───
not in use. # ───
# ─── /!\ This feature is NOT SUPPORTED on CentOS / RedHat 7. ───
# ─── ───
# Default : empty ( The WebUI will generate the report itself. ) ───
# ─── Example : http://127.0.0.1:24100, http://192.168.1.220:24100 ───
# ───
# ───
# Default : 0 => Disable ───
# webui__module_report_handler__report_builder__backends
# ─── Token used to authenticate on the broker--module-report-builder modules ───
# ─── Must be the token set in "broker__module_report_builder__token" option ───
# ... : 1 => Enable ───
# ─── of the broker--module-report-builder modules. ───
# ─── /!\ This token is used globally for all the backends defined above! ───
# ─── /!\ This means that all the Broker modules must have the same authentication token. ───
# ───
# webui__module_report_handler__report_builder__pdf_reports__enable 0
Default : [empty] # ──────────────────── Connectivity ───────────────────────────────────────────────────────────────────────────────── #
# ─── This parameter defines the external server addresses to use to generate reports. ───
# ─── Here is the syntax : <Protocol>://<Hostname>:<Port> ───
# ───
# ─── For now, the managed protocol are : http / https ───
# webui__module_report_handler__report_builder__token
# ────────────────────── Timeouts ─────────────────────────────────────────────────────────────────────────────────── #
# ─── How many seconds to consider a node does not answer. ───
# ───
# Default : empty ( The WebUI will generate the report itself. ) ───
# ─── Example : http://127.0.0.1:24100, http://192.168.1.220:24100 ───
# Default : 3 ( seconds ) ───
# ───
# ─── ───
# webui__module_report_handler__report_builder__backends
# ─── Token used to authenticate on the broker--module-report-builder modules ───
# webui ─── Must be the token set in "broker__module_report_handler__report_builder__timeout 3
token" option # ─── How many second to consider statistics data transfer to be failed ───
# ─── of the broker--module-report-builder modules. ───
# ───
# ─── /!\ This token is used globally for all the backends defined above! ───
# ───
# Default : 120 ( seconds ) /!\ This means that all the Broker modules must have the same authentication token. ───
# ─── ───
# ─── ───
# ───
# webui__module_report_handler__report_builder__data_timeout 120
# ┌───────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐ #
# │ ─────────────────────────────────────────────── STATISTICS ──────────────────────────────────────────────── │ #
# └───────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ #
# ─── Ranges definition for the performance check ───
# Default : [empty] ───
# ───
# ─── ───
# Default : 5,10,20,30,60,120,300,600 ( seconds ) ───
# webui__module_report_handler__report_builder__token
# ────────────────────── Timeouts ─────────────────────────────────────────────────────────────────────────────────── #
# ─── How many seconds to consider a node does not answer. ───
# ─── ───
# ───
# webui__module_report_handler__exec_stats_ranges 5,10,20,30,60,120,300,600
} |
Détail des sections composant le fichier de configuration
Identification du module
| Code Block | ||||
|---|---|---|---|---|
| ||||
# ┌───────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐ # # │ ───────────────────────────────────────────── MODULE IDENTITY ───────────────────────────────────────────── │ # # └───────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ # # ─── Module name [ Must be unique ] ─── # Default : 3 ( seconds ) [ MANDATORY ] ─── # ─── ─── # ─── ─── module_name ─── # webui--__module-_report-handler_handler__report_builder__timeout 3 # ───┌───────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐ Module# type [ Do not# edit│ ]─────────────────────────────────────────────── STATISTICS ──────────────────────────────────────────────── │ # # └───────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ # # ─── Ranges definition for the check "Broker - $KEY$ - Module Visualisation UI - Report Handler - Performance" ─── # ─── Example: [ MANDATORY ] ─── # ─── ─── # ─── - Reports written in less than 5 seconds will be classified in the first category. ─── # ─── module_type - Those made in less than 10 seconds will be in the second. webui__module_report_handler |
Il est possible de définir plusieurs instances de module de type webui__module_report_handler dans une architecture Shinken.
| No Format |
|---|
module_name |
Shinken conseille de choisir un nom en fonction de l'utilisation du module pour que la configuration soit simple à maintenir.
Doit être unique.
| No Format |
|---|
module_type |
Connexion aux modules externes de génération des rapports
| Code Block | ||||
|---|---|---|---|---|
| ||||
# ┌───────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐ # # │ ──────────────────────────────────────── REPORT BUILDER PARAMETERS ──────────────────────────────────────── │ # # └───────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ # ─── # ─── - etc. ─── # ──────────────────── Connectivity ───────────────────────────────────────────────────────────────────────────────── # # ─── This parameter defines the external server addresses to use to generate reports. ─── # ─── Here is the syntax : <Protocol>://<Hostname>:<Port> ─── # ─── For now, the managed protocol are : http / httpsDefault : 5,10,20,30,60,120,300,600 ( seconds ) ─── # ─── ─── # webui__module_report_handler__exec_stats_ranges Default5,10,20,30,60,120,300,600 } |
Détail des sections composant le fichier de configuration
Identification du module
| Code Block | ||||
|---|---|---|---|---|
| ||||
# ┌───────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐ # # │ ───────────────────────────────────────────── MODULE IDENTITY ───────────────────────────────────────────── │ # # └───────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ # # ─── Module name [ Must be unique ] : empty ( The WebUI will generate the report itself. ) ─── # ─── Example : http://127.0.0.1:24100, http://192.168.1.220:24100 [ MANDATORY ] ─── # ─── ─── # ─── module_name ─── # webui__module_report_handler__report_builder__backends # ─── Token used to authenticate on the brokerwebui--module-report-builderhandler modules # ─── Module type [ Do not edit ] ─── # ─── Must be the token set in "broker__module_report_builder__token" option [ MANDATORY ] ─── # ─── of the broker--module-report-builder modules. ─── # ─── /!\ This token is used globally for all the backends defined above! ─── module_type ─── # ─── /!\ This means that all the Broker modules must have the same authentication webui__module_report_handler |
Il est possible de définir plusieurs instances de module de type webui__module_report_handler dans une architecture Shinken.
- Chaque instance devra avoir un nom unique.
| Scroll Title | |||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||
|
Paramètres de génération de rapport
Génération des rapports PDF
REMARQUE : l'activation du processus de génération de PDF nécessite l'activation d'un module qui consomme 700 MB de RAM, module de Webui ou par module de génération de rapport ( broker--module-report-builder ).
- Ce surtout est présent tant que la fonctionnalité est activée, même si aucun rapport n'est généré.
| Code Block | ||||
|---|---|---|---|---|
| ||||
# ┌───────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐ # # │ ──────────────────────────────────────── REPORT BUILDER PARAMETERS ──────────────────────────────────────── │ # # └───────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ # # ──────────────────── PDF Reports ────────────────────────────────────────────────────────────────────────────────── # # ─── Activates the PDF reports.token. ─── # Default : [empty] ─── # ─── # webui__module_report_handler__report_builder__token # ────────────────────── Timeouts ─────────────────────────────────────────────────────────────────────────────────── # # ─── How many seconds to# consider─── aThis nodeoption doeswill notadd answer.the PDF generation feature ( button in the reporting form, via URL ). ─── # ─── /!\ The background task required to generate PDFs will consume up to 700 MB, PER WebUI MODULE AND ─── # ─── PER broker--module-report-builder MODULE, even when not in use. ─── # ─── /!\ This feature is NOT SUPPORTED on CentOS / RedHat 7. ─── # ─── Default : 3 ( seconds ) ─── # ─── ─── # ─── # webui__module_report_handler__report_builder__timeout 3 # ┌───────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐ #─── # │ ─────────────────────────────────────────────── STATISTICS ────────────────────────────────────────────────Default │: # 0 => Disable # └───────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ # # ─── Ranges definition for the performance check ─── # ... : 1 => Enable ─── # ─── ─── # Default : 5,10,20,30,60,120,300,600 ( seconds ) ─── # ─── ─── ─── # # webui__module_report_handler__exec_stats_ranges 5,10,20,30,60,120,300,600 }report_builder__pdf_reports__enable 0 |
| Scroll Title | ||||
|---|---|---|---|---|
| ||||
|
|
|
Voir la page Partage de charge lors de la génération des rapports SLA depuis le module WebUI pour plus d'information.
Valeurs possibles :
- Vide : Si aucune valeur n'est indiquée, le module générera lui-même les rapports.
- URL : L'URL d'accès au module qui générera les rapports. Il est possible d'accéder à plusieurs modules en séparant les URLs par des virgules.
- Exemple: http://127.0.0.1:24100, https://192.168.1.220:24100
| No Format |
|---|
webui__module_report_handler__report_builder__token |
Cette option permet de définir un jeton ( token ) qui sera utilisé pour s'authentifier auprès des modules dont l'accès aura été configuré dans l'option webui__module_report_handler__report_builder__backends.
| Warning |
|---|
Cela signifie que tous les modules de Broker doivent avoir le même jeton d'authentification. |
|
Connexion aux modules externes de génération des rapports
| Code Block | ||||
|---|---|---|---|---|
| ||||
# ──────────────────── Connectivity ───────────────────────────────────────────────────────────────────────────────── #
# ─── This parameter defines the external server addresses to use to generate reports. ───
# ─── Here is the syntax : <Protocol>://<Hostname>:<Port> ───
# ─── For now, the managed protocol are : http / https ───
# ───
# Default : empty ( The WebUI will generate the report itself. ) ───
# ─── Example : http://127.0.0.1:24100, http://192.168.1.220:24100 ───
# ───
# webui__module_report_handler__report_builder__backends
# ─── Token used to authenticate on the broker--module-report-builder modules ───
# ─── Must be the token set in "broker__module_report_builder__token" option ───
# ─── of the broker--module-report-builder modules. ───
# ─── /!\ This token is used globally for all the backends defined above! ───
# ─── /!\ This means that all the Broker modules must have the same authentication token. ───
# Default : [empty] ───
# ───
# webui__module_report_handler__report_builder__token
# ────────────────────── Timeouts ─────────────────────────────────────────────────────────────────────────────────── #
# ─── How many seconds to consider a node does not answer. ───
# ───
# Default : 3 ( seconds ) ───
# ─── ───
# webui__module_report_handler__report_builder__timeout 3 |
| Scroll Title | ||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||
|
Statistiques ( pour la supervision )
| Code Block | ||||
|---|---|---|---|---|
| ||||
# ─── Ranges definition for the check "Broker - $KEY$ - Module Visualisation UI - Report Handler - Performance" ───
# ─── Example: ───
# ─── - Reports written in less than 5 seconds will be classified in the first category. ───
# ─── - Those made in less than 10 seconds will be in the second. ───
# ─── - etc. ───
# ───
# Default : 5,10,20,30,60,120,300,600 ( seconds ) ───
# ─── ───
# |
webui__module_report_handler__ |
exec_ |
stats_ranges 5,10,20,30,60,120,300,600 |
| Scroll Title | ||||
|---|---|---|---|---|
|
Le nombre de secondes que le module attendra avant de considérer qu'un des modules dont l'accès est défini dans l'option webui__module_report_handler__report_builder__backends ne répond pas.
|
|
|
|