[comment]: # ({825145a8-825145a8})
# 1 Configurazione di una mappa di rete
[comment]: # ({/825145a8-825145a8})
[comment]: # ({11de3571-b1737d97})
#### Panoramica
La configurazione di una mappa in Zabbix richiede innanzitutto la creazione di una mappa, definendone i parametri generali; successivamente si inizia a compilare la mappa vera e propria con gli elementi e i relativi collegamenti.
È possibile popolare la mappa con elementi che siano un host, un gruppo di host, un trigger, un'immagine oppure un'altra mappa.
Le icone vengono utilizzate per rappresentare gli elementi della mappa. È possibile definire le informazioni che verranno visualizzate con le icone e impostare che i problemi recenti vengano mostrati in modo speciale. È inoltre possibile collegare le icone e definire le informazioni da visualizzare sui collegamenti.
È possibile aggiungere URL personalizzati, accessibili facendo clic sulle icone. In questo modo, ad esempio, si può collegare l'icona di un host alle proprietà dell'host oppure l'icona di una mappa a un'altra mappa.
Il conteggio dei problemi nelle mappe viene visualizzato solo per i problemi causa.
Le mappe sono gestite in *Monitoring* >
*[Maps](/manual/web_interface/frontend_sections/monitoring/maps)*, dove possono essere configurate, gestite e visualizzate. Nella vista di monitoraggio, è possibile fare clic sulle icone e sfruttare i collegamenti ad alcuni script e URL.
Le mappe di rete si basano sulla grafica vettoriale (SVG).
[comment]: # ({/11de3571-b1737d97})
[comment]: # ({d3a50f08-8ca16024})
#### Mappe pubbliche e private
Tutti gli utenti in Zabbix (inclusi gli utenti non amministratori) possono creare mappe di rete.
Le mappe hanno un proprietario: l'utente che le ha create. Le mappe possono essere pubbliche
o private.
- Le mappe *pubbliche* sono visibili a tutti gli utenti, anche se, per visualizzarle, l'utente
deve avere accesso in lettura ad almeno un elemento della mappa. Le mappe pubbliche possono
essere modificate nel caso in cui un utente/gruppo di utenti disponga di permessi di lettura-scrittura per
questa mappa e di almeno permessi di lettura per tutti gli elementi della
mappa corrispondente, inclusi i trigger nei collegamenti.
```{=html}
```
- Le mappe *private* sono visibili solo al loro proprietario e agli utenti/gruppi di utenti con
cui la mappa è [condivisa](/manual/config/visualization/maps/map#sharing)
dal proprietario. Gli utenti normali (non Super admin) possono condividere solo
con i gruppi a cui appartengono e con gli utenti che appartengono a tali gruppi. Gli utenti di livello Admin possono
vedere le mappe private indipendentemente dal fatto di esserne i proprietari o di appartenere all'elenco
degli utenti con cui sono condivise. Le mappe private possono essere modificate dal proprietario della mappa
e nel caso in cui un utente/gruppo di utenti disponga di permessi di lettura-scrittura per
questa mappa e di almeno permessi di lettura per tutti gli elementi della
mappa corrispondente, inclusi i trigger nei collegamenti.
Gli elementi della mappa per i quali l'utente non dispone di permessi di lettura vengono
visualizzati con un'icona in grigio e tutte le informazioni testuali sull'elemento sono nascoste. Tuttavia, l'etichetta del
trigger è visibile anche se l'utente non dispone di permessi per il trigger.
Per aggiungere un elemento alla mappa, l'utente deve avere almeno i permessi di lettura per l'elemento.
[comment]: # ({/d3a50f08-8ca16024})
[comment]: # ({90d72d7d-2202cec4})
#### Creazione di una mappa
Per creare una mappa, procedere come segue:
- Andare in *Monitoring > Maps*
- Andare alla vista con tutte le mappe
- Fare clic su *Create map*
È inoltre possibile usare il pulsante *Clone* nel modulo di configurazione di una mappa esistente per crearne una nuova.
Questa mappa avrà tutte le proprietà della mappa esistente, inclusi gli attributi generali del layout, nonché gli elementi della mappa esistente.
La scheda **Map** contiene gli attributi generali della mappa:
Tutti i campi obbligatori sono contrassegnati da un asterisco rosso.
Attributi generali della mappa:
|Parameter|Description|
|--|--------|
|*Owner*|Nome del proprietario della mappa.|
|*Name*|Nome univoco della mappa.|
|*Width*|Larghezza della mappa in pixel.|
|*Height*|Altezza della mappa in pixel.|
|*Background image*|Usa immagine di sfondo:
**No image** - nessuna immagine di sfondo (sfondo bianco)
**Image** - immagine selezionata da usare come immagine di sfondo. Non viene eseguito alcun ridimensionamento. È possibile usare una mappa geografica o qualsiasi altra immagine per migliorare la mappa.|
|*Automatic icon mapping*|È possibile impostare l'uso di una mappatura automatica delle icone, configurata in *Administration → General → Icon mapping*. La mappatura delle icone consente di associare determinate icone a specifici campi dell'inventario dell'host.|
|*Icon highlight*|Se si seleziona questa casella, gli elementi della mappa verranno evidenziati.
Gli elementi con un trigger attivo riceveranno uno sfondo circolare, dello stesso colore del trigger con la severità più alta. Inoltre, verrà visualizzata una linea verde spessa attorno al cerchio se tutti i problemi sono stati riconosciuti.
Gli elementi con stato "disabled" o "in maintenance" avranno uno sfondo quadrato, rispettivamente grigio e arancione.
Vedere anche: [Viewing maps](/manual/web_interface/frontend_sections/monitoring/maps#viewing-maps)|
|*Mark elements on trigger status change*|Una modifica recente dello stato del trigger (problema recente o risoluzione) verrà evidenziata con marcatori (triangoli rossi rivolti verso l'interno) sui tre lati dell'icona dell'elemento che sono liberi dall'etichetta. I marcatori vengono visualizzati per 30 minuti.|
|*Display problems*|Selezionare come i problemi vengono visualizzati con un elemento della mappa:
**Expand single problem** - se c'è un solo problema, viene visualizzato il nome del problema. Altrimenti, viene visualizzato il numero totale di problemi.
**Number of problems** - viene visualizzato il numero totale di problemi
**Number of problems and expand most critical one** - vengono visualizzati il nome del problema più critico e il numero totale di problemi.
'Most critical' viene determinato in base alla severità del problema e, se uguale, all'ID dell'evento del problema (viene visualizzato per primo l'ID più alto o il problema più recente). Per un *trigger map element* si basa sulla severità del problema e, se uguale, sulla posizione del trigger nell'elenco dei trigger. In caso di più problemi dello stesso trigger, verrà visualizzato il più recente.|
|*Advanced labels*|Se si seleziona questa casella, sarà possibile definire tipi di etichetta separati per tipi di elemento separati.|
|*Map element label type*|Tipo di etichetta usato per gli elementi della mappa:
**Label** - etichetta dell'elemento della mappa
**IP address** - indirizzo IP
**Element name** - nome dell'elemento (ad esempio, nome dell'host)
**Status only** - solo stato (OK o PROBLEM)
**Nothing** - non vengono visualizzate etichette|
|*Map element label location*|Posizione dell'etichetta rispetto all'elemento della mappa:
**Bottom** - sotto l'elemento della mappa
**Left** - a sinistra
**Right** - a destra
**Top** - sopra l'elemento della mappa|
|*Problem display*|Visualizza il conteggio dei problemi come:
**All** - verrà visualizzato il conteggio completo dei problemi
**Separated** - verrà visualizzato il conteggio dei problemi non riconosciuti separato come numero del conteggio totale dei problemi
**Unacknowledged only** - verrà visualizzato solo il conteggio dei problemi non riconosciuti|
|*Minimum trigger severity*|I problemi al di sotto del livello minimo di severità selezionato non verranno visualizzati sulla mappa.
Ad esempio, con *Warning* selezionato, le modifiche con trigger di livello *Information* e *Not classified* non verranno riflesse nella mappa.|
|*Show suppressed problems*|Selezionare la casella per visualizzare i problemi che altrimenti verrebbero soppressi (non mostrati) a causa della manutenzione dell'host.|
|*URLs*|È possibile definire URL (fino a 2048 caratteri) per ciascun tipo di elemento. È anche possibile definire un'etichetta per l'URL. Questi verranno visualizzati come collegamenti quando un utente fa clic sull'elemento nella modalità di visualizzazione della mappa.
Le macro possono essere usate nei nomi e nei valori degli URL della mappa. Per l'elenco completo, vedere [supported macros](/manual/appendix/macros/supported_by_location) e cercare 'map URL names and values'.|
[comment]: # ({/90d72d7d-2202cec4})
[comment]: # ({d27196d6-01e19658})
#### Condivisione
La scheda **Condivisione** contiene il tipo di mappa e le opzioni di condivisione
(gruppi di utenti, utenti) per le mappe private:
|Parameter|Description|
|--|--------|
|*Type*|Seleziona il tipo di mappa:
**Private** - la mappa è visibile solo ai gruppi di utenti e agli utenti selezionati
**Public** - la mappa è visibile a tutti|
|*List of user group shares*|Seleziona i gruppi di utenti a cui la mappa è accessibile.
Puoi consentire l'accesso in sola lettura o in lettura e scrittura.|
|*List of user shares*|Seleziona gli utenti a cui la mappa è accessibile.
Puoi consentire l'accesso in sola lettura o in lettura e scrittura.|
Quando fai clic su *Add* per salvare questa mappa, hai creato una mappa vuota
con un nome, dimensioni e alcune preferenze. Ora devi aggiungere
alcuni elementi. Per farlo, fai clic su *Edit* nell'elenco delle mappe per aprire
l'area modificabile.
[comment]: # ({/d27196d6-01e19658})
[comment]: # ({ff769e3e-3ed51336})
#### Aggiunta di elementi
Per aggiungere un elemento, fai clic su *Add* accanto a `Map element`. Il nuovo elemento apparirà nell'angolo in alto a sinistra della mappa. Trascinalo e rilascialo dove preferisci.
Nota che con l'opzione Grid impostata su "On", gli elementi si allineeranno sempre alla griglia (puoi scegliere varie dimensioni della griglia dal menu a discesa e anche nascondere/mostrare la griglia). Se vuoi posizionare gli elementi ovunque senza allineamento, imposta l'opzione su "Off". (In seguito puoi allineare gli elementi casuali alla griglia facendo clic su *Align map elements*.)
Ora che hai inserito alcuni elementi, potresti voler iniziare a differenziarli assegnando nomi, ecc. Facendo clic sull'elemento, viene visualizzato un modulo in cui puoi impostare il tipo di elemento, assegnare un nome, scegliere un'icona diversa, ecc.
{width="600"}
Attributi dell'elemento della mappa:
|Parameter|Description|
|--|--------|
|*Type*|Tipo dell'elemento:
**Host** - icona che rappresenta lo stato di tutti i trigger dell'host selezionato
**Map** - icona che rappresenta lo stato di tutti gli elementi di una mappa
**Trigger** - icona che rappresenta lo stato di uno o più trigger
**[Host group](/manual/config/visualization/maps/host_groups)** - icona che rappresenta lo stato di tutti i trigger di tutti gli host appartenenti al gruppo selezionato
**Image** - un'icona non collegata ad alcuna risorsa|
|*Label*|Etichetta dell'icona, qualsiasi stringa.
È possibile usare macro e stringhe multilinea.
In questo campo sono supportate le macro di espressione [macros](/manual/appendix/macros/supported_by_location), ma solo con le funzioni `avg`, `last`, `min` e `max`, con il tempo come parametro (ad esempio, `{?avg(/host/key,1h)}`).
Per un elenco completo delle macro supportate, consulta [supported macros](/manual/appendix/macros/supported_by_location) e cerca 'map element labels'.|
|*Label location*|Posizione dell'etichetta in relazione all'icona:
**Default** - posizione predefinita dell'etichetta della mappa
**Bottom** - sotto l'icona
**Left** - a sinistra
**Right** - a destra
**Top** - sopra l'icona|
|*Host*|Inserisci l'host se il tipo di elemento è 'Host'. Questo campo supporta l'autocompletamento, quindi iniziando a digitare il nome di un host verrà mostrato un menu a discesa con gli host corrispondenti. Scorri verso il basso per selezionare. Fai clic su 'x' per rimuovere la selezione.|
|*Map*|Seleziona la mappa se il tipo di elemento è 'Map'. Questo campo supporta l'autocompletamento, quindi iniziando a digitare il nome di una mappa verrà mostrato un menu a discesa con le mappe corrispondenti. Scorri verso il basso per selezionare. Fai clic su 'x' per rimuovere la selezione.|
|*Triggers*|Se il tipo di elemento è 'Trigger', seleziona uno o più trigger nel campo *New triggers* qui sotto e fai clic su *Add*.
L'ordine dei trigger selezionati può essere modificato, ma solo all'interno della stessa gravità dei trigger. La selezione multipla dei trigger influisce anche sulla risoluzione delle macro {HOST.\*} sia in modalità modifica sia in modalità visualizzazione.
In modalità modifica, le prime macro {HOST.\*} visualizzate verranno risolte in base al primo trigger nell'elenco (in base alla gravità del trigger).
La modalità visualizzazione dipende dal parametro [Display problems](/manual/config/visualization/maps/map#creating-a-map) negli attributi generali della mappa:
- Se viene scelta la modalità *Expand single problem*, le prime macro {HOST.\*} visualizzate verranno risolte in base all'ultimo trigger di problema rilevato (indipendentemente dalla gravità) oppure al primo trigger nell'elenco (se non è stato rilevato alcun problema).
- Se viene scelta la modalità *Number of problems and expand most critical one*, le prime macro {HOST.\*} visualizzate verranno risolte in base alla gravità del trigger.
|
|*Host group*|Inserisci l'host group se il tipo di elemento è 'Host group'. Questo campo supporta l'autocompletamento, quindi iniziando a digitare il nome di un gruppo verrà mostrato un menu a discesa con i gruppi corrispondenti. Scorri verso il basso per selezionare. Fai clic su 'x' per rimuovere la selezione.|
|*Tags*|Specifica i tag per limitare il numero di problemi visualizzati nel widget. È possibile includere ed escludere tag e valori di tag specifici. È possibile impostare più condizioni. La corrispondenza del nome del tag è sempre sensibile alle maiuscole.
Per ogni condizione sono disponibili diversi operatori:
**Exists** - include i nomi dei tag specificati
**Equals** - include i nomi e i valori dei tag specificati (sensibile alle maiuscole)
**Contains** - include i nomi dei tag specificati in cui i valori del tag contengono la stringa inserita (corrispondenza di sottostringa, non sensibile alle maiuscole)
**Does not exist** - esclude i nomi dei tag specificati
**Does not equal** - esclude i nomi e i valori dei tag specificati (sensibile alle maiuscole)
**Does not contain** - esclude i nomi dei tag specificati in cui i valori del tag contengono la stringa inserita (corrispondenza di sottostringa, non sensibile alle maiuscole)
Esistono due tipi di calcolo per le condizioni:
**And/Or** - tutte le condizioni devono essere soddisfatte, le condizioni con lo stesso nome di tag verranno raggruppate dalla condizione Or
**Or** - è sufficiente che una condizione sia soddisfatta
Questo campo è disponibile per i tipi di elemento host e host group.|
|*Automatic icon selection*|In questo caso verrà utilizzata una mappatura delle icone per determinare quale icona visualizzare.|
|*Icons*|Puoi scegliere di visualizzare icone diverse per l'elemento nei seguenti casi: default, problem, maintenance, disabled.|
|*Coordinate X*|Coordinata X dell'elemento della mappa.|
|*Coordinate Y*|Coordinata Y dell'elemento della mappa.|
|*URLs*|È possibile impostare URL specifici per l'elemento (fino a 2048 caratteri). È anche possibile definire un'etichetta per l'URL. Questi verranno visualizzati come link quando un utente fa clic sull'elemento in modalità visualizzazione della mappa. Se l'elemento ha i propri URL e sono definiti URL a livello di mappa per il suo tipo, verranno combinati nello stesso menu.
Le macro possono essere usate nei nomi e nei valori degli elementi della mappa. Per un elenco completo, consulta [supported macros](/manual/appendix/macros/supported_by_location) e cerca 'map URL names and values'.|
::: noteimportant
Gli elementi aggiunti non vengono salvati automaticamente. Se
lasci la pagina, tutte le modifiche potrebbero andare perse.
Per questo motivo, è consigliabile fare clic sul pulsante **Update** nell'angolo in alto a destra. Una volta fatto clic, le modifiche vengono salvate indipendentemente da ciò che scegli nel popup successivo.
Le opzioni della griglia selezionate vengono salvate anche con ogni mappa.
:::
[comment]: # ({/ff769e3e-3ed51336})
[comment]: # ({e720d30b-e720d30b})
#### Selezione degli elementi
Per selezionare gli elementi, selezionane uno e poi tieni premuto *Ctrl* per selezionare gli altri.
Puoi anche selezionare più elementi trascinando un rettangolo nell'area modificabile e selezionando tutti gli elementi al suo interno.
Una volta selezionato più di un elemento, il modulo delle proprietà dell'elemento passa alla modalità di aggiornamento di massa, così puoi modificare in un'unica volta gli attributi degli elementi selezionati. Per farlo, contrassegna l'attributo usando la casella di controllo e inserisci un nuovo valore. Qui puoi usare le macro (ad esempio, {HOST.NAME} per l'etichetta dell'elemento).
{width="600"}
[comment]: # ({/e720d30b-e720d30b})
[comment]: # ({55e2211e-d9136de4})
#### Collegamento degli elementi
Una volta posizionati alcuni elementi sulla mappa, è il momento di iniziare a collegarli. Per collegare due elementi devi prima selezionarli. Con gli elementi selezionati, fai clic su *Add* accanto a Link.
Una volta creato un link, il modulo del singolo elemento contiene ora una sezione aggiuntiva *Links*. Fai clic su *Edit* per modificare gli attributi del link.
{width="600"}
Attributi del link:
|Parameter|Description|
|--|--------|
|*Label*|Etichetta che verrà visualizzata sopra il link.
Le espressioni [macros](/manual/appendix/macros/supported_by_location) sono supportate in questo campo, ma solo con le funzioni `avg`, `last`, `min` e `max`, con il tempo come parametro (ad esempio, `{?avg(/host/key,1h)}`).|
|*Connect to*|L'elemento a cui il link si connette.|
|*Type (OK)*|Stile predefinito del link:
**Line** - linea singola
**Bold line** - linea in grassetto
**Dot** - punti
**Dashed line** - linea tratteggiata|
|*Color (OK)*|Colore predefinito del link.|
|*[Link indicators](links)*|Elenco dei trigger collegati al link. Nel caso in cui un trigger abbia stato PROBLEM, il suo stile viene applicato al link.|
[comment]: # ({/55e2211e-d9136de4})
[comment]: # ({726a54c2-726a54c2})
#### Spostamento e copia-incolla degli elementi
Diversi elementi selezionati possono essere **spostati** in un'altra posizione nella mappa facendo clic su uno degli elementi selezionati, tenendo premuto il pulsante del mouse e spostando il cursore nella posizione desiderata.
Uno o più elementi possono essere **copiati** selezionando gli elementi, quindi facendo clic su un elemento selezionato con il pulsante destro del mouse e scegliendo *Copy* dal menu.
{width="600"}
Per incollare gli elementi, fare clic su un'area della mappa con il pulsante destro del mouse e selezionare *Paste* dal menu. L'opzione *Paste without external links* incollerà gli elementi mantenendo solo i collegamenti tra gli elementi selezionati.
La copia-incolla funziona all'interno della stessa finestra del browser. Le scorciatoie da tastiera non sono supportate.
[comment]: # ({/726a54c2-726a54c2})
[comment]: # ({31a59fea-26543c2f})
#### Aggiunta di forme
Oltre agli elementi della mappa, è anche possibile aggiungere alcune forme.
Le forme non sono elementi della mappa; sono solo una rappresentazione visiva. Per
esempio, una forma rettangolare può essere usata come sfondo per raggruppare alcuni
host. È possibile aggiungere forme rettangolari ed ellittiche.
Per aggiungere una forma, fai clic su *Add* accanto a Shape. La nuova forma apparirà
nell'angolo in alto a sinistra della mappa. Trascinala e rilasciala dove preferisci.
Una nuova forma viene aggiunta con i colori predefiniti. Facendo clic sulla forma, viene
visualizzato un modulo e puoi personalizzare l'aspetto della forma, aggiungere testo,
ecc.
{width="600"}
Per selezionare le forme, selezionane una e poi tieni premuto *Ctrl* per selezionare le
altre. Con più forme selezionate, le proprietà comuni possono essere aggiornate in massa,
analogamente agli elementi.
È possibile aggiungere testo nelle forme. Le [macro](/manual/appendix/macros/supported_by_location) di espressione sono supportate nel
testo, ma solo con le funzioni `avg`, `last`, `min` e `max`, con
il tempo come parametro (ad esempio, `{?avg(/host/key,1h)}`).
Per visualizzare solo il testo, la forma può essere resa invisibile rimuovendo il
bordo della forma (seleziona 'None' nel campo *Border*). Ad esempio, nota come la macro
{MAP.NAME}, visibile nello screenshot sopra, sia in realtà una forma rettangolare con testo, che
può essere vista facendo clic sulla macro:
{MAP.NAME} viene risolta nel nome della mappa configurato quando si visualizza la mappa.
Se nel testo vengono usati hyperlink, diventano cliccabili durante la visualizzazione
della mappa.
L'andata a capo del testo è sempre attiva all'interno delle forme. Tuttavia, all'interno
di un'ellisse, le righe vengono mandate a capo come se l'ellisse fosse un rettangolo.
La divisione in parole non è implementata, quindi le parole lunghe (parole che non
entrano nella forma) non vengono mandate a capo, ma vengono mascherate (nella pagina di modifica della mappa) o ritagliate
(altre pagine con mappe).
[comment]: # ({/31a59fea-26543c2f})
[comment]: # ({ef42602b-ef42602b})
#### Aggiunta di linee
Oltre alle forme, è anche possibile aggiungere alcune linee. Le linee possono essere utilizzate per collegare elementi o forme in una mappa.
Per aggiungere una linea, fai clic su *Add* accanto a Shape. Una nuova forma apparirà nell'angolo in alto a sinistra della mappa. Selezionala e fai clic su *Line* nel modulo di modifica per trasformare la forma in una linea. Quindi regola le proprietà della linea, come tipo di linea, larghezza, colore, ecc.
{width="600"}
[comment]: # ({/ef42602b-ef42602b})
[comment]: # ({5750972e-1b4ca573})
#### Ordinamento di forme e linee
Per portare una forma davanti all'altra (o viceversa), fai clic sulla forma con il pulsante destro del mouse per aprire il menu della forma della mappa.
[comment]: # ({/5750972e-1b4ca573})