Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Make by tools (01.00.01) - action=clean_macro_parameter
Scroll Ignore
scroll-viewporttrue
scroll-pdftrue
scroll-officetrue
scroll-chmtrue
scroll-docbookhtmltruefalse
scroll-eclipsehelpdocbooktrue
scroll-epubeclipsehelptrue
scroll-htmlepubtrue
Panel
titleSommaire

Table of Contents
stylenone

Présentation - Widget Météo

Concept

Le Widget Météo permet d'afficher de manière concise des informations clés sur un service élément ( hôte ou cluster ).


Un widget météo est composé de ces informations : composable avec les informations suivantes :

  • Le nom du service ;de l'élément.
  • Le statut et son contexte ( s'il en a ) ;.
  • La valeur du SLA ;.
  • La tendance actuelle du SLA ( ascendante ou descendante ) ;

Il est possible de modifier les aspects suivants du widget météo :

  • .
  • L'icône du SLA.
  • L’indice de qualité de service.


On autorise une grande souplesse dans l'affichage de ce widget, c'est pour cela que beaucoup de choses sont configurables :

  • sa taille et sa position ( comme tous les autres widgets ),
  • le nom de l'élément :
    • Choix  entre
  • Sa taille et sa position ;
  • Le choix entre afficher
    • le nom de l'élément ou son nom de
    Visualisation ;
  • Comment sont affichés statut et contexte ;
  • Choisir parmi les options disponibles pour le type d'affichage de l'arrière-plan ;
    • visualisation.
    • Choix de la taille du texte.
    • Choix du nombre de lignes avant de mettre les trois petits points ( ... ).
    • Choix de l'alignement vertical.
  • les autres informations restent optionnelles ( statut, contexte, SLA et indice de qualité de service ).Est-ce que les informations de SLA sont affichées ou pas ;
Panel
titleExemple

Image RemovedImage Added

Description

Le nom du service

Le nom affiché dans le widget météo correspond à celui de l'hôte ou du cluster représenté.

En fonction de la configuration du widget, ce nom peut être :

  • Son nom ( host_name ) ;
  • Son nom d'affichage pour l'interface de Visualisation ( visualisation_name ) ;
Info

Pour configurer l'affichage du statut et du contexte, il faut modifier le paramètre "property_used_as_name". 

Pour plus d'informations sur le paramétrage de l'affichage du nom des widgets météo, veuillez vous référer à la page suivante : HIDDEN - V02.08.02 - Le paramétrage des widgets - Météo

La couleur de l'arrière-plan

La couleur d'arrière-plan des widgets météo est configurable de 4 manières différentes.

  • Un arrière-plan blanc, mais en faisant correspondre la couleur des bordures du widget avec celle du statut ou du contexte s'il y en a un ( "background" : "no_background" ).
  • Faire correspondre la couleur de l'arrière-plan avec celle du statut ( "background" : "only_status" ).
  • Faire correspondre la couleur de l'arrière-plan avec celle du statut OU du contexte s'il y en a un ( "background" : "context_then_status" ).
  • Faire correspondre la couleur de l'arrière-plan avec celle du statut ET du contexte s'il y en a un ( "background" : "context_and_status" ).
Info

Pour plus d'informations au sujet de ce paramètre, se référer au chapitre expliquant les différents paramètres de configuration du contenu d'un widget dans la page d'édition d'un widget météo ( voir la page :  Widget Météo - Édition visuelle - Météo ).

Pas d'arrière-plan

Aucun.

  • S'il y a un contexte, la couleur de la bordure du widget sera la couleur du contexte.
    • Autrement, la bordure sera de la couleur du statut.
  • L'arrière-plan du widget est blanc.


Panel
titleAffichage quand le widget à un contexte

Image Added



Panel
titleAffichage quand le widget n'a pas de contexte

Image Added


Couleur en fonction du statut uniquement

La couleur du statut seul.

  • La couleur de l'arrière-plan du widget météo va correspondre au statut de l'élément.



Panel
titleAffichage avec un statut "OK"

Image Added



Panel
titleAffichage un statut "WARNING"

Image Added


Couleur en fonction du statut ou du contexte

La couleur statut ou du contexte s'il en a un.

  • Si l'élément a un contexte, alors la couleur de son contexte va remplacer celle du statut.
  • Si l'élément n'a aucun contexte, la couleur de fond se basera sur la couleur du statut.



Panel
titleAffichage avec un contexte

Image Added



Panel
titleAffichage avec seulement le statut

Image Added


Couleur en fonction du statut et du contexte

La couleur du statut et du contexte.

  • Si l'élément n'a aucun contexte, la couleur de fond se basera sur la couleur du statut.
  • Si l'élément a un contexte, la couleur de fond sera de la couleur du contexte et du statut.
    • Un fond blanc sera affiché afin de pouvoir voir le nom de l'élément et le taux des SLA.



Panel
titleAffichage avec seulement le statut

Image Added



Panel
titleAffichage avec un statut et un contexte

Image Added


Les types d’icônes

La zone de gauches et la zone en haut à droite peuvent afficher différents types d’icônes ( un à la fois par zone ).
Il existe cinq types d'icônes différents :

  • le statut ( "icon_type" : "only_status" ),
  • le statut puis le contexte ( "icon_type" : "status_then_context" ),
  • le contexte puis le statut ( "icon_type" : "context_then_status" ),
  • la tendance SLA ( "icon_type" : "sla_tendency" ),
  • l'indicateur de qualité de service ( "icon_type" : "quality_service_icon" ).


Info

Le statut et le contexte

Le widget météo affiche le statut et le contexte d'un service grâce à des icônes.

  • La manière dont ces icônes s'affichent sur les widgets est paramétrable.
  • Il est alors possible de choisir lequel du statut ou du contexte on veut mettre en avant parmi ces possibilités :
    • L'icône du statut seulement ( le contexte ne sera pas affiché ) ;
    • L'icône du statut mise en avant ;
    • L'icône du contexte mise en avant ;
Pour configurer l'affichage du statut et du contexte, il faut modifier le paramètre "state_icon". 
Info

Pour plus d'informations au sujet de ce paramètre, veuillez vous référer à la page suivante : HIDDEN - V02.08.02 - Le paramétrage des widgets - Météose référer au chapitre expliquant les différents paramètres de configuration du contenu d'un widget dans la page d'édition d'un widget météo ( voir la page  :  Widget Météo - Édition visuelle - Météo ).

Warning

La zone en haut à droite ne peut pas utiliser le type d'icône "tendance SLA" ( "icon_type" : "sla_tendency" ) !

Anchor
weatherWidgetTypeIcones
weatherWidgetTypeIcones

Le statut

Affichage de l'icône du statut uniquement

Icône du statut seulement ( state"icon_icon type" :  "only_status" ):.

  • Seule l'icône du statut sera affichée et celle du contexte n'apparaîtra pas.



Panel
titleAffichage du statut
uniquement

Image Removed

Image Added


Le statut puis le

Mise en avant du statut par rapport au

contexte

Icône du statut mise en avant avant  ( state"icon_icon type" : "status_then_context" ):.

  • L'icône du statut sera mise en avant par rapport à celle du contexte ( le statut sera toujours le plus grand ).
  • S'il n'y a pas de contexte, seulement l’icône du statut sera affichée.



Panel
titleAffichage Statut avec un contexte

Image RemovedImage Added



Panel
title
Affichage avec seulement le statut

Image Removed

Statut sans contexte

Image Added


Le contexte puis le

Mise en avant du contexte par rapport au

statut

Icône du contexte mise en avant avant  ( state"icon_icon type" : "context_then_status" ):.

  • L'icône du contexte sera mise en avant par rapport à celui celle du statut ( le contexte sera toujours le plus grand ).
  • S'il n'y a pas de contexte, seulement l’icône du statut sera affichée.


Panel
titleAffichage Statut avec un contexte

Image RemovedImage Added



Panel
title
Affichage avec seulement le statut

image2021-10-7_12-17-39.pngImage Removed

La couleur de l'arrière-plan

La couleur d'arrière-plan des widgets météo est configurable de 4 manières différentes :

  • Masquer l'arrière-plan.
  • Faire correspondre la couleur l'arrière-plan avec celle du statut.
  • Faire correspondre la couleur l'arrière-plan avec celle du statut et du contexte.
    • Si le service a un contexte, la couleur de l'arrière-plan sera composée des deux couleurs en même temps.
  • Faire en sorte que la couleur du contexte remplace celle du statut lorsque le service en a un.
Statut sans contexte

Image Added


La tendance SLA

Anchor
weatherWidgetTendencyCompute
weatherWidgetTendencyCompute

L'affichage sera une flèche dont l'orientation et la couleur donnent un aperçu de la tendance des SLAs.

La tendance va monter, descendre ou stagner en fonction de 2 critères : 

  • le statut de l'élément,
  • le paramétrage des SLAs

Le calcul de la tendance est le suivant :

Panel

Image Added

Exemple


Panel
titleStatut "Attention" exclu

Image Added



Panel
titleStatut "Inconnu" compte comme OK

Image Added


Info
Le type d’icône "tendance SLA" peut être aussi affiché dans la zone SLA.

L'indicateur de qualité de service

L'indicateur de qualité de service donne une vision imagé de la synthèse du taux SLA et du statut.

On a fait un parallèle avec les phénomènes météorologiques en partant du fait que :

  • le "Soleil" est positif,
  • les "Éclairs" sont négatifs,
  • l'existence d'états intermédiaires.


Le tableau suivant montre les possibilités.

Panel

Image Added

IcôneSignification

Image Added

Grand soleil : la qualité de service est très bonne et aucun souci à l'horizon.

Image Added

Le soleil cache le nuage, le temps se lève : le service a eu certains problèmes, mais les problèmes sont résolues et la qualité de service s'améliore.

Image Added

Le nuage cache le soleil, le temps se couvre : tout allait bien mais des problèmes sont en cours, la qualité de service se dégrade.

Image Added

Les nuages gris, temps couvert : la qualité de service est médiocre. Il faut regarder la tendance pour voir si l'amélioration est en cours ou inversement.

Image Added

Les nuages noirs, temps orageux :  la qualité de service est très préoccupante, aucune prévision de rétablissement en vue.

Image Added

Éclair, tempête en cours :  la qualité de service est catastrophique.
Panel
titleExemple

Image Added

Info

Quand la qualité de service est affichée, la flèche de tendance SLA est affichée à côté de l'icône de la qualité de service et est masquée à côté des SLAs afin d'alléger l’affichage ( car il s’agit de la même information ).


Anchor
weatherWidgetMainInformation
weatherWidgetMainInformation

Panel

Image Added

Les Zones

Le Widget Météo est divisé en quatre zones:

  • La zone de gauche ( obligatoire ).
  • La zone du nom de l'élément ( obligatoire ).
  • La zone en haut à droite ( optionnelle ).
  • La zone SLA ( optionnelle ).

Chaque zone possède sa propre configuration.

Panel
titleExemple


Image Added

La zone de gauche ( obligatoire )

La zone de gauche est obligatoire, elle permet d'afficher une icône . Cinq types d’icônes différents peuvent être affichés ( voir le chapitre : Les types d'icônes ).


