 |
This is a machine translation based on the English version of the article. It might or might not have already been subject to text preparation. If you find errors, please file a GitHub issue that states the paragraph that has to be improved. |
1. Cos'è NagVis?
Nell'articolo sulle basi del monitoraggio hai visto la mappa della topologia di una rete basata sulle relazioni padre-figlio. NagVis si occupa proprio di queste mappe. L'estensione permette di visualizzare, ad esempio, infrastrutture, server, porte o processi.
Il funzionamento di NagVis è fondamentalmente molto semplice: Checkmk, o per essere più precisi Livestatus, fornisce dati di back-end come host, servizi, gruppi di host e gruppi di servizi. Questi elementi del tuo monitoraggio possono essere posizionati come simboli su varie mappe. Questi simboli dinamici possono quindi mostrare lo stato attuale di ciascuno degli host e dei servizi. Ulteriori informazioni dettagliate possono essere fornite dai tooltip. Infine, i simboli e gli altri elementi fungono anche da link agli oggetti Checkmk che rappresentano. Altri elementi disponibili sono linee, indicatori di performance (gadget) e contenitori per contenuti esterni.
Per farti un'idea più chiara di cosa si può ottenere con NagVis in Checkmk, ecco tre esempi:
Mappe geografiche basate su OpenStreetMap per la gestione delle posizioni.
Mappe topologiche automatiche basate sulle relazioni padre-figlio.
Mappe di singoli switch o sale server per avere una panoramica delle porte e dell'hardware.
A condizione che le relazioni padre-figlio siano state definite, senza ulteriori azioni puoi richiamare una mappa in Checkmk utilizzando Monitor > Overview > Parent / Child topology. In questo caso non sono necessari ulteriori passaggi.
2. Configurazione di NagVis
NagVis è completamente integrato in Checkmk e configurato in modo tale da permetterti di iniziare immediatamente ad aggiungere elementi dal tuo monitoraggio alle mappe.
Per avviare NagVis, apri innanzitutto la sezione con gli snap-in disponibili per la barra laterale tramite 
nella parte inferiore della barra laterale.
Qui seleziona lo snap-in NagVis maps e infine avvia NagVis con il pulsante Edit.
Prima di creare la tua prima mappa, dovresti dare un'occhiata alla configurazione principale in Options > General Configuration. Qui puoi trovare oltre 100 opzioni per le impostazioni di base, come i formati dei dati e le impostazioni della lingua, dalla visualizzazione degli oggetti sulle mappe alla ponderazione degli stati disponibili di host e servizi.
A questo punto preferiamo evitare una descrizione esaustiva dell'uso di NagVis, e in particolare delle sue opzioni di configurazione. NagVis dispone infatti di un'ottima documentazione dettagliata, in cui vengono spiegate anche tutte le opzioni della configurazione principale. Di seguito ci limiteremo alle nozioni di base più essenziali per generare mappe semplici e utili utilizzando NagVis in Checkmk.
3. Creazione di mappe di mappatura
3.1. I vari tipi di mappe
NagVis offre un totale di cinque diversi tipi di mappe: mappe geografiche regolari, dinamiche, automatiche e interattive/non interattive.
La mappa standard è il tipo di mappa più comune. La mappa può visualizzare qualsiasi scenario desiderato: dalle porte degli switch, alle sale server, fino alle infrastrutture complete. Gli elementi (simboli, linee, ecc.) vengono aggiunti singolarmente alle mappe dagli inventari degli host e dei servizi di Checkmk.
La mappa dinamica assomiglia in gran parte alla mappa regolare, con una differenza significativa però: host, servizi, gruppi di host e gruppi di servizi non vengono specificati esplicitamente, ma utilizzando filtri sotto forma di espressioni regolari; per essere più precisi, sotto forma di filtri Livestatus validi. In questo modo i nuovi host e servizi, così come eventuali modifiche, vengono automaticamente inseriti nella mappa senza che sia necessaria alcuna azione manuale aggiuntiva.
La mappa automatica l'hai già vista. Si tratta della mappa della topologia di rete menzionata all'inizio di questo articolo, generata in modo completamente automatico dalle relazioni padre-figlio definite in Checkmk.
La mappa geografica è una mappa realizzata con il materiale cartografico del progetto OpenStreetMap (OSM) per gli sfondi.
3.2. Creazione di un'automap
Il modo più veloce per creare una mappa rappresentativa è l'automap.
Crea una nuova mappa di tipo "Automap based on parent/child relations" tramite Options > Manage Maps > Create Map.
In "ID" inserisci il nome interno myautomap, e in "Alias" il tuo nome My Automap per la visualizzazione.
La mappa apparirà immediatamente nell'area dei contenuti e il link corrispondente apparirà nello snap-in NagVis maps. Le impostazioni specifiche di Automap possono essere personalizzate in Edit Map > Map Options > Automap. La voce render_mode è particolarmente interessante in quanto fornisce il layout fondamentale dei nodi sulla mappa.
Inoltre, qui puoi specificare la radice della mappa – anche se è più semplice farlo cliccando con il tasto destro su un simbolo sulla mappa e selezionando la voce del Menu contestuale "Make root".
3.3. Creazione di una mappa standard
Le mappe regolari sono le più comuni in NagVis. Per farti conoscere le procedure di NagVis e i suoi elementi più importanti, ti mostreremo come creare una piccola mappa di un rack di server. Questo visualizzerà un host su uno sfondo individuale e fornirà avvisi visivi e acustici quando l'host monitorato non è OK.
Per creare la mappa, apri le opzioni tramite Options > Manage Maps.
Qui, in Create Map, assegna alla mappa il nome mymap e l'alias My Map.
Per l'Map Type, seleziona Regular map e conferma con il pulsante Create.
Ora importa un'immagine del rack in fase di monitoraggio come sfondo. Puoi farlo tramite Options > Manage Backgrounds. Seleziona il file locale e conferma con il pulsante Upload.
Ora l'immagine importata deve essere impostata come sfondo per la mappa corrente. Apri le opzioni della mappa con "Edit Map > Map Options" e vai alla scheda "Appearance". Qui attiva l'opzione "map_image" e seleziona l'immagine desiderata dal menu. Non salvare ancora: serve ancora un'impostazione dalle opzioni della mappa.
Vai alla scheda "Obj. Defaults". Qui puoi attivare l'opzione "label_show". Questa opzione consente di etichettare i simboli degli host e dei servizi sulla mappa con i rispettivi nomi; in caso contrario, i simboli saranno identificabili solo tramite i loro tooltip. Infine, salva queste impostazioni.
Ora è il momento di aggiungere l’host. Clicca su “Edit Map > Add Icon > host” e poi con il cursore (che ora appare come una croce) sulla posizione della mappa dove vuoi posizionare il simbolo — a questo punto si aprirà la finestra di dialogo “Create Object”. Nella scheda “General” seleziona semplicemente l’host desiderato dal menu a discesa in “host_name” e salva. Se gestisci più istanze Checkmk, puoi utilizzare una sorgente dati alternativa tramite “backend_id”.
Il simbolo è ora posizionato sulla mappa e fornisce informazioni dettagliate tramite un tooltip. Cliccando sul simbolo si accede direttamente all'host in Checkmk: tutti gli oggetti posizionati in NagVis sono collegamenti ai tuoi oggetti Checkmk.
Per poter spostare o modificare un simbolo è necessario attivare la modalità di modifica. Fai clic con il tasto destro sul simbolo per aprire il Menu contestuale e seleziona "Unlock".
Ora puoi spostare il simbolo o aprire nuovamente il Menù contestuale. Qui vedrai una serie di nuove opzioni che ti consentiranno di clonare, eliminare o modificare l'oggetto, oppure di confermare il problema direttamente da qui scegliendo l'opzione "Acknowledge".
Una volta completata la modifica di un host/simbolo, apri nuovamente il Menù contestuale e seleziona "Lock". A proposito, con "Edit Map > Lock/Unlock all" è possibile attivare e disattivare la modalità di edizione per l'intera mappa.
Ora puoi aggiungere altri host alla mappa. L'aggiunta di servizi, gruppi di host e gruppi di servizi funziona in modo simile.
Per finire, la mappa può essere configurata in modo tale che, durante il caricamento, eventuali problemi vengano segnalati da un segnale acustico e dai simboli degli host lampeggianti. Per farlo, apri "Edit Map > Map Options" e passa alla scheda "Events". Qui, nella parte superiore dello schermo, attiva "event_on_load" e, nella parte inferiore, seleziona la box "event_sound" per ricevere avvisi acustici.
3.4. Creazione di una mappa geografica
Le mappe geografiche sono disponibili in due diverse forme: La variante interattiva può essere fatta scorrere e ingrandita come su Google Maps & Co., e viene impostata automaticamente come sfondo. Gli oggetti che sono stati posizionati su tali mappe appariranno su ogni mappa successiva dello stesso tipo. NagVis presume che un oggetto si trovi sempre in una posizione specifica, indipendentemente dalla scala della mappa. Quindi, ad esempio, un host situato ad Amburgo apparirà su una mappa del mondo, su una mappa della Germania e, ovviamente, su una mappa di Amburgo.
NagVis considera le varie sezioni della mappa e i livelli di zoom solo come viewports. In qualsiasi momento i viewports possono essere salvati come una nuova mappa separata. Poiché le viewport/mappe possono essere visualizzate anche come simboli sulle mappe, in una certa misura le mappe possono essere annidate. Ad esempio, è possibile richiamare una mappa della Germania con le sue dipendenze, quindi con un clic una vista più dettagliata di uno stato e, se necessario, le mappe di una filiale specifica, della sala server e da lì persino una mappa di un singolo switch.
A differenza della navigazione manuale, l'uso di una mappa interattiva è più veloce e comodo, e inoltre le singole mappe sono attive, così che, ad esempio, possono essere visualizzate in parallelo su monitor separati, oppure impostate per la rotazione automatica su un unico monitor (ne parleremo più avanti). Altra cosa importante: in questo modo è disponibile un riepilogo delle mappe correlate sotto forma di tooltip. Questo rende il loro utilizzo più intuitivo anche per i terzi, poiché non devono cliccare attraverso le gerarchie, né devono sapere dove è necessario lo zoom.
Le mappe geografiche non interattive devono essere alimentate con un file CSV contenente gli host e le coordinate da visualizzare. In questo caso non ci sono elementi generali preesistenti.
Nella documentazione di NagVis le mappe geografiche interattive sono chiamate worldmaps, mentre le varianti non interattive sono chiamate geomaps. Le worldmaps sono state aggiunte per la prima volta alla versione 1.9 di NagVis.
Esempio: crea una mappa interattiva per tutta la Germania e collegaci una nuova viewport per la Renania Settentrionale-Vestfalia (NRW).
Crea una mappa geografica interattiva – una worldmap – con Options > Manage Maps > Create Map.
Come "Map Type" seleziona l'opzione "Geographical Map (interactive)" – qui puoi anche definire l'ID (mygeomap) e l'alias (My Geographical Map).
Indica la sezione della mappa che vuoi come panoramica e salva questa visualizzazione usando Edit Map > Viewport > Save view.
Successivamente, ingrandisci la mappa fino a raggiungere il livello di dettaglio desiderato per la Renania Settentrionale-Vestfalia.
Questa volta salva la visualizzazione con "Map > Viewport > Save as new map" come nuova mappa "mygeomap_nrw".
L'alias della mappa verrà ripreso dalla mappa originale, quindi ora avrai due mappe denominate My Geographical Map nella barra di navigazione a sinistra.
Definisci quindi un nuovo alias My Geographical Map NRW con Edit Map > Map Options.
Passa alla mappa della Germania My Geographical Map e aggiungi il collegamento alla mappa della Renania Settentrionale-Vestfalia con Edit Map > Add Icon > Map. Nella finestra di dialogo Create Object che si apre, devi solo selezionare la mappa mygeomap_nrw dal menu map_name.
Dopodiché, cliccando sul nuovo simbolo nella mappa della Germania, verrai reindirizzato direttamente alla mappa della Renania Settentrionale-Vestfalia. Allo stesso modo è possibile collegare tra loro altre mappe e, naturalmente, è possibile integrare anche una navigazione dalla mappa della Renania Settentrionale-Vestfalia alla mappa della Germania.
Il caricamento effettivo dei contenuti della mappa corrisponde alla procedura utilizzata per gli altri tipi di mappa. Ma ricorda: tutti gli oggetti che aggiungi a una delle mappe del mondo appariranno anche su tutte le altre mappe del mondo, poiché in realtà sono solo visualizzazioni alternative della situazione geografica reale.
3.5. Creazione di una mappa dinamica
Le mappe dinamiche differiscono dalle mappe normali – come accennato in precedenza – per il metodo di aggiunta dei loro elementi. Invece che tramite aggiunte manuali, le mappe dinamiche ricevono i loro elementi – host, servizi, gruppi di host e gruppi di servizi – in modo dinamico tramite i filtri Livestatus. Ad esempio, una mappa dovrebbe ricevere automaticamente i servizi CPU load da tutti gli host.
Per creare una mappa del genere, inizia di nuovo da Options > Manage Maps > Create Map e assegna un ID (mydynamicmap) e un alias (My Dynamic Map).
Quindi apri le opzioni della mappa con Edit Map > Map Options e seleziona la scheda Dynmap. Qui attiva l'opzione dynmap_object_types e scegli i servizi come tipo di oggetto.
Ora arriva la parte interessante con la seconda opzione "dynmap_object_filter", con cui si definisce il filtro per i servizi.
Usa la semplice query Livestatus "Filter: description ~ CPU load\n".
In questo modo, la stringa "CPU load" verrà cercata nella colonna "description".
Questo "\n" non fa parte del filtro stesso, ma genera un'interruzione di riga richiesta dalla query Livestatus costruita dal filtro.
Se ora salvi, tutti i servizi CPU load del tuo monitoraggio appariranno sulla mappa. Inoltre, qualsiasi nuovo oggetto nel monitoraggio che corrisponda al filtro verrà aggiunto automaticamente alla mappa.
Nella documentazione di NagVis è descritto anche come la configurazione funzioni direttamente utilizzando i file di configurazione.
A proposito: dato che le mappe dinamiche possono anche essere salvate come mappe statiche con Actions > Export to static map, questo metodo può essere usato come aiuto per i principianti per creare mappe statiche contenenti moltissimi elementi.
4. Personalizzazione delle mappe
4.1. Linee
NagVis offre vari tipi di linee: ci sono linee puramente decorative senza ulteriori funzioni in Edit Map > Add Special > Stateless Line , linee che visualizzano host e servizi con i "colori del semaforo" allo stesso modo dei simboli, e le linee della mappa meteorologica. Queste ultime visualizzano le larghezze di banda di rete utilizzando sette colori distinti. Per creare una linea della mappa meteorologica procedi come segue:
Inizia da Edit Map > Add Line > Service e seleziona un host e un'interfaccia di rete nel dialogo Create Object.
Poi, switch alla scheda "Appearance" e imposta "view_type" su "line".
Come "line_type", attiva la voce "--%+BW-><-%+BW--".
In questo modo verranno generate delle linee per l'upload e lo scaricamento che includeranno etichette per la larghezza di banda percentuale (%) e assoluta (BW).
Una volta salvate, le linee appariranno sulla mappa. Cliccando sul simbolo "lucchetto" al centro è possibile spostare sia i punti finali che il punto centrale della linea.
NagVis fornisce anche una legenda predefinita: utilizzando Edit Map > Add Special > Shape inserisci una cosiddetta forma – semplicemente un'immagine in NagVis. Nell'opzione icon scegli l'immagine demo_traffic_load_legend.png dal menu a discesa.
4.2. Gadget
I gadget, come le linee e i simboli, sono strumenti di visualizzazione su una mappa. Mostrano i dati sulle prestazioni sotto forma di tachimetri, termometri o simili. Di conseguenza, sono disponibili solo per i servizi. Ad esempio, il carico su un'interfaccia di rete può essere rappresentato come un tachimetro:
Aggiungi un servizio come simbolo alla tua mappa utilizzando Edit Map > Add Icon > Service. Nella scheda General scegli un host e un'interfaccia di rete adeguata come servizio.
Switch alla scheda "Appearance" e imposta "view_type" su "gadget".
Subito sotto, attiva "gadget_url".
Qui ci sono diverse varianti di visualizzazione che corrispondono ai file in "~/share/nagvis/htdocs/userfiles/gadgets/".
Seleziona "std_speedometer.php" per la visualizzazione a tachimetro.
4.3. Far ruotare le mappe
Nella pagina panoramica di NagVis avrai notato la voce Rotations in basso a sinistra nella barra di navigazione, o rispettivamente l'elenco delle mappe sotto Rotation Pools al centro. Le mappe possono essere impostate per ruotare automaticamente a qualsiasi intervallo desiderato, il che è pratico, ad esempio, per i monitor informativi visibili al pubblico.
Puoi configurare questa opzione nel file di configurazione di NagVis ~/etc/nagvis/nagvis.ini.php.
Apri questo file e scorri fino alla riga 448, dove troverai Rotation pool definitions.
Qui sono necessarie tre righe per definire un pool di rotazione, le mappe appropriate e l'intervallo — nell'esempio qui sotto il pool myrotation con le mappe mymap1, mymap2 e mymap3, e con un intervallo di 30 secondi: