1 Configuration d'une carte réseau

Vue d'ensemble

La configuration d'une carte dans Zabbix nécessite d'abord de créer une carte en définissant ses paramètres généraux, puis de commencer à remplir la carte proprement dite avec des éléments et leurs liens.

Vous pouvez renseigner la carte avec des éléments qui sont un hôte, un groupe d'hôtes, un déclencheur, une image ou une autre carte.

Des icônes sont utilisées pour représenter les éléments de la carte. Vous pouvez définir les informations qui seront affichées avec les icônes et configurer l'affichage des problèmes récents d'une manière particulière. Vous pouvez relier les icônes et définir les informations à afficher sur les liens.

Vous pouvez ajouter des URL personnalisées accessibles en cliquant sur les icônes. Ainsi, vous pouvez associer une icône d'hôte aux propriétés de l'hôte ou une icône de carte à une autre carte.

Le nombre de problèmes dans les cartes est affiché uniquement pour les problèmes de cause.

Les cartes sont gérées dans Monitoring > Maps, où elles peuvent être configurées, gérées et consultées. Dans la vue de surveillance, vous pouvez cliquer sur les icônes et profiter des liens vers certains scripts et URL.

Les cartes réseau sont basées sur des graphiques vectoriels (SVG).

Cartes publiques et privées

Tous les utilisateurs de Zabbix (y compris les utilisateurs non administrateurs) peuvent créer des cartes réseau. Les cartes ont un propriétaire : l’utilisateur qui les a créées. Les cartes peuvent être publiques ou privées.

  • Les cartes publiques sont visibles par tous les utilisateurs, bien que, pour les voir, l’utilisateur doive avoir un accès en lecture à au moins un élément de la carte. Les cartes publiques peuvent être modifiées si un utilisateur/groupe d’utilisateurs dispose des autorisations de lecture-écriture pour cette carte et d’au moins des autorisations de lecture sur tous les éléments de la carte correspondante, y compris les déclencheurs dans les liens.
<!-- -->
  • Les cartes privées ne sont visibles que par leur propriétaire et les utilisateurs/groupes d’utilisateurs avec lesquels la carte est partagée par le propriétaire. Les utilisateurs ordinaires (non Super admin) ne peuvent partager qu’avec les groupes auxquels ils appartiennent et les utilisateurs qui appartiennent à ces groupes. Les utilisateurs de niveau Admin peuvent voir les cartes privées, qu’ils en soient propriétaires ou qu’ils figurent ou non dans la liste des utilisateurs avec lesquels elles sont partagées. Les cartes privées peuvent être modifiées par le propriétaire de la carte et si un utilisateur/groupe d’utilisateurs dispose des autorisations de lecture-écriture pour cette carte et d’au moins des autorisations de lecture sur tous les éléments de la carte correspondante, y compris les déclencheurs dans les liens.

Les éléments de carte pour lesquels l’utilisateur ne dispose pas d’une autorisation de lecture sont affichés avec une icône grisée et toutes les informations textuelles sur l’élément sont masquées. Cependant, l’étiquette du déclencheur reste visible même si l’utilisateur n’a aucune autorisation sur le déclencheur.

Pour ajouter un élément à la carte, l’utilisateur doit également disposer d’au moins une autorisation de lecture sur cet élément.

Création d'une carte

Pour créer une carte, procédez comme suit :

  • Accédez à Monitoring > Maps
  • Accédez à la vue avec toutes les cartes
  • Cliquez sur Create map

Vous pouvez également utiliser le bouton Clone dans le formulaire de configuration d'une carte existante pour créer une nouvelle carte. Cette carte aura toutes les propriétés de la carte existante, y compris les attributs généraux de mise en page, ainsi que les éléments de la carte existante.

L'onglet Map contient les attributs généraux de la carte :

Tous les champs obligatoires sont marqués d'un astérisque rouge.

Attributs généraux de la carte :

Parameter Description
Owner Nom du propriétaire de la carte.
Name Nom unique de la carte.
Width Largeur de la carte en pixels.
Height Hauteur de la carte en pixels.
Background image Utiliser une image d'arrière-plan :
No image - aucune image d'arrière-plan (fond blanc)
Image - image sélectionnée à utiliser comme image d'arrière-plan. Aucun redimensionnement n'est effectué. Vous pouvez utiliser une carte géographique ou toute autre image pour enrichir votre carte.
Automatic icon mapping Vous pouvez activer un mappage automatique des icônes, configuré dans Administration → General → Icon mapping. Le mappage des icônes permet d'associer certaines icônes à certains champs d'inventaire de l'hôte.
Icon highlight Si vous cochez cette case, les éléments de la carte seront mis en évidence.
Les éléments avec un déclencheur actif recevront un fond rond, de la même couleur que le déclencheur de gravité la plus élevée. De plus, une ligne verte épaisse sera affichée autour du cercle si tous les problèmes sont acquittés.
Les éléments avec un statut "disabled" ou "in maintenance" auront un fond carré, gris et orange respectivement.
Voir aussi : Viewing maps
Mark elements on trigger status change Un changement récent du statut d'un déclencheur (problème récent ou résolution) sera mis en évidence par des marqueurs (triangles rouges pointant vers l'intérieur) sur les trois côtés de l'icône de l'élément qui sont libres de l'étiquette. Les marqueurs sont affichés pendant 30 minutes.
Display problems Sélectionnez la manière dont les problèmes sont affichés avec un élément de carte :
Expand single problem - s'il n'y a qu'un seul problème, le nom du problème est affiché. Sinon, le nombre total de problèmes est affiché.
Number of problems - le nombre total de problèmes est affiché
Number of problems and expand most critical one - le nom du problème le plus critique et le nombre total de problèmes sont affichés.
Le "plus critique" est déterminé en fonction de la gravité du problème et, à gravité égale, de l'ID de l'événement du problème (l'ID le plus élevé ou le problème le plus récent est affiché en premier). Pour un trigger map element, cela est basé sur la gravité du problème et, à gravité égale, sur la position du déclencheur dans la liste des déclencheurs. En cas de plusieurs problèmes du même déclencheur, le plus récent sera affiché.
Advanced labels Si vous cochez cette case, vous pourrez définir des types d'étiquettes distincts pour différents types d'éléments.
Map element label type Type d'étiquette utilisé pour les éléments de carte :
Label - étiquette de l'élément de carte
IP address - adresse IP
Element name - nom de l'élément (par exemple, nom d'hôte)
Status only - statut uniquement (OK ou PROBLEM)
Nothing - aucune étiquette n'est affichée
Map element label location Emplacement de l'étiquette par rapport à l'élément de carte :
Bottom - en dessous de l'élément de carte
Left - à gauche
Right - à droite
Top - au-dessus de l'élément de carte
Problem display Afficher le nombre de problèmes comme suit :
All - le nombre total de problèmes sera affiché
Separated - le nombre de problèmes non acquittés sera affiché séparément sous forme de nombre par rapport au nombre total de problèmes
Unacknowledged only - seul le nombre de problèmes non acquittés sera affiché
Minimum trigger severity Les problèmes inférieurs au niveau de gravité minimum sélectionné ne seront pas affichés sur la carte.
Par exemple, avec Warning sélectionné, les changements liés aux déclencheurs de niveau Information et Not classified ne seront pas reflétés sur la carte.
Show suppressed problems Cochez la case pour afficher les problèmes qui seraient autrement supprimés (non affichés) en raison de la maintenance de l'hôte.
URLs Des URL (jusqu'à 2048 caractères) peuvent être définies pour chaque type d'élément. Une étiquette pour l'URL peut également être définie. Elles seront affichées sous forme de liens lorsqu'un utilisateur clique sur l'élément en mode de visualisation de la carte.
Des macros peuvent être utilisées dans les noms et les valeurs des URL de carte. Pour une liste complète, voir supported macros et recherchez 'map URL names and values'.

Partage

L'onglet Sharing contient le type de carte ainsi que les options de partage (groupes d'utilisateurs, utilisateurs) pour les cartes privées :

Parameter Description
Type Sélectionnez le type de carte :
Private - la carte est visible uniquement pour les groupes d'utilisateurs et les utilisateurs sélectionnés
Public - la carte est visible pour tous
List of user group shares Sélectionnez les groupes d'utilisateurs auxquels la carte est accessible.
Vous pouvez autoriser un accès en lecture seule ou en lecture-écriture.
List of user shares Sélectionnez les utilisateurs auxquels la carte est accessible.
Vous pouvez autoriser un accès en lecture seule ou en lecture-écriture.

