1 Configurazione di una mappa di rete
Panoramica
La configurazione di una mappa in Zabbix richiede innanzitutto la creazione della mappa, definendone i parametri generali; successivamente si procede a popolare la mappa vera e propria con elementi e relativi collegamenti.
È possibile popolare la mappa con elementi quali un host, un gruppo di host, un trigger, un'immagine o un'altra mappa.
Le icone vengono utilizzate per rappresentare gli elementi della mappa. È possibile definire le informazioni da visualizzare con le icone e impostare la visualizzazione dei problemi recenti 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 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, 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 su grafica vettoriale (SVG).
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.
<!-- -->
- Le mappe private sono visibili solo al loro proprietario e agli utenti/gruppi di utenti con cui la mappa è condivisa 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.
Creazione di una mappa
Per creare una mappa, procedere come segue:
- Andare in Monitoring > Maps.
- Aprire la vista con tutte le mappe.
- Fare clic su Create map.
È anche possibile usare il pulsante Clone nel modulo di configurazione di una mappa esistente per creare una nuova mappa. 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 di input obbligatori sono contrassegnati con 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 - l'immagine selezionata verrà usata come immagine di sfondo. È possibile usare una mappa geografica o qualsiasi altra immagine per migliorare la mappa. |
| Background scale | Usa ridimensionamento dello sfondo: None - nessun ridimensionamento; Proportionally - copre l'intero sfondo della mappa, ma mantiene le proporzioni dell'immagine (predefinito). |
| 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 host. |
| Icon highlight | Se si seleziona questa casella di controllo, gli elementi della mappa verranno evidenziati. Gli elementi con un trigger attivo riceveranno uno sfondo rotondo, dello stesso colore del trigger con severità più alta. Inoltre, verrà visualizzata una spessa linea verde attorno al cerchio se tutti i problemi sono stati confermati. Gli elementi con stato "disabled" o "in maintenance" riceveranno uno sfondo quadrato, rispettivamente grigio e arancione. Vedi anche: Visualizzazione delle mappe |
| Mark elements on trigger status change | Una modifica recente dello stato del trigger (problema recente o risoluzione) verrà evidenziata con indicatori (triangoli rossi rivolti verso l'interno) sui tre lati dell'icona dell'elemento che sono liberi dall'etichetta. Gli indicatori vengono visualizzati per 30 minuti. |
| Display problems | Selezionare come visualizzare i problemi 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. Il "più critico" viene determinato in base alla severità del problema e, in caso di parità, all'ID 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, in caso di parità, 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 di controllo, sarà possibile definire tipi di etichetta separati per tipi di elemento separati. |
| Host group label type | Tipo di etichetta usato per l'elemento della mappa: Label - etichetta dell'elemento della mappa IP address - indirizzo IP Element name - nome dell'elemento (ad esempio, nome host) Status only - solo stato (OK o PROBLEM) Nothing - non viene visualizzata alcuna etichetta |
| Host label type | |
| Trigger label type | |
| Map label type | |
| Image label type | |
| 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 |
| Show map element labels | Selezionare come visualizzare le etichette degli elementi della mappa: Always - sempre visualizzate (predefinito); Auto hide - nasconde l'etichetta se non è selezionata o se il puntatore non vi passa sopra. |
| Show link labels | Selezionare come visualizzare le etichette dei collegamenti: Always - sempre visualizzate (predefinito); Auto hide - nasconde l'etichetta se non è selezionata o se il puntatore non vi passa sopra. |
| Problem display | Visualizza il conteggio dei problemi come: All - verrà visualizzato il conteggio completo dei problemi Separated - il conteggio dei problemi non confermati verrà visualizzato separatamente come numero rispetto al conteggio totale dei problemi Unacknowledged only - verrà visualizzato solo il conteggio dei problemi non confermati |
| Minimum 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 riportate nella mappa. |
| Show suppressed problems | Selezionare la casella di controllo per visualizzare i problemi che altrimenti verrebbero soppressi (non mostrati) a causa della manutenzione dell'host. |
| URLs | Qui è possibile definire gli URL per ciascun tipo di elemento, dove: Name - un'etichetta per l'URL; URL - un URL (fino a 2048 caratteri); Element - il tipo di elemento (ad esempio, Host, Host group, ecc.). 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 un elenco completo, vedere macro supportate e cercare 'map URL names and values'. |
Condivisione
La scheda Condivisione contiene il tipo di mappa e le opzioni di condivisione (gruppi di utenti, utenti) per le mappe private:

| Parametro | Descrizione |
|---|---|
| Tipo | Selezionare il tipo di mappa: Privata - la mappa è visibile solo ai gruppi di utenti e agli utenti selezionati Pubblica - la mappa è visibile a tutti |
| Elenco delle condivisioni dei gruppi di utenti | Selezionare i gruppi di utenti a cui la mappa è accessibile. È possibile consentire l'accesso in sola lettura o in lettura-scrittura. |
| Elenco delle condivisioni degli utenti | Selezionare gli utenti a cui la mappa è accessibile. È possibile consentire l'accesso in sola lettura o in lettura-scrittura. |
Quando si fa clic su Aggiungi per salvare questa mappa, viene creata una mappa vuota con un nome, dimensioni e determinate preferenze. Ora è necessario aggiungere alcuni elementi. Per farlo, fare clic su Modifica nell'elenco delle mappe per aprire l'area modificabile.
Aggiunta di elementi
Per aggiungere un elemento, fare clic su Add accanto a Map element. Il nuovo elemento
apparirà nell'angolo superiore sinistro della mappa. Trascinarlo
nella posizione desiderata.
Si noti che con l'opzione Grid impostata su "On", gli elementi si allineeranno sempre alla griglia (è possibile scegliere varie dimensioni della griglia dal menu a discesa, nonché nascondere/mostrare la griglia). Se si desidera posizionare gli elementi liberamente senza allineamento, impostare l'opzione su "Off". (È possibile allineare in seguito elementi casuali alla griglia facendo clic su Align map elements.)
Ora che alcuni elementi sono stati posizionati, si potrebbe voler iniziare a differenziarli assegnando nomi, ecc. Facendo clic sull'elemento, viene visualizzato un modulo in cui è possibile impostare il tipo di elemento, assegnare un nome, scegliere un'icona diversa, ecc.

Attributi dell'elemento della mappa:
| Parameter | Description |
|---|---|
| Type | Tipo dell'elemento: Host - icona che rappresenta lo stato di tutti i trigger del 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 - icona che rappresenta lo stato di tutti i trigger di tutti i host appartenenti al gruppo selezionato Image - un'icona, non collegata ad alcuna risorsa |
| Label | Etichetta dell'icona, una stringa qualsiasi. È possibile utilizzare macro e stringhe multilinea. Le macro di espressione 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)}).Per un elenco completo delle macro supportate, vedere supported macros e cercare 'map element labels'. |
| Label location | Posizione dell'etichetta rispetto all'icona: Default - posizione predefinita dell'etichetta della mappa; Bottom - sotto l'icona; Left - a sinistra; Right - a destra; Top - sopra l'icona. |
| Show label | Selezionare come visualizzare l'etichetta dell'elemento: Default - usa le impostazioni Show map element labels della configurazione della mappa (predefinito); Always - sempre visualizzata (predefinito); Auto hide - nasconde l'etichetta se non è evidenziata dal puntatore o selezionata. |
| Host | Selezionare un host; in alternativa, inserire il nome del host. Questo campo supporta il completamento automatico, quindi iniziando a digitare il nome di un host verrà visualizzato un menu a discesa con i host corrispondenti. Scorrere verso il basso per selezionarne uno. Fare clic sull'icona di rimozione (x) per rimuovere la selezione. Questo campo è disponibile solo per elementi di tipo Host. |
| Map | Selezionare una mappa; in alternativa, inserire il nome della mappa. Questo campo supporta il completamento automatico, quindi iniziando a digitare il nome di una mappa verrà visualizzato un menu a discesa con le mappe corrispondenti. Scorrere verso il basso per selezionarne una. Fare clic sull'icona di rimozione (x) per rimuovere la selezione. Questo campo è disponibile solo per elementi di tipo Map. |
| Triggers | Selezionare uno o più trigger nel campo New triggers sottostante e fare clic su Add. In alternativa, iniziare a digitare il nome di un trigger e selezionarne uno dall'elenco a discesa dei trigger corrispondenti. Fare clic sull'icona di rimozione (x) per rimuovere la selezione. Questo campo è disponibile solo per elementi di tipo Trigger. L'ordine dei trigger selezionati può essere modificato, ma solo all'interno dello stesso livello di gravità dei trigger. La selezione di più trigger influisce anche sulla risoluzione della macro {HOST.*} sia in modalità di modifica che in modalità di visualizzazione. In modalità di modifica, le prime macro {HOST.*} visualizzate verranno risolte in base al primo trigger nell'elenco (in base alla gravità del trigger). La modalità di visualizzazione dipende dal parametro Display problems negli attributi generali della mappa: - Se è selezionata la modalità Expand single problem, le prime macro {HOST.*} visualizzate verranno risolte in base al trigger del problema rilevato più di recente (indipendentemente dalla gravità) oppure al primo trigger nell'elenco (se non viene rilevato alcun problema). - Se è selezionata 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 | Selezionare un gruppo di host; in alternativa, inserire il gruppo di host. Questo campo supporta il completamento automatico, quindi iniziando a digitare il nome di un gruppo di host verrà visualizzato un menu a discesa con i gruppi di host corrispondenti. Scorrere verso il basso per selezionarne uno. Fare clic sull'icona di rimozione (x) per rimuovere la selezione. Questo campo è disponibile solo per elementi di tipo Host group. |
| Problem tags | Specificare i tag per limitare il numero di problemi visualizzati nel widget. È possibile includere così come escludere tag e valori di tag specifici. È possibile impostare diverse condizioni. La corrispondenza del nome del tag distingue sempre tra maiuscole e minuscole. Sono disponibili diversi operatori per ciascuna condizione: Exists - include i nomi di tag specificati Equals - include i nomi di tag e i valori specificati (con distinzione tra maiuscole e minuscole) Contains - include i nomi di tag specificati in cui i valori del tag contengono la stringa immessa (corrispondenza per sottostringa, senza distinzione tra maiuscole e minuscole) Does not exist - esclude i nomi di tag specificati Does not equal - esclude i nomi di tag e i valori specificati (con distinzione tra maiuscole e minuscole) Does not contain - esclude i nomi di tag specificati in cui i valori del tag contengono la stringa immessa (corrispondenza per sottostringa, senza distinzione tra maiuscole e minuscole) 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 sia soddisfatta una condizione Questo campo è disponibile solo per elementi di tipo Host e Host group. |
| Automatic icon selection | Quando la casella di controllo è selezionata, la mappatura delle icone verrà utilizzata per determinare quale icona visualizzare. |
| Icons | È possibile scegliere di visualizzare icone diverse per l'elemento nei seguenti casi: Default, Problem, Maintenance e Disabled. Questo campo è disponibile solo per elementi di tipo Host. |
| Coordinates | Coordinate X e Y dell'elemento della mappa. |
| URLs | Qui è possibile impostare URL specifici per l'elemento, dove: Name - un'etichetta per l'URL; URL - un URL (fino a 2048 caratteri). Questi verranno visualizzati come collegamenti quando un utente fa clic sull'elemento nella modalità di visualizzazione della mappa. Se l'elemento ha URL propri e sono definiti URL a livello di mappa per il suo tipo, verranno combinati nello stesso menu. Le macro possono essere utilizzate nei nomi e nei valori degli elementi della mappa. Per un elenco completo, vedere supported macros e cercare 'map URL names and values'. |
Gli elementi aggiunti non vengono salvati automaticamente. Se si lascia la pagina, tutte le modifiche potrebbero andare perse.
Pertanto, è consigliabile fare clic sul pulsante Update nell'angolo superiore destro. Una volta fatto clic, le modifiche vengono salvate indipendentemente da ciò che si sceglie nel popup successivo.
Anche le opzioni della griglia selezionate vengono salvate con ciascuna mappa.
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).

