Documentation
Table of Contents
1 Configuration d'une carte réseau
Aperçu
La configuration d'une carte dans Zabbix nécessite que vous créiez d'abord une carte en définissant ses paramètres généraux, puis que vous commenciez à remplir la carte réelle avec des éléments et leurs liens.
Vous pouvez remplir 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.
Les 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 définir que les problèmes récents sont affichés d'une manière particulière. Vous pouvez lier 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 à des propriétés d'hôte ou une icône de carte à une autre carte.
Les cartes sont gérées dans Surveillance → Cartes, où elles peuvent être configurées, gérées et visualisé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) depuis Zabbix 3.4.
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 rendues publiques ou privées.
- Les cartes publiques sont visibles par tous les utilisateurs, bien que pour les voir, l'utilisateur doit avoir un accès en lecture à au moins un élément de la carte. Les cartes publiques peuvent être modifiées dans le cas où un utilisateur/groupe d'utilisateurs a des autorisations de lecture-écriture pour cette carte et au moins des autorisations de lecture pour 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 réguliers (non super-administrateurs) ne peuvent partager qu'avec les groupes et les utilisateurs dont ils sont membres. Les utilisateurs de niveau administrateur peuvent voir des cartes privées, qu'ils soient propriétaires ou qu'ils appartiennent à la liste d'utilisateurs partagés. Les cartes privées peuvent être modifiées par le propriétaire de la carte et dans le cas où un utilisateur/groupe d'utilisateurs a des autorisations de lecture-écriture pour cette carte et au moins des autorisations de lecture pour 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 n'a pas l'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 est 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 avoir au moins une autorisation de lecture sur l'élément.
Créer une carte
Pour créer une carte, procédez comme suit :
- Accédez à Surveillance → Cartes
- Allez sur la vue avec toutes les cartes
- Cliquez sur Créer une carte
Vous pouvez également utiliser les boutons Cloner et Cloner complètement dans le formulaire de configuration d'une carte existante pour créer une nouvelle carte. Cliquer sur Cloner conservera les attributs de mise en page généraux de la carte d'origine, mais aucun élément. Cloner complètement conservera à la fois les attributs de mise en page généraux et tous les éléments de la carte d'origine.
L'onglet Carte 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 :
| Paramètre | Description |
|---|---|
| Propriétaire | Nom du propriétaire de la carte. |
| Nom | Nom de carte unique. |
| Largeur | Largeur de la carte en pixels. |
| Hauteur | Hauteur de la carte en pixels. |
| Image de fond | Utiliser l'image d'arrière-plan : Aucune image - aucune image d'arrière-plan (fond blanc) Image - image sélectionnée à utiliser comme image d'arrière-plan. Aucune mise à l'échelle n'est effectuée. Vous pouvez utiliser une carte géographique ou toute autre image pour améliorer votre carte. |
| Correspondance d'icône automatique | Vous pouvez définir l'utilisation d'un mappage automatique des icônes, configuré dans Administration → Général → Correspondances d'icônes. Le mappage d'icônes permet de mapper certaines icônes sur certains champs d'inventaire de l'hôte. |
| Icône surlignée | Si vous cochez cette case, les éléments de la carte seront mis en surbrillance. Les éléments avec un déclencheur actif recevront un arrière-plan 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 reconnus. Les éléments avec le statut "désactivé" ou "en maintenance" auront un fond carré, respectivement gris et orange. Voir aussi : Affichage des cartes |
| Marquer les éléments lors du changement d'état du déclencheur | Un changement récent de l'état du déclencheur (problème récent ou résolution) sera mis en évidence avec 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. |
| Afficher les problèmes | Sélectionnez le mode d'affichage des problèmes avec un élément cartographique : Détailler problème unique - s'il n'y a qu'un seul problème, le nom du problème s'affiche. Sinon, le nombre total de problèmes est affiché. Nombre de problèmes - le nombre total de problèmes est affiché Nombre de problèmes et détailler le plus critique - le nom du plus critique problème et le nombre total de problèmes s'affiche. 'Le plus critique' est déterminé en fonction de la gravité du problème et, s'il est égal, de l'ID de l'événement du problème (ID supérieur ou problème ultérieur affiché en premier). Pour un élément de carte de déclenchement, il est basé sur la gravité du problème et, s'il est égal, sur la position du déclencheur dans la liste des déclencheurs. En cas de problèmes multiples du même déclencheur, le plus récent sera affiché. |
| Étiquettes avancées | Si vous cochez cette case, vous pourrez définir des types d'étiquettes distincts pour des types d'éléments distincts. |
| Type d'étiquette d'élément de carte | Type d'étiquette utilisé pour les éléments de carte : Étiquette - étiquette d'élément de carte Adresse IP - Adresse IP Nom de l'élément - nom de l'élément (par exemple, nom d'hôte) État uniquement - statut uniquement (OK ou PROBLÈME) Rien - aucune étiquette n'est affichée |
| Emplacement de l'étiquette de l'élément de carte | Emplacement de l'étiquette par rapport à l'élément de carte : Bas - sous l'élément de carte Gauche - à gauche Droite - à droite Haut - au-dessus de l'élément cartographique |
| Affichage des problèmes | Afficher le nombre de problèmes comme : Tous - le nombre total de problèmes sera affiché Séparé - le nombre de problèmes non reconnus sera affiché séparé comme un nombre du nombre total de problèmes Non acquittés uniquement - seul le nombre de problèmes non acquittés sera affiché |
| Sévérité minimale | Les problèmes en dessous du niveau de sévérité minimum sélectionné ne seront pas affichés sur la carte. Par exemple, avec Avertissement sélectionné, les changements avec les déclencheurs de niveau Information et Non classifié ne seront pas reflétés dans la carte. Ce paramètre est pris en charge à partir de Zabbix 2.2. |
| Afficher les problèmes supprimés | 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 pour chaque type d'élément peuvent être définies (avec une étiquette). Ceux-ci seront affichés sous forme de liens lorsqu'un utilisateur clique sur l'élément en mode d'affichage de carte. Des macros peuvent être utilisées dans les noms et les valeurs d'URL de carte. Pour une liste complète, consultez des macros prises en charge et recherchez "mapper les noms et les valeurs d'URL". |
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é - la carte n'est visible que pour les groupes d'utilisateurs et les utilisateurs sélectionnés Public - la carte est visible pour tous |
| Liste des partages de groupes d'utilisateurs | Sélectionnez les groupes d'utilisateurs auxquels la carte est accessible. Vous pouvez autoriser l'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 l'accès en lecture seule ou en lecture-écriture. |
Lorsque vous cliquez sur Ajouter pour enregistrer cette carte, vous avez créé une carte vide avec un nom, des dimensions et certaines préférences. Maintenant, vous devez ajouter quelques éléments. Pour cela, cliquez sur Constructeur dans la liste des cartes pour ouvrir la zone modifiable.
Ajouter des éléments
Pour ajouter un élément, cliquez sur Ajouter à côté de Élément de carte. Le nouvel élément apparaîtra dans le coin supérieur gauche de la carte. Faites-le glisser et déposez-le où vous le souhaitez.
Notez qu'avec l'option Grille "Activé", 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 des éléments n'importe où sans alignement, activez l'option "Désactivé". (Les éléments aléatoires peuvent ensuite être à nouveau alignés sur la grille avec le bouton Aligner les éléments de carte.)
Maintenant que vous avez des éléments en place, vous voudrez 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, donner un nom, choisir une autre icône, etc. .
Attributs des éléments de carte :
| Paramètre | Description |
|---|---|
| Type | Type de l'élément : Hôte - icône représentant l'état de tous les déclencheurs de l'hôte sélectionné Carte - icône représentant l'état de tous les éléments d'une carte Déclencheur - icône représentant l'état d'un ou plusieurs déclencheurs Groupe d'hôtes - 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 |
| Étiquette | Étiquette de l'icône, n'importe quelle chaîne. Les macros et les chaînes multilignes peuvent être utilisées. Les expressions de macros sont prises en charge dans ce champ, mais uniquement avec avg, last, min et max, avec l'heure comme paramètre (par exemple, {?avg(/host/key,1h)}).Pour une liste complète des macros prises en charge, voir les macros prises en charge et recherchez 'étiquettes d'élément de carte'. |
| Positionnement de l'étiquette | Emplacement de l'étiquette par rapport à l'icône : Défaut - emplacement de l'étiquette par défaut de la carte Bas - sous l'icône Gauche - vers le gauche Droite - vers la droite Haut - au-dessus de l'icône |
| Hôte | Entrez l'hôte si le type d'élément est 'Hôte'. Ce champ est auto-complété, donc commencer à taper le nom d'un hôte offrira 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. |
| Carte | Sélectionnez la carte, si le type d'élément est 'Carte'. |
| Déclencheurs | Si le type d'élément est 'Déclencheur', sélectionnez un ou plusieurs déclencheurs dans le champ Nouveaux déclencheurs ci-dessous et cliquez sur Ajouter. L'ordre des déclencheurs sélectionnés peut être modifié, mais uniquement dans le même gravité des déclencheurs. La sélection de plusieurs déclencheurs affecte également la résolution de la macro {HOST.*} à la fois en mode construction et en mode affichage. // 1 En mode construction // les premières macros {HOST.*} affichées seront résolues en fonction du premier déclencheur dans la liste (en fonction de la gravité du déclencheur). // 2 Mode d'affichage// dépend du paramètre Afficher les problèmes dans les attributs généraux de la carte. * Si le mode Détailler un problème unique 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 sévérité) ou du premier déclencheur de la liste (si aucun problème n'est détecté ); * Si le mode Nombre de problèmes et détailler le plus critique est choisi, les premières macros {HOST.*} affichées seront résolues en fonction de la sévérité du déclencheur. |
| Groupe d'hôtes | Entrez le groupe d'hôtes si le type d'élément est 'Groupe d'hôtes'. Ce champ est auto-complété, donc commencer à taper le nom d'un groupe offrira 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 et 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 : Existe - inclut les noms de tag spécifiés Égal - inclut les noms de tag spécifiés et valeurs (sensible à la casse) Contient - inclut les noms de tag spécifiés où les valeurs de tag contiennent la chaîne saisie (correspondance de sous-chaîne, insensible à la casse) N'existe pas - exclut les valeurs spécifiées noms de tag N'est pas égal - exclut les noms et valeurs de tag spécifiés (sensible à la casse) Ne contient pas - exclut les noms de tag spécifiés où 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 : Et/Ou - toutes les conditions doivent être remplies, les conditions ayant le même nom de tag seront regroupées par la condition Ou<br >Ou - suffisant si une condition est remplie Ce champ est disponible pour les types d'élément d'hôte et de groupe d'hôtes. |
| Sélection automatique d'icônes | Dans ce cas, un mappage d'icônes sera utilisé pour déterminer quelle icône afficher. |
| Icônes | Vous pouvez choisir d'afficher différentes icônes pour l'élément dans ces cas : par défaut, problème, maintenance, désactivé. |
| Coordonnée X | Coordonnée X de l'élément de carte. |
| Coordonnée Y | Coordonnée Y de l'élément de carte. |
| URLs | Des URL spécifiques à l'élément peuvent être définies pour l'élément. Ceux-ci seront affichés sous forme de liens lorsqu'un utilisateur cliquera sur l'élément en mode d'affichage de la carte. Si l'élément a ses propres URL et qu'il existe des URL au niveau de la carte pour son type défini, 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 la carte. Pour une liste complète, consultez les macros prises en charge et recherchez "noms et valeurs d'URL de carte". |
Les éléments ajoutés ne sont pas automatiquement enregistrés. Si vous quittez la page, toutes les modifications peuvent être perdues.
C'est donc une bonne idée de cliquer sur le bouton Actualiser dans le coin supérieur droit. Une fois cliquées, les modifications sont enregistrées indépendamment de 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).
Lier des éléments
Une fois que vous avez mis certains éléments sur la carte, il est temps de commencer à les relier. Pour lier 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.
Avec un lien créé, le formulaire à élément unique contient désormais une section Liens supplémentaire. Cliquez sur Modifier pour modifier les attributs du lien.
Attributs du lien :
| Paramètre | Description |
|---|---|
| Étiquette | Étiquette qui sera rendue 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)}). |
| Se connecte à | L'élément auquel le lien se connecte. |
| Type (OK) | Style de lien par défaut : Ligne - une seule ligne Ligne en gras - ligne en gras Point - points ** Ligne pointillée** - ligne pointillée |
| Couleur (OK) | Couleur du lien par défaut. |
| Indicateurs de lien | Liste des déclencheurs liés au lien. Dans le cas où un déclencheur a le statut PROBLÈME, son style 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.
Ajouter de formes
En plus des éléments cartographiques, il est également possible d'ajouter des formes. Les formes ne sont pas des éléments cartographiques ; ils 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 de rectangle et d'ellipse 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-le glisser et déposez-le 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 d'une forme, 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. Avec plusieurs formes sélectionnées, les propriétés communes peuvent être mises à jour en masse, comme pour les éléments.
Du texte peut être ajouté dans les formes. Les expressions demacros 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(/hôte/clé,1h)}).
Pour afficher uniquement du texte, la forme peut être rendue invisible en supprimant la bordure de la forme (sélectionnez 'Aucune' dans le champ Bordure). Par exemple, notez que la macro {MAP.NAME}, visible dans la capture d'écran ci-dessus, est en fait une forme de rectangle avec du texte, qui peut être vu en cliquant sur la macro :
{MAP.NAME} se résout au nom de la carte configurée lors de l'affichage de la carte.
Si des hyperliens sont utilisés dans le texte, ils deviennent cliquables lors de la visualisation de la carte.
Le retour à la ligne pour le texte est toujours "activé" dans les formes. Cependant, dans une ellipse, les lignes sont enveloppées comme si l'ellipse était un rectangle. L'habillage de mots n'est pas implémenté, donc les mots longs (mots qui ne correspondent pas à la forme) ne sont pas enveloppés, mais masqués (page constructeur) ou tronqués (autres pages avec des cartes).
Ajouter des lignes
En plus des formes, il est également possible d'ajouter quelques lignes. Les lignes peuvent être utilisées pour relier des éléments ou des formes dans une carte.
Pour ajouter une ligne, cliquez sur Ajouter à côté de Forme. Une nouvelle forme apparaîtra dans le coin supérieur gauche de la carte. Sélectionnez-le et cliquez sur Ligne dans le formulaire d'édition pour changer la forme en ligne. Ajustez ensuite les propriétés de la ligne, telles que le type de ligne, la largeur, la couleur, etc.
Ordonner des formes et des lignes
Pour amener une forme devant l'autre (ou vice versa), cliquez sur la forme avec le bouton droit de la souris pour faire apparaître le menu des formes de la carte.