Lorsque vous cliquez sur Add pour enregistrer cette carte, vous avez créé une carte vide avec un nom, des dimensions et certaines préférences. Vous devez maintenant ajouter des éléments. Pour cela, cliquez sur Edit dans la liste des cartes pour ouvrir la zone modifiable.

Ajout d'éléments

Pour ajouter un élément, cliquez sur Add à côté de Map element. Le nouvel élément apparaîtra dans le coin supérieur gauche de la carte. Faites-le glisser et déposez-le où vous voulez.

Notez qu'avec l'option Grid sur "On", les éléments s'aligneront toujours sur la grille (vous pouvez choisir différentes tailles de grille dans la liste déroulante, et aussi masquer/afficher la grille). Si vous souhaitez placer des éléments n'importe où sans alignement, mettez l'option sur "Off". (Vous pouvez aligner plus tard des éléments aléatoires sur la grille en cliquant sur Align map elements.)

Maintenant que vous avez placé quelques éléments, vous souhaiterez peut-être commencer à les différencier en leur donnant des noms, etc. En cliquant sur l'élément, un formulaire s'affiche et vous pouvez définir le type d'élément, lui donner un nom, choisir une icône différente, etc.

Attributs de l'élément de carte :

Parameter Description
Type Type de l'élément :
Host - icône représentant l'état de tous les déclencheurs de l'hôte sélectionné
Map - icône représentant l'état de tous les éléments d'une carte
Trigger - icône représentant l'état d'un ou plusieurs déclencheurs
Host group - icône représentant l'état de tous les déclencheurs de tous les hôtes appartenant au groupe sélectionné
Image - une icône, non liée à une ressource quelconque
Label Libellé de l'icône, toute chaîne de caractères.
Les macros et les chaînes multilignes peuvent être utilisées.
Les macros d'expression sont prises en charge dans ce champ, mais uniquement avec les fonctions avg, last, min et max, avec le temps comme paramètre (par exemple, {?avg(/host/key,1h)}).
Pour une liste complète des macros prises en charge, voir macros prises en charge et rechercher 'map element labels'.
Label location Emplacement du libellé par rapport à l'icône :
Default - emplacement de libellé par défaut de la carte
Bottom - sous l'icône
Left - à gauche
Right - à droite
Top - au-dessus de l'icône
Host Saisissez l'hôte si le type d'élément est 'Host'. Ce champ est en saisie semi-automatique, donc commencer à taper le nom d'un hôte affichera une liste déroulante des hôtes correspondants. Faites défiler vers le bas pour sélectionner. Cliquez sur 'x' pour supprimer la sélection.
Map Sélectionnez la carte si le type d'élément est 'Map'. Ce champ est en saisie semi-automatique, donc commencer à taper le nom d'une carte affichera une liste déroulante des cartes correspondantes. Faites défiler vers le bas pour sélectionner. Cliquez sur 'x' pour supprimer la sélection.
Triggers Si le type d'élément est 'Trigger', sélectionnez un ou plusieurs déclencheurs dans le champ New triggers ci-dessous et cliquez sur Add.
L'ordre des déclencheurs sélectionnés peut être modifié, mais uniquement au sein d'une même gravité de déclencheurs. La sélection de plusieurs déclencheurs affecte également la résolution des macros {HOST.*} en mode édition et en mode affichage.
En mode édition, les premières macros {HOST.*} affichées seront résolues en fonction du premier déclencheur de la liste (selon la gravité du déclencheur).
Le mode affichage dépend du paramètre Display problems dans les attributs généraux de la carte :
- Si le mode Expand single problem est choisi, les premières macros {HOST.*} affichées seront résolues en fonction du dernier déclencheur de problème détecté (quelle que soit la gravité) ou du premier déclencheur de la liste (si aucun problème n'est détecté).
- Si le mode Number of problems and expand most critical one est choisi, les premières macros {HOST.*} affichées seront résolues en fonction de la gravité du déclencheur.
Host group Saisissez le groupe d'hôtes si le type d'élément est 'Host group'. Ce champ est en saisie semi-automatique, donc commencer à taper le nom d'un groupe affichera une liste déroulante des groupes correspondants. Faites défiler vers le bas pour sélectionner. Cliquez sur 'x' pour supprimer la sélection.
Tags Spécifiez des tags pour limiter le nombre de problèmes affichés dans le widget. Il est possible d'inclure ainsi que d'exclure des tags et des valeurs de tags spécifiques. Plusieurs conditions peuvent être définies. La correspondance du nom du tag est toujours sensible à la casse.
Plusieurs opérateurs sont disponibles pour chaque condition :
Exists - inclure les noms de tags spécifiés
Equals - inclure les noms et valeurs de tags spécifiés (sensible à la casse)
Contains - inclure les noms de tags spécifiés lorsque les valeurs de tags contiennent la chaîne saisie (correspondance de sous-chaîne, insensible à la casse)
Does not exist - exclure les noms de tags spécifiés
Does not equal - exclure les noms et valeurs de tags spécifiés (sensible à la casse)
Does not contain - exclure les noms de tags spécifiés lorsque les valeurs de tags contiennent la chaîne saisie (correspondance de sous-chaîne, insensible à la casse)
Il existe deux types de calcul pour les conditions :
And/Or - toutes les conditions doivent être remplies, les conditions ayant le même nom de tag seront regroupées par la condition Or
Or - il suffit qu'une condition soit remplie
Ce champ est disponible pour les types d'éléments host et host group.
Automatic icon selection Dans ce cas, un mappage d'icônes sera utilisé pour déterminer quelle icône afficher.
Icons Vous pouvez choisir d'afficher différentes icônes pour l'élément dans les cas suivants : défaut, problème, maintenance, désactivé.
Coordinate X Coordonnée X de l'élément de carte.
Coordinate Y Coordonnée Y de l'élément de carte.
URLs Des URL spécifiques à l'élément (jusqu'à 2048 caractères) peuvent être définies pour l'élément. Un libellé pour l'URL peut également être défini. Elles seront affichées sous forme de liens lorsqu'un utilisateur clique sur l'élément en mode affichage de la carte. Si l'élément possède ses propres URL et que des URL au niveau de la carte sont définies pour son type, elles seront combinées dans le même menu.
Les macros peuvent être utilisées dans les noms et valeurs des éléments de carte. Pour une liste complète, voir macros prises en charge et rechercher 'map URL names and values'.

Les éléments ajoutés ne sont pas enregistrés automatiquement. Si vous quittez la page, toutes les modifications peuvent être perdues.

Il est donc conseillé de cliquer sur le bouton Update dans le coin supérieur droit. Une fois cliqué, les modifications sont enregistrées quel que soit ce que vous choisissez dans la fenêtre contextuelle suivante.

Les options de grille sélectionnées sont également enregistrées avec chaque carte.

Sélection d'éléments

Pour sélectionner des éléments, sélectionnez-en un, puis maintenez la touche Ctrl enfoncée pour sélectionner les autres.

Vous pouvez également sélectionner plusieurs éléments en faisant glisser un rectangle dans la zone modifiable et en sélectionnant tous les éléments qu'il contient.

Une fois que vous avez sélectionné plusieurs éléments, le formulaire de propriété de l'élément passe en mode de mise à jour en masse afin que vous puissiez modifier les attributs des éléments sélectionnés en une seule fois. Pour ce faire, marquez l'attribut à l'aide de la case à cocher et entrez une nouvelle valeur pour celui-ci. Vous pouvez utiliser des macros (par exemple, {HOST.NAME} pour l'étiquette de l'élément).

Liaison des éléments

Une fois que vous avez placé des éléments sur la carte, il est temps de commencer à les lier. Pour lier deux éléments, vous devez d'abord les sélectionner. Une fois les éléments sélectionnés, cliquez sur Add à côté de Link.

Une fois un lien créé, le formulaire de l'élément unique contient désormais une section supplémentaire Links. Cliquez sur Edit pour modifier les attributs du lien.

Attributs du lien :

