[comment]: # ({825145a8-825145a8})
# 1 Configuration d'une carte réseau
[comment]: # ({/825145a8-825145a8})
[comment]: # ({11de3571-b1737d97})
#### 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](/manual/web_interface/frontend_sections/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).
[comment]: # ({/11de3571-b1737d97})
[comment]: # ({d3a50f08-8ca16024})
#### 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.
```{=html}
```
- 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](/manual/config/visualization/maps/map#sharing)
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.
[comment]: # ({/d3a50f08-8ca16024})
[comment]: # ({90d72d7d-2202cec4})
#### 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](/manual/web_interface/frontend_sections/monitoring/maps#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](/manual/appendix/macros/supported_by_location) et recherchez 'map URL names and values'.|
[comment]: # ({/90d72d7d-2202cec4})
[comment]: # ({d27196d6-01e19658})
#### 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.
[comment]: # ({/d27196d6-01e19658})
[comment]: # ({ff769e3e-3ed51336})
#### 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.
{width="600"}
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](/manual/config/visualization/maps/host_groups)** - 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](/manual/appendix/macros/supported_by_location) 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](/manual/appendix/macros/supported_by_location) 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](/manual/config/visualization/maps/map#creating-a-map) 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](/manual/appendix/macros/supported_by_location) et rechercher 'map URL names and values'.|
::: noteimportant
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.
:::
[comment]: # ({/ff769e3e-3ed51336})
[comment]: # ({e720d30b-e720d30b})
#### 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).
{width="600"}
[comment]: # ({/e720d30b-e720d30b})
[comment]: # ({55e2211e-d9136de4})
#### 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.
{width="600"}
Attributs du lien :
|Parameter|Description|
|--|--------|
|*Label*|Libellé qui sera affiché au-dessus du lien.
Les expressions [macros](/manual/appendix/macros/supported_by_location) 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](links)*|Liste des déclencheurs liés au lien. Si un déclencheur a le statut PROBLEM, son style est appliqué au lien.|
[comment]: # ({/55e2211e-d9136de4})
[comment]: # ({726a54c2-726a54c2})
#### 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.
{width="600"}
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.
[comment]: # ({/726a54c2-726a54c2})
[comment]: # ({31a59fea-26543c2f})
#### 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.
{width="600"}
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](/manual/appendix/macros/supported_by_location) 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).
[comment]: # ({/31a59fea-26543c2f})
[comment]: # ({ef42602b-ef42602b})
#### 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.
{width="600"}
[comment]: # ({/ef42602b-ef42602b})
[comment]: # ({5750972e-1b4ca573})
#### 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.
[comment]: # ({/5750972e-1b4ca573})