Pour configurer la couleur de l'arrière-plan des widgets météo, il faut modifier le paramètre "background". 
Info
Info

Pour plus d'informations au sujet de ce paramètre, veuillez vous référer à la page suivante : HIDDEN - V02.08.02 - Le paramétrage des widgets - Météo

Pas d'arrière-plan

se référer au chapitre expliquant les différents paramètres de configuration du contenu d'un widget dans la page d'édition d'un widget météo ( voir la page :  Widget Météo - Édition visuelle - Météo ).

Warning

Un même type d'icône ne peut pas être défini à la fois dans la zone de gauche et dans la zone en haut à droite et inversement.

Affichage selon les types d’icônes


Panel
titleAffichage avec seulement le statut

Image Added

Aucun  ( backgroundno_background ) :

  • S'il a un contexte, la couleur de la bordure du widget sera la couleur du contexte.
    • Autrement la bordure sera de la couleur du statut.
  • Dans tous les cas l'arrière-plan du widget restera blanc :



    Panel
    titleAffichage avec
    un contexteImage Removed
    le statut puis le contexte s'il y en a un

    Image Added


    Panel
    titleAffichage avec le contexte s'il y en a un puis le statut

    Image Removed

    Couleur en fonction du statut uniquement

    La couleur du statut seul ( background : only_status ) :

    La couleur de l'arrière-plan du widget météo va correspondre au statut du service.
    Panel
    titleAffichage avec seulement le statut OK

    image2021-10-7_12-17-39.pngImage Removed

    Panel
    titleAffichage avec seulement le statut WARNING

    Image Removed

    Couleur en fonction du statut et du contexte

    La couleur du statut et du contexte( background : context_and_status ) :
  • Si le service n'a aucun contexte, la couleur de fond se basera sur la couleur du statut.
  • Si le service a un contexte, la couleur de fond sera de la couleur du contexte et du statut. Un fond blanc sera affiché afin de pouvoir voir le nom du service et le taux des SLA.
    Panel
    titleAffichage avec seulement le statut

    image2021-10-7_12-17-39.pngImage Removed

    Panel
    titleAffichage avec un statut et un contexte

    Image Removed

    Couleur du contexte prioritaire

    La couleur du contexte si existant autrement la couleur du statut ( background : context_then_status ) :

    Image Added

    Panel
    titleAffichage avec l'indicateur de qualité de service

    Image Added

    Panel
    titleAffichage de la tendance SLA

    Image Added


    La zone du nom de l'élément ( obligatoire )

    Texte à afficher

    Le nom affiché dans le widget météo correspond à celui de l'hôte ou du cluster représenté.

    En fonction de la configuration du widget, ce nom peut être :

    • son nom ( "property_used_as_name" : "item_name"  ),
    • son nom d'affichage pour l'interface de Visualisation ( "property_used_as_name" : "visualisation_name" ).
    Info
    • Le nom des éléments dans les liens externes "non authentifié" sera toujours le "nom d'affichage pour l'interface de Visualisation" ( "property_used_as_name" : "visualisation_name" )
    • Pour plus d'informations au sujet de ce paramètre, se référer au chapitre expliquant les différents paramètres de configuration du contenu d'un widget dans la page d'édition d'un widget météo ( voir la page :  Widget Météo - Édition visuelle - Météo ).
    Comportement du texte et zoom de la police

    Le comportement du texte suit les règles suivantes :

    • Le texte n'est pas limité en taille.
      • mais si le texte n'a pas la place de s'afficher, il sera tronqué ( avec une "ellipsis"   une série de trois petits points ).
    • La taille de la police va se définir automatiquement en fonction de la largeur de la vue ( Taille du navigateur, ou taille d'affichage dans un autre site web ) et du pourcentage de zoom de la police paramétré.
      • Pour pouvoir être responsive, la taille de police du texte s'adapte à la taille de la vue afin de pouvoir être affichée sur toutes les tailles d'écran.
        Cela permet une meilleure intégration dans le portail d'un site web.

        Elle est adaptée de façon à pouvoir mettre environ 30 lettres en majuscules sur deux lignes ( "nb_lines_max" : 2 ) dans le texte avant que celui-ci ne dépasse (si le pourcentage de zoom de la police est paramétré à 100% ( "font_zoom_percent" : 10 0 ) ).

        La police utilisée n'a pas de taille de caractère fixe, donc suivant les lettres présentes dans le texte, le nombre de caractères affichés pourra être différent de 30 ( pour des i minuscules par exemple ).

      • Shinken a volontairement fait le choix de se baser uniquement sur la taille de la vue et non celle du widget.
    Note

    Voici une liste de taille de police selon la taille du navigateur.
    La grille ( cf. Concept de la grille pour le positionnement des widgets ) fait 60 de largeur ( "nb_tiles_in_width" : 60 ), le widget fait 15 de large ( "width" : 15 ) et 5 de hauteur ( "height" : 5 ).

    Taille de la vue ( en pixel )Taille de la police ( en pixel ), pour un pourcentage de zoom de la police à 50%Taille de la police ( en pixel ), pour un pourcentage de zoom de la police à 100%
    25601938
    19201428
    15001122
    1200817
    1000714
    800511
    60048
    Nombre de ligne à afficher avant les trois petits points

    Pour permettre un affichage plus spécifique aux besoins, on permet de choisir le nombre de lignes de texte à afficher dans la zone de texte. Si la taille du widget ne permet pas d'afficher autant de ligne , il en affichera le maximum possible.

    Par défaut le nombre de lignes maximum est de deux ( "nb_lines_max" : 2 ).



    Panel
    titleAffichage avec 3 lignes sans les SLA

    Image Added



    Panel
    titleAffichage avec 2 lignes sans les SLA

    Image Added


    Alignement vertical du texte

    Pour permettre un affichage plus spécifique, on permet de choisir l'alignement vertical du texte.

    Par défaut, l'alignement vertical est au milieu ( "vertical_align" : "middle" ).


    Panel
    titleAffichage au milieu

    Image Added



    Panel
    titleAffichage en bas

    Image Added



    Panel
    titleAffichage en haut

    Image Added




    La zone en haut à droite ( optionnelle )

    La zone en haut à droite est optionnelle, elle permet d'afficher une icône. Quatre types d’icônes différents peuvent être affichés ( voir le chapitre : Les types d'icônes ).

    Info

    Pour plus d'informations au sujet de ce paramètre, se référer au chapitre expliquant les différents paramètres de configuration du contenu d'un widget dans la page d'édition d'un widget météo ( voir la page  Widget Météo - Édition visuelle - Météo ).

    Warning

    Un type d'icône ne peut pas être définie à la fois dans la zone de gauche et dans la zone en haut à droite et inversement.

    Affichage selon les types d’icônes


    Panel
    titleAffichage avec seulement le statut

    Image Added



    Panel
    titleAffichage avec le statut puis le contexte s'il y en a un

    Image Added


    Panel
    titleAffichage avec le contexte s'il y en a un puis le statut

    Image Added

    Panel
    titleAffichage avec l'indicateur de qualité de service

    Image Added

    La zone SLA ( optionnelle )

    La zone SLA n'est pas obligatoire ( "displayed" : true ).

    L'affichage des SLA est composé de trois parties:

    1. le pourcentage SLA,
    2. la tendance SLA ( pas de paramètre nécessaire ),
      1. Une flèche dont l'orientation et la couleur changent en fonction de la situation (voir le chapitre : La tendance SLA pour le comportement ).
      2. La flèche est systématiquement affichée dans cette zone sauf dans 2 cas : 
        • si la zone de gauche est paramétrée pour afficher la tendance SLA ( "icon_type" : "sla_tendency" ) => Inutile de l'afficher 2 fois une flèche indiquant la même chose,
        • si la zone de gauche ou la zone en haut à droite est paramétrée pour afficher l'indicateur de qualité de service ( "icon_type" : "quality_service_icon" ) => Inutile de l'afficher 2 fois une flèche indiquant la même chose, car la tendance SLA sera directement affichée avec l’icône de l'indicateur de qualité de service.
    3. l’icône SLA ( "show_icon" : true ).


    Info
  • Si le service a un contexte, alors la couleur de son contexte va remplacer celle du statut.
  • Si le service n'a aucun contexte, la couleur de fond se basera sur la couleur du statut.
    Panel
    titleAffichage avec un contexte

    Image Removed

    Panel
    titleAffichage avec seulement le statut

    image2021-10-7_12-17-39.pngImage Removed

    La valeur de SLA

    Affiche le pourcentage du taux de SLA.

    La couleur de la valeur dépendra du seuil d'avertissement défini dans le service en question :

    • Si la valeur est au-dessus du seuil d'avertissement, le taux SLA est OK et la valeur sera affichée en vert.
    • Si la valeur est en dessous du seuil d'avertissement, le taux SLA est en avertissement et la valeur sera affichée en orange.
    • Si la valeur est en dessous du seuil critique, le taux SLA devient critique et la valeur sera affichée en rouge.
    Il est possible de désactiver l'affichage des SLA avec le paramètre "display_sla"
    Info

    Pour plus d'informations au sujet de ce paramètre, veuillez vous référer à la page suivante : HIDDEN - V02.08.02 - Le paramétrage des widgets - Météo

    La tendance des SLA

    Cet affichage donne un aperçu de la tendance des SLA, c’est-à-dire si elle augmente, diminue ou stagne.

    se référer au chapitre expliquant les différents paramètres de configuration du contenu d'un widget dans la page d'édition d'un widget météo (voir la page : Widget Météo - Édition visuelle - Météo )

    Options d'affichage

    Anchor
    weatherWidgetQualityOfService
    weatherWidgetQualityOfService


    Panel
    titleAffichage caché

    Image Added



    Panel
    titleAffichage avec l'icône et la tendance

    Image Added





    Panel
    titleAffichage avec l'icône sans la tendance

    Image Added

    Info

    La tendance n'est affichée que si la valeur SLA est affichée aussi.

    La tendance des SLA se matérialise sur le widget météo par une flèche dont la direction indique si elle augmente, diminue, ou stagne :

  • La tendance augmente : Image Removed
  • La tendance diminue    : Image Removed
  • La tendance stagne      : Image Removedsi le taux SLA est inférieur au seuil d'avertissement, sinon la flèche est verte Image Removed
    avec SLAimage2021-10-7_12-17-39.pngImage Removed



    Panel
    titleAffichage
    sans l'icône avec la tendance

    Image Added




    Panel
    titleAffichage sans l'icône et sans la tendance

    Image Added





    Calcul de l'affichage du taux et l'icône
    Descriptioncouleur de la valeurIcône
    Le taux SLA est OK

    affichée en vert

    Image Added

    Le taux SLA est en avertissement

    affichée en orange

    Image Added

    Le taux SLA
    Image Removed
    est critique

    affichée en rouge

    Image Added

    Affichage si

    le service n

    l'élément n'existe pas

    Un service élément peut ne pas exister pour plusieurs raisons :

    1. Il il n'existe pas ou plus dans la configuration.,
    2. Il il existe, mais il est désactivé.

    La manière dont est affiché un widget météo avec un service élément inexistant diffère en fonction de d'où l'on regarde la météo :

    • Sur la vue éditable ( accessible uniquement par les administrateurs de Shinken ), le widget sera affiché, mais avec un avertissement indiquant qu'il n'a pas été trouvé.
    • Sur les liens externes, le widget ne sera pas affiché, et il y aura donc un espace vide à sa place.


    Panel
    titleWidget météo avec un service inexistant

    Image Added

    Info

    Pour plus d'informations sur les liens externes, veuillez vous référer se référer à la page suivante : HIDDEN - V02.08.02 - Depuis l'extérieur de Shinken - MétéoLa vue météo hors de Shinken.

    Exemples d'affichage d'un widget avec un

    service

    élément non existant

    Affichage d'un widget dont le service l'élément n'est pas trouvé depuis la vue d'édition d'une météo ( encadré en bleu ).

    Panel
    titleExemple d'une météo des services depuis la vue d'édition

    Image Removed

    Image Added

    Sur un lien externe, le widget dont le service l'élément n'est pas trouvé ne sera pas affiché et un espace vide sera à son emplacement ( encadré en bleu ).

    Panel
    titleExemple de météo des services depuis un lien externe

    Image Removed

    Image Added

    Info

    Les erreurs des éléments non trouvés dans une météo des services seront remontées dans le check de supervision du module.

    Affichage si on a pas les droits pour voir l'élément sur un lien externe

    Il est possible d'exiger une authentification sur un lien externe. Si la personne connecté au lien externe, n'a pas les droits suffisant pour voir l'élément en question, alors un affichage spécial est mis en place.

    Exemples d'affichage d'un widget avec un élément sur lequel l'utilisateur n'a pas les droits

    Panel
    titleWidget météo avec un élément et un utilisateur n'ayant pas les droits de voir le service

    Image Added

    Panel
    titleExemple d'un widget météo affichant un élément dont l'utilisateur n'a pas accès dans un lien externe

    Image Added

    Comportement du widget

    Comportement des widgets météo

    lors d'un redimensionnement du navigateur

    Étant donné que la taille de la grille ( et donc la taille des widgets ) est calculée en fonction de la largeur du navigateur, la taille d'un widget diminue proportionnellement à la taille du navigateur.

    Il y a cependant une taille minimale pour la police d'écriture des widgets ( qui est de 9 pixels ).

    Info

    Si l'écriture sur un widget météo est tronqué tronquée , il peut être nécessaire d'augmenter sa hauteur ( "height" : 7 ) et son nombre de lignes maximum ( "nb_lines_max" : 4 ).

    Exemples de redimensionnement

    Panel
    titleExemple de météo sur un navigateur de 1200 pixels de large

    Image AddedImage Removed

    Panel
    bgColorwhitesmoke
    titleExemple de météo sur un navigateur de 600 pixels de large

    Image Added

    Affichage avec une Erreur et un Avertissement

    Panel

    Image AddedImage Removed