Parameter Description
Label Libellé qui sera affiché au-dessus du lien.
Les expressions macros sont prises en charge dans ce champ, mais uniquement avec les fonctions avg, last, min et max, avec le temps comme paramètre (par exemple, {?avg(/host/key,1h)}).
Connect to L'élément auquel le lien se connecte.
Type (OK) Style de lien par défaut :
Line - ligne simple
Bold line - ligne en gras
Dot - points
Dashed line - ligne en pointillés
Color (OK) Couleur par défaut du lien.
Link indicators Liste des déclencheurs liés au lien. Si un déclencheur a le statut PROBLEM, son style est appliqué au lien.

Déplacement et copier-coller d'éléments

Plusieurs éléments sélectionnés peuvent être déplacés vers un autre emplacement sur la carte en cliquant sur l’un des éléments sélectionnés, en maintenant le bouton de la souris enfoncé, puis en déplaçant le curseur vers l’emplacement souhaité.

Un ou plusieurs éléments peuvent être copiés en sélectionnant les éléments, puis en cliquant sur un élément sélectionné avec le bouton droit de la souris et en sélectionnant Copy dans le menu.

Pour coller les éléments, cliquez avec le bouton droit de la souris sur une zone de la carte et sélectionnez Paste dans le menu. L’option Paste without external links collera les éléments en conservant uniquement les liens entre les éléments sélectionnés.

Le copier-coller fonctionne dans la même fenêtre du navigateur. Les raccourcis clavier ne sont pas pris en charge.

Ajout de formes

En plus des éléments de carte, il est également possible d'ajouter certaines formes. Les formes ne sont pas des éléments de carte ; elles ne sont qu'une représentation visuelle. Par exemple, une forme rectangulaire peut être utilisée comme arrière-plan pour regrouper certains hôtes. Des formes rectangulaires et elliptiques peuvent être ajoutées.

Pour ajouter une forme, cliquez sur Ajouter à côté de Forme. La nouvelle forme apparaîtra dans le coin supérieur gauche de la carte. Faites-la glisser et déposez-la où vous le souhaitez.

Une nouvelle forme est ajoutée avec les couleurs par défaut. En cliquant sur la forme, un formulaire s'affiche et vous pouvez personnaliser l'apparence de la forme, ajouter du texte, etc.

Pour sélectionner des formes, sélectionnez-en une puis maintenez Ctrl enfoncé pour sélectionner les autres. Avec plusieurs formes sélectionnées, les propriétés communes peuvent être mises à jour en masse, de la même manière que pour les éléments.

Du texte peut être ajouté dans les formes. Les macros d'expression sont prises en charge dans le texte, mais uniquement avec les fonctions avg, last, min et max, avec le temps comme paramètre (par exemple, {?avg(/host/key,1h)}).

Pour afficher uniquement du texte, la forme peut être rendue invisible en supprimant la bordure de la forme (sélectionnez 'None' dans le champ Border). Par exemple, notez que la macro {MAP.NAME}, visible dans la capture d'écran ci-dessus, est en réalité une forme rectangulaire avec du texte, que l'on peut voir en cliquant sur la macro :

{MAP.NAME} est résolue en le nom de carte configuré lors de l'affichage de la carte.

Si des hyperliens sont utilisés dans le texte, ils deviennent cliquables lors de l'affichage de la carte.

Le retour à la ligne du texte est toujours activé dans les formes. Cependant, dans une ellipse, les lignes sont renvoyées à la ligne comme si l'ellipse était un rectangle. La césure des mots n'est pas implémentée, donc les mots longs (mots qui ne tiennent pas dans la forme) ne sont pas renvoyés à la ligne, mais sont masqués (sur la page d'édition de la carte) ou tronqués (autres pages avec des cartes).

Ajout de lignes

En plus des formes, il est également possible d'ajouter des lignes. Les lignes peuvent être utilisées pour relier des éléments ou des formes dans une carte.

Pour ajouter une ligne, cliquez sur Add à côté de Shape. Une nouvelle forme apparaîtra dans le coin supérieur gauche de la carte. Sélectionnez-la et cliquez sur Line dans le formulaire d'édition pour transformer la forme en ligne. Ajustez ensuite les propriétés de la ligne, telles que le type de ligne, la largeur, la couleur, etc.

map\_line.png

Ordre des formes et des lignes

Pour placer une forme devant une autre (ou inversement), cliquez sur la forme avec le bouton droit de la souris pour afficher le menu des formes de la carte.