1 Configuration d'une carte réseau

Aperçu

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 remplir la carte avec des éléments tels qu’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 indiquer que les problèmes récents doivent être affichés 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 lier 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 causes.

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 supervision, vous pouvez cliquer sur les icônes et tirer parti 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 :

  1. Accédez à Monitoring > Maps.
  2. Accédez à la vue contenant toutes les cartes.
  3. 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 de saisie 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 - l'image sélectionnée sera utilisée comme image d'arrière-plan. Vous pouvez utiliser une carte géographique ou toute autre image pour améliorer votre carte.
Background scale Utiliser la mise à l'échelle de l'arrière-plan :
None - aucune mise à l'échelle ;
Proportionally - couvre tout l'arrière-plan de la carte, tout en conservant les proportions de l'image (par défaut).
Automatic icon mapping Vous pouvez définir l'utilisation d'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 des hôtes.
Icon highlight Si vous cochez cette case, les éléments de la carte seront mis en surbrillance.
Les éléments avec un trigger actif recevront un arrière-plan rond, de la même couleur que le trigger 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 ayant le statut « disabled » ou « in maintenance » auront respectivement un arrière-plan carré gris et orange.
Voir aussi : Viewing maps
Mark elements on trigger status change Une modification récente de l'état du trigger (problème récent ou résolution) sera mise 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 comment 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, en cas d'égalité, de l'ID d'é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, en cas d'égalité, sur la position du trigger dans la liste des triggers. En cas de plusieurs problèmes pour le même trigger, 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.
Host group label type Type d'étiquette utilisé pour l'élément de carte :
Label - étiquette de l'élément de carte
IP address - adresse IP
Element name - nom de l'élément (par exemple, nom de l'hôte)
Status only - statut uniquement (OK ou PROBLEM)
Nothing - aucune étiquette n'est affichée
Host label type
Trigger label type
Map label type
Image label type
Map element label location Emplacement de l'étiquette par rapport à l'élément de carte :
Bottom - sous l'élément de carte
Left - à gauche
Right - à droite
Top - au-dessus de l'élément de carte
Show map element labels Sélectionnez comment afficher les étiquettes des éléments de carte :
Always - toujours affichées (par défaut) ;
Auto hide - masquer l'étiquette si elle n'est pas survolée ou sélectionnée.
Show link labels Sélectionnez comment afficher les étiquettes des liens :
Always - toujours affichées (par défaut) ;
Auto hide - masquer l'étiquette si elle n'est pas survolée ou sélectionnée.
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 du nombre total de problèmes
Unacknowledged only - seul le nombre de problèmes non acquittés sera affiché
Minimum severity Les problèmes inférieurs au niveau de gravité minimale sélectionné ne seront pas affichés sur la carte.
Par exemple, si Warning est sélectionné, les changements avec des triggers de niveau Information et Not classified ne seront pas reflétés sur la carte.
Show suppressed problems Cochez cette 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 pour chaque type d'élément peuvent être définies ici, où :
Name - une étiquette pour l'URL ;
URL - une URL (jusqu'à 2048 caractères) ;
Element - le type d'élément (par ex., Host, Host group, etc.).
Celles-ci seront affichées sous forme de liens lorsqu'un utilisateur clique sur l'élément en mode d'affichage de la carte.
Des macros peuvent être utilisées dans les noms et les valeurs des URL de carte. Pour une liste complète, consultez supported macros et recherchez « map URL names and values ».

Partage

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

Paramètre Description
Type Sélectionnez le type de carte :
Privée - la carte est visible uniquement par les groupes d’utilisateurs et les utilisateurs sélectionnés
Publique - la carte est visible par tous
Liste des partages de groupes d’utilisateurs Sélectionnez les groupes d’utilisateurs auxquels la carte est accessible.
Vous pouvez autoriser un accès en lecture seule ou en lecture-écriture.
Liste des partages d’utilisateurs 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 Ajouter pour enregistrer cette carte, vous créez une carte vide avec un nom, des dimensions et certaines préférences. Vous devez maintenant ajouter des éléments. Pour cela, cliquez sur Modifier dans la liste des cartes pour ouvrir la zone modifiable.

Ajout d'éléments

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

Notez qu'avec l'option Grille définie sur "On", les éléments s'aligneront toujours sur la grille (vous pouvez choisir différentes tailles de grille dans la liste déroulante, ainsi que masquer/afficher la grille). Si vous souhaitez placer les éléments n'importe où sans alignement, définissez l'option sur "Off". (Vous pourrez aligner ultérieurement 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 autre icône, 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
Label Libellé de l'icône, chaîne quelconque.
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, consultez supported macros et recherchez « 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.
Show label Sélectionnez comment afficher le libellé de l'élément :
Default - utiliser les paramètres Show map element labels de la configuration de la carte (par défaut) ;
Always - toujours affiché (par défaut) ;
Auto hide - masquer le libellé s'il n'est pas survolé ou sélectionné.
Host Sélectionnez un hôte ; vous pouvez également saisir le nom de l'hôte. Ce champ prend en charge l'auto-complétion ; ainsi, lorsque vous commencez à saisir le nom d'un hôte, une liste déroulante des hôtes correspondants s'affiche. Faites défiler vers le bas pour en sélectionner un. Cliquez sur l'icône de suppression (x) pour supprimer la sélection.
Ce champ n'est disponible que pour les éléments de type Host.
Map Sélectionnez une carte ; vous pouvez également saisir le nom de la carte. Ce champ prend en charge l'auto-complétion ; ainsi, lorsque vous commencez à saisir le nom d'une carte, une liste déroulante des cartes correspondantes s'affiche. Faites défiler vers le bas pour en sélectionner une. Cliquez sur l'icône de suppression (x) pour supprimer la sélection.
Ce champ n'est disponible que pour les éléments de type Map.
Triggers Sélectionnez un ou plusieurs déclencheurs dans le champ New triggers ci-dessous et cliquez sur Add. Vous pouvez également commencer à saisir le nom d'un déclencheur et en sélectionner un dans la liste déroulante des déclencheurs correspondants. Cliquez sur l'icône de suppression (x) pour supprimer la sélection.
Ce champ n'est disponible que pour les éléments de type Trigger.
L'ordre des déclencheurs sélectionnés peut être modifié, mais uniquement au sein du même niveau de sévérité des déclencheurs. La sélection de plusieurs déclencheurs affecte également la résolution de la macro {HOST.*} en mode édition comme 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 (sur la base de la sévérité 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é (sans tenir compte de la sévérité) 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 sévérité du déclencheur.
Host group Sélectionnez un groupe d'hôtes ; vous pouvez également saisir le groupe d'hôtes. Ce champ prend en charge l'auto-complétion ; ainsi, lorsque vous commencez à saisir le nom d'un groupe d'hôtes, une liste déroulante des groupes d'hôtes correspondants s'affiche. Faites défiler vers le bas pour en sélectionner un. Cliquez sur l'icône de suppression (x) pour supprimer la sélection.
Ce champ n'est disponible que pour les éléments de type Host group.
Problem tags Spécifiez des tags pour limiter le nombre de problèmes affichés dans le widget. Il est possible d'inclure comme d'exclure des tags et des valeurs de tag spécifiques. Plusieurs conditions peuvent être définies. La correspondance des noms de tag est toujours sensible à la casse.
Plusieurs opérateurs sont disponibles pour chaque condition :
Exists - inclure les noms de tag spécifiés
Equals - inclure les noms et valeurs de tag spécifiés (sensible à la casse)
Contains - inclure les noms de tag spécifiés lorsque les valeurs de tag contiennent la chaîne saisie (correspondance de sous-chaîne, insensible à la casse)
Does not exist - exclure les noms de tag spécifiés
Does not equal - exclure les noms et valeurs de tag spécifiés (sensible à la casse)
Does not contain - exclure les noms de tag spécifiés lorsque les valeurs de tag 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 seule condition soit remplie
Ce champ n'est disponible que pour les éléments de type Host et Host group.
Automatic icon selection Lorsque la case est cochée, le mapping 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 : Default, Problem, Maintenance et Disabled.
Ce champ n'est disponible que pour les éléments de type Host.
Coordinates Coordonnées X et Y de l'élément de carte.
URLs Des URL spécifiques à l'élément peuvent être définies ici pour l'élément, où :
Name - un libellé pour l'URL ;
URL - une URL (jusqu'à 2048 caractères).
Elles seront affichées sous forme de liens lorsqu'un utilisateur clique sur l'élément en mode d'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.
Des macros peuvent être utilisées dans les noms et les valeurs des éléments de carte. Pour une liste complète, consultez supported macros et recherchez « map URL names and values ».

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

Il est donc recommandé de cliquer sur le bouton Update dans le coin supérieur droit. Une fois cliqué, les modifications sont enregistrées quel que soit votre choix 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 relier. Pour relier deux éléments, vous devez d’abord les sélectionner. Une fois les éléments sélectionnés, cliquez sur Ajouter à côté de Lien.

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

Attributs du lien :

Paramètre Description
Libellé Libellé qui sera affiché au-dessus du lien.
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)}).
Afficher le libellé Sélectionnez comment afficher le libellé du lien :
Par défaut - utiliser les paramètres Afficher les libellés des éléments de la carte de la configuration de la carte (par défaut) ;
Toujours - toujours affiché (par défaut) ;
Masquage automatique - masquer le libellé s’il n’est ni survolé ni sélectionné.
Connecter à L’élément auquel le lien se connecte.
Type (OK) Style de lien par défaut. Sélectionnez le style : Ligne, Ligne épaisse, Point, ou Ligne en pointillés.
Couleur (OK) Couleur de lien par défaut. Cliquez sur l’échantillon de couleur pour sélectionner une autre couleur.
Type d’indicateur Sélectionnez le type d’indicateur du lien :
Lien statique - aucun indicateur ;
Déclencheur - autoriser les indicateurs de lien basés sur des déclencheurs ;
Valeur d’élément - autoriser les indicateurs de lien basés sur des valeurs d’élément.
Élément Sélectionnez l’élément. La valeur de cet élément affectera le style du lien.
Ce champ est disponible lorsque Valeur d’élément est sélectionné pour Type d’indicateur.
Indicateurs La liste des indicateurs de lien.
Ce champ est disponible lorsque Type d’indicateur est défini sur Déclencheur ou Valeur d’élément.
S’il est défini sur Déclencheur, des déclencheurs peuvent être attribués comme indicateurs de lien. Lorsqu’un déclencheur est à l’état Problème, son style (couleur et type de ligne sélectionnés) sera appliqué au lien.
S’il est défini sur Valeur d’élément et qu’un élément est sélectionné dans le champ Élément, des valeurs d’élément peuvent être attribuées comme indicateurs de lien. Lorsque la valeur de l’élément atteint le seuil spécifié (pour un élément numérique) ou correspond au motif (pour un élément texte), son style (couleur et type de ligne sélectionnés) est appliqué au lien.

