Page History

Description

Le module webui-module-service-weather permet au module WebUI ( l'interface de Visualisation ) du Broker d'afficher la vue météo des services
( Pour plus d'information voir : Vue : La météo des services )

Il gère :

• L'affichage des pages pour la météo des services,

• L’édition de ces pages,

• La possibilité d'avoir des liens extérieurs à Shinken qui pointent sur une météo des services,

• Le mécanisme de cache,

Activation du module

Activer le module webui-module-service-weather livré par défaut

Par défaut, l’installation ou la mise à jour de Shinken Entreprise va mettre à disposition une définition du module de type webui_module_service_weather

• La configuration de ce module se trouve par défaut dans le fichier : /etc/shinken/modules/webui_module_service_weather.cfg
• Vérifier que le nom "webui-module-service-weather" est présent dans le paramètre modules du fichier /etc/shinken/modules/webui.cfg.
  • Ce module est normalement présent dans la liste des modules livrés par défaut.

  • S'il n'y est pas ( car modifié ), vous pouvez le rajouter pour qu'il soit de nouveau actif.
    
    Exemple:
    

    Code Block
    language js
    define module { [...] module_name webui [...]   modules Module 1, Module 2, Module 3, webui-module-service-weather     [...] }

• Pour prendre en compte le changement de configuration, redémarrez l'Arbiter:
  

  Code Block

  language	bash
  theme	Emacs

  service shinken-arbiter restart

  
  

  Excerpt Include
  Fichier de configuration ( shinken.cfg ) Fichier de configuration ( shinken.cfg ) page DefaultLink[destination=Optional[PageResourceIdentifier[spaceKey=<null>,title=Fichier de configuration ( shinken.cfg )]],body=Optional.empty,tooltip=Optional.empty,anchor=Optional.empty,target=Optional.empty] nopanel true

Définir vos propres modules de type webui_module_service_weather

Définir plusieurs modules de type webui_module_service_weather permet d'avoir une configuration différente pour chaque module de type webui. En fonction de votre besoin, il n'est pas nécessaire de créer plusieurs modules de type webui_module_service_weather.

Exemple:

• J'ai envie que l'affichage de mes météos des services soit uniforme:  Il vaut mieux définir un seul fichier de configuration de module de type webui_module_service_weather puis le déclarer dans tous les modules de type webui.
• J'ai plusieurs clients qui ont besoin d'options d'affichage différentes:  Il est intéressant de définir plusieurs modules de type webui_module_service_weather afin d'avoir des configurations différentes sur chaque module de type webui.

Pour configurer votre module de type webui_module_service_weather, commencez par choisir un nom à lui donner.

• Pour l'exemple, nous allons l'appeler "Mon-Module-Webui-Module-Service-Weather".
• Remplacer dans l'exemple le mot "webui-module-service-weather" par le nom que vous aurez choisi.

Des fichiers de configuration d'exemple sont fournis pour vous aider à configurer votre module.

Pour cela, vous devez : 

• Copier le fichier de définition du module d'exemple : /etc/shinken-user-example/configuration/daemons/brokers/modules/webui/modules/webui_module_service_weather/webui_module_service_weather.cfg dans le répertoire de définition des modules /etc/shinken/modules/ et modifier son nom pour lui donner le nom que vous avez choisi.
  
  Exemple : /etc/shinken/modules/webui_module_service_weather__Mon_Module_Webui_Module_Service_Weather.cfg
  

  Code Block
  language bash theme Emacs
  cp /etc/shinken-user-example/configuration/daemons/brokers/modules/webui/modules/webui_module_service_weather/webui_module_service_weather.cfg /etc/shinken/modules/webui_module_service_weather__Mon_Module_Webui_Module_Service_Weather.cfg

• Dans ce nouveau fichier, changer le nom du module :
  

  Code Block
  language js
  ...     # ─── Module name [ Must be unique ] [ MANDATORY ] ─── # ─── ─── module_name                                         Mon-Module-Webui-Module-Service-Weather ...

• Une fois que le fichier a été édité, vérifier que le fichier possède comme droits utilisateurs shinken. Si ce n'est pas le cas, effectuez la commande suivante :
  

  Code Block
  language bash theme Emacs
  chown -R shinken:shinken /etc/shinken/modules/webui_module_service_weather__Mon_Module_Webui_Module_Service_Weather.cfg

• Ajouter le nom de votre module de type webui_module_service_weather au module webui en modifiant le paramètre modules du fichier /etc/shinken/modules/webui.cfg.
  

  Code Block
  language js
  define module { [...] modules       Module 1, Module 2, Module 3, Mon-Module-Webui-Module-Service-Weather [...] }

  
  

• Redémarrez l'Arbiter pour que le Broker puisse prendre en compte ce nouveau module.

  Code Block

  language	bash
  theme	Emacs

  service shinken-arbiter restart

  Excerpt Include
  Fichier de configuration ( shinken.cfg ) Fichier de configuration ( shinken.cfg ) page DefaultLink[destination=Optional[PageResourceIdentifier[spaceKey=<null>,title=Fichier de configuration ( shinken.cfg )]],body=Optional.empty,tooltip=Optional.empty,anchor=Optional.empty,target=Optional.empty] nopanel true

Configuration

La configuration de ce module est découpée en plusieurs parties, le détail de la configuration se trouve dans les pages suivantes :

• Pour la configuration général du module :  voir Configuration du module webui-module-service-weather 
• Pour la configuration de la disposition par défaut de la grille : voir Configuration de la disposition par défaut de la grille
• Pour la configuration de la disposition par défaut de la barre d'information : voir Configuration de la disposition par défaut de la barre d'information
• Pour la configuration de la disposition par défaut des widgets : voir Configuration de la disposition par défaut des widgets

Cas d'utilisation de plusieurs modules

Les Nous vous conseillons fortement que les modules webui et les modules webui_module_service_weather doivent être soient les mêmes pour éviter des problèmes de conflits pour le calcul ou l'affichage.