Collegamento degli elementi
Una volta inseriti alcuni elementi nella mappa, è il momento di iniziare a collegarli. Per collegare due elementi, è necessario prima selezionarli. Con gli elementi selezionati, fare clic su Add accanto a Link.
Una volta creato un collegamento, il modulo del singolo elemento contiene ora un'ulteriore sezione Links. Fare clic su Edit per modificare gli attributi del collegamento.

Attributi del collegamento:
| Parametro | Descrizione |
|---|---|
| Label | Etichetta che verrà visualizzata sopra il collegamento. In questo campo sono supportate le macro di espressione, ma solo con le funzioni avg, last, min e max, con il tempo come parametro (ad esempio, {?avg(/host/key,1h)}). |
| Show label | Selezionare come visualizzare l'etichetta del collegamento: Default - usa le impostazioni Show map element labels della configurazione della mappa (predefinito); Always - sempre visualizzata (predefinito); Auto hide - nasconde l'etichetta se non è evidenziata al passaggio del mouse o selezionata. |
| Connect to | L'elemento a cui il collegamento si connette. |
| Type (OK) | Stile predefinito del collegamento. Selezionare lo stile: Line, Bold line, Dot oppure Dashed line. |
| Color (OK) | Colore predefinito del collegamento. Fare clic sul campione di colore per selezionare un altro colore. |
| Indicator type | Selezionare il tipo di indicatore del collegamento: Static link - nessun indicatore; Trigger - consente indicatori di collegamento basati su trigger; Item value - consente indicatori di collegamento basati sul valore dell'item. |
| Item | Selezionare l'item. Il valore di questo item influenzerà lo stile del collegamento. Questo campo è disponibile quando per Indicator type è selezionato Item value. |
| Indicators | L'elenco degli indicatori di collegamento. Questo campo è disponibile quando Indicator type è impostato su Trigger o Item value. Se impostato su Trigger, i trigger possono essere assegnati come indicatori di collegamento. Quando un trigger è nello stato Problem, il suo stile (colore selezionato e tipo di linea) verrà applicato al collegamento. Se impostato su Item value e nel campo Item è selezionato un item, i valori dell'item possono essere assegnati come indicatori di collegamento. Quando il valore dell'item raggiunge la soglia specificata (per un item numerico) o corrisponde al modello specificato (per un item di testo), il suo stile (colore selezionato e tipo di linea) viene applicato al collegamento. |
Spostamento e copia-incolla degli elementi
Diversi elementi selezionati possono essere spostati in un altro punto della 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 con il pulsante destro del mouse su un elemento selezionato e scegliendo Copy dal menu.

Per incollare gli elementi, fare clic con il pulsante destro del mouse su un'area della mappa e selezionare Paste dal menu. L'opzione Paste without external links incollerà gli elementi mantenendo solo i collegamenti tra gli elementi selezionati.
La funzione di copia-incolla funziona all'interno della stessa finestra del browser. Le scorciatoie da tastiera non sono supportate.
Ordinamento degli elementi
Per portare un elemento davanti all'altro (o viceversa), fai clic con il pulsante destro del mouse sull'elemento e seleziona Porta avanti/Porta in primo piano oppure Porta indietro/Porta sullo sfondo.

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. Ad esempio, una forma rettangolare può essere usata come sfondo per raggruppare alcuni host. È possibile aggiungere forme rettangolari ed ellittiche.
Per aggiungere una forma, fare clic su Add accanto a Shape. La nuova forma apparirà nell'angolo superiore sinistro della mappa. Trascinarla dove si preferisce.
Una nuova forma viene aggiunta con i colori predefiniti. Facendo clic sulla forma, viene visualizzato un modulo ed è possibile personalizzare l'aspetto della forma, aggiungere testo, ecc.

Per selezionare le forme, selezionarne una e poi tenere premuto Ctrl per selezionare le altre. Con più forme selezionate, le proprietà comuni possono essere aggiornate in massa, in modo simile a quanto avviene con gli elementi.
È possibile aggiungere testo nelle forme. Le
macro 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 (selezionare 'None' nel campo Border). Ad esempio, si noti come la macro {MAP.NAME}, visibile nello screenshot sopra, sia in realtà una forma rettangolare con testo, come si può vedere facendo clic sulla macro:

{MAP.NAME} viene risolta nel nome della mappa configurato durante la visualizzazione della mappa.
Se nel testo vengono utilizzati collegamenti ipertestuali, questi diventano cliccabili durante la visualizzazione della mappa.
L'a capo automatico del testo è sempre attivo all'interno delle forme. Tuttavia, all'interno di un'ellisse, le righe vanno a capo come se l'ellisse fosse un rettangolo. L'a capo automatico delle parole non è implementato, quindi le parole lunghe (parole che non entrano nella forma) non vanno a capo, ma vengono mascherate (nella pagina di modifica della mappa) o tagliate (altre pagine con mappe).
Aggiunta di linee
Oltre alle forme, è anche possibile aggiungere delle linee. Le linee possono essere utilizzate per collegare elementi o forme in una mappa.
Per aggiungere una linea, fare clic su Add accanto a Shape. Una nuova forma apparirà nell'angolo superiore sinistro della mappa. Selezionarla e fare clic su Line nel modulo di modifica per trasformare la forma in una linea. Quindi regolare le proprietà della linea, come il tipo di linea, la larghezza, il colore, ecc.

Ordinamento di forme e linee
Per portare una forma davanti all'altra (o viceversa), fai clic sulla forma con il tasto destro del mouse per aprire il menu della forma della mappa.