Déplacer et copier-coller des éléments

Plusieurs éléments sélectionnés peuvent être déplacés vers un autre endroit de la carte en cliquant sur l'un des éléments sélectionnés, en maintenant le bouton de la souris enfoncé et en déplaçant le curseur à 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 Copier dans le menu.

Pour coller les éléments, cliquez sur une zone de la carte avec le bouton droit de la souris et sélectionnez Coller dans le menu. L'option Coller sans liens externes collera les éléments en ne conservant que les liens qui se trouvent entre les éléments sélectionnés.

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

Ordonnancement des éléments

Pour placer un élément devant un autre (ou inversement), cliquez sur l’élément avec le bouton droit de la souris et sélectionnez Avancer/Mettre au premier plan ou Reculer/Mettre à l’arrière-plan.

Ajout de formes

En plus des éléments de carte, il est également possible d’ajouter des formes. Les formes ne sont pas des éléments de carte ; elles constituent simplement 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 Shape. La nouvelle forme apparaîtra dans le coin supérieur gauche de la carte. Faites-la glisser-déposer où vous le souhaitez.

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

Pour sélectionner des formes, sélectionnez-en une, puis maintenez la touche Ctrl enfoncée pour sélectionner les autres. Lorsque plusieurs formes sont sélectionnées, les propriétés communes peuvent être mises à jour en masse, de la même manière qu’avec 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 le 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, ce qui peut être constaté en cliquant sur la macro :

{MAP.NAME} est remplacée par 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. Le retour à la ligne par mot n’est pas implémenté ; ainsi, les mots longs (les mots qui ne tiennent pas dans la forme) ne sont pas renvoyés à la ligne, mais masqués (sur la page de modification de la carte) ou tronqués (autres pages contenant 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 sur 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

Ordonner les formes et les 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.