********************** Struttura interfaccia ********************** .. contents:: Contenuti Introduzione ===================================================================================== L'interfaccia web di Sanet prevede una pagina di *login* iniziale che permette di accedere alla pagina principale del *tenant* primario. Dalla pagina del *tenant* e' possibile raggiungere (tramite link e menu) a tutte le altre pagine di consultazione/amministrazione di Sanet. .. digraph:: prova login -> "homepage (tenant primario)"; "homepage (tenant primario)" -> "System Config"; "homepage (tenant primario)" -> "Tenant Config"; "homepage (tenant primario)" -> "Node"; "homepage (tenant primario)" -> "Interface"; "homepage (tenant primario)" -> "Storage"; "homepage (tenant primario)" -> "Service"; "homepage (tenant primario)" -> "Device"; "homepage (tenant primario)" -> "Tag"; "homepage (tenant primario)" -> "Search"; "homepage (tenant primario)" -> "User"; "Node" -> "Interface"; "Node" -> "Storage"; "Node" -> "Service"; "Node" -> "Device"; "Node" -> "Datasource"; "Node" -> "Condition"; "Interface" -> "Datasource"; "Interface" -> "Condition"; "Storage" -> "Datasource"; "Storage" -> "Condition"; "Service" -> "Datasource"; "Service" -> "Condition"; "Device" -> "Datasource"; "Device" -> "Condition"; "Tag" -> "Node"; "Tag" -> "Interface"; "Tag" -> "Storage"; "Tag" -> "Service"; "Tag" -> "Device"; Pagina di login ==================================================================================== .. image:: ../_static/web/pages/page_login.png :width: 640px La pagina di login richiede presentat ogni volta che si tenta di accedere ad una qualunque sezione dell'interfaccia web senza prima essersi autenticati. .. note:: Le credenziali da utilizzare dipendono dal sistema di autenticazione scelto. Si rimanda alla sezione :ref:`users` per maggiori dettagli sulla gestione utenti. Homepage del tenant ==================================================================================== Appena effettuato il login il sistema rimanda l'utente alla home page del tenant di default per quell'utente. .. image:: ../_static/web/pages/page_tenant.png :width: 640px .. important:: il tenant *di default* selezionato dal sistema dopo la procedura di login dipende dalla configurazione utente. Si rimanda alla sezione: :ref:`users-groups-default-tenant`. Struttura generale della pagina -------------------------------------------------- Tutte le pagine web associate ad un tenant (e non solo) ha una struttura semi-fissa che contiene i seguenti elementi: .. image:: ../_static/web/pages/page_structure.png :width: 640px * (A) Pulsate per tornare alla homepage del Tenant corrente * (B) Form di ricerca * (C) Menu' utente * (D) Menu' configurazione del Tenant * (E) Menu' configurazione globale (Sanet) * (F) Icona stato di diagnostica e data corrente del server centrale * (G) Pulsanti per attivazione plugin-esterne (:ref:`web-external-commands`). * (H) Sezioni (tab) della pagina corrente * (I) Spalla alberi di navigazione * (L) Sezione (blocco) informativo * (M) Sezione (blocco) allarmi in corso. * (N) Sezione (blocco) dati di consultazione Ricerca ------------------------------------------------------------------------------------ La casella di ricerca permette di cercare elementi di monitoraggio. .. note:: La casella supporta autocompletamento. La stringa inserita viene confrontata con: * nome dell'elemento (o nome nodo che lo contiene) * descrizione dell'elemento (o descrizione del nodo che lo contiene) La ricerca seleziona nodi di monitoraggio anche quando viene inserito un indirizzo IP (anche parziale) che rispetta una di queste condizioni: * Indirizzo IP uguale all'ip4-mgt configurato per un certo nodo * Indirizzo IP uguale all'IP *effettivo* che Sanet e' riuscito a calcolare per un nodo al momento della ricerca. * Indirizzo IP uguale all'IP *visto* per un elemento di *discovery* e associato ad un nodo di monitoraggio. Se l'indirizzo IP inserito in ricerca e' parziale, la ricerca ipotizza che sia stata inserita una netmask. In questo caso la ricerca controlla se gli indirizzi IP dei casi elencati sopra appartengono alla netmask inserita. Ad esempio: :: 192.168. -> 192.168/16 Tutti questi criteri valgono anche per la pagina di ricerca. Vedi anche :ref:`web-page-search`. Menu ------------------------------------------------------------------------------------ Il *menu utente* permette di: * effettuare il *logoff*. * accedere alla :ref:`user-page` * Assumere l'identita' di altri utenti (solo per utenti *admin*). .. image:: ../_static/web/pages/user_menu.png :width: 640px Il menu del *tenant* permette di accedere alle diverse sezioni di configurazione/amministrazione del tenant. .. image:: ../_static/web/pages/tenant_menu.png :width: 640px Il menu di *sistema* permette di accedere alla sezione di configurazione globale di Sanet. .. image:: ../_static/web/pages/system_menu.png :width: 640px Elenchi laterali ------------------------------------------------------------------------------------ La *spalla* a sinistra dell'interfaccia permette di avere sempre a disposizione diversi elenci: * Elenco dei Tag * Elenco dei Nodi * Elenco dei Cluster Tag ~~~ .. image:: ../_static/web/pages/tags_list.png :width: 640px Si veda la sezione :ref:`web-tagging`. Nodi ~~~~ .. image:: ../_static/web/pages/nodes_list.png :width: 640px Si veda la sezione :ref:`web-node-page`. Cluster ~~~~~~~ .. image:: ../_static/web/pages/clusters_list.png :width: 640px Blocco informativo ------------------------------------------------------------------------------------ Il blocco informativo contiene informazioni specifiche in base al tipo di pagina (*nodo*, *interfaccia*). Il blocco e' *espandibile* per mostrare maggiori dettagli sulla risorsa desiderata. Nella versione *estesa* si possono consultare anche le :ref:`web-notes`. Blocco allarmi ------------------------------------------------------------------------------------ Si rimanda alla sezione sezione :ref:`web-alarms-block`. Blocco dati di consultazione ------------------------------------------------------------------------------------ La sezione di consultazione permette di visualizzare i dettagli sul monitoraggio di una risorsa. Questa sezione cambia notevolmente in base al tipo di risorsa visualizzata. .. _web-node-page: Pagina del nodo ==================================================================================== La pagina dell'interfaccia e' *strutturalmente* simile alla pagina del *tenant* con due differenze: * In alto a destra e' presente un blocco per visualizzare il timegraph *primario* associato al nodo. * La sezione dei dati di monitoraggio contiene: * L'elenco dei datagroup definiti per il nodo ed il loro stato. * L'elenco di tutte le sottorisorse monitorate ed i loro stato. .. image:: ../_static/web/pages/page_node.png :width: 640px Informazioni addizionali ------------------------ Questa sezione contiene informazioni raccolte *live* (on demand) sulle interfacce e storage presenti sul nodo. Pagina dell'interfaccia ==================================================================================== La pagina di un'interfaccia contiene informazioni specifiche di una interfaccia. E' strutturalmente simile alla :ref:`web-node-page`. Pagina dello storage ==================================================================================== La pagina di uno storage contiene informazioni specifiche dello storage. E' strutturalmente simile alla :ref:`web-node-page`. Pagina del *service* ==================================================================================== La pagina di un *service* contiene informazioni specifiche del servizio. E' strutturalmente simile alla :ref:`web-node-page`. Pagina del *device* ==================================================================================== La pagina di un *device* contiene informazioni specifiche del dispositivo. E' strutturalmente simile alla :ref:`web-node-page`. Pagina del Tag ==================================================================================== .. image:: ../_static/web/pages/page_tag.png :width: 640px Per maggiori dettagli sulla gestione del tagging si rimanda alla sezione :ref:`web-alarms-block`. .. _web-page-search: Pagina di ricerca ==================================================================================== .. image:: ../_static/web/pages/search_page.png :width: 640px La pagina di ricerca visualizza gli elementi che hanno soddisfatto la chiave di ricerca utilizzata nella form di ricerca. .. _user-page: Pagina personale ==================================================================================== La pagina personla permette di: * Visualizzare le informazioni sul profilo utilizzato in quel momento * Effettuare un cambio password locale * Cambiare impostazioni su alcune configurazioni di default che influenzano il modo con cui interagire con l'interfaccia grafica. .. image:: ../_static/web/pages/user_page.png :width: 640px Configurazione del sistema ==================================================================================== La sezione di configurazione del sistema permette di configurare globalemente Sanet. .. image:: ../_static/web/pages/page_system_configuration.png :width: 640px Configurazione del tenant ==================================================================================== La pagina di configurazione del tenant permette amministrare/configurare il monitoraggio di un *tenant*. .. image:: ../_static/web/pages/page_tenant_configuration.png :width: 640px Tabella dei nodi monitorati ------------------------------------------------------------------------------------ La sezione **Nodes** permette di accedere ad una tabella che mostra tutti i nodi presenti nel tenant e le loro informazioni. I dati contenuti nella tabella vengono paginati, questo per rendere più agevole la consultazione. Nella pagina sono presenti diversi pulsanti che permettono di intergire con la tabela, ovvero: #. un pulsante che permette di esportare i dati filtrati dalla tabella #. due pulsanti per mostrare/nascondere funzionalità di ricerca e configurazione aggiuntive della tabella #. una serie di pulsanti per interagire con la funzionalità di paginazione della tabella #. un menù a tendina che permette di cambiare il numero di nodi visualizzati in una pagina .. image:: ../_static/web/pages/tabella_nodi.png Configurazione della tabella ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Cliccando sul pulsande **Config** si accede al riquadro di configurazione della tabella. Qui è possibile mostrare/nascondere le colonne o cambiarne l'ordine. La sezione *Availeable Columns* contiene le colonne nascoste, mentre la sezione *Selected Columns* contiene le colonne visibili nell'ordine in cui sono visualizzate. Accanto a queste sezioni ci sono quattro pulsanti che permettono di modificare la visibilita' delle colonne (A) e il loro ordine (B). Quando una colonna nascosta è resa visibile, questa viene posizionata in fondo alla tabella. Se la larghezza della tabella eccede la larghezza della finestra una barra di scorrimento comparirà permettendo di scorrere soltanto la tabella mantenendo fissa la pagina. Ogni qual volta la configurazione viene cambiata viene salvata sul database in modo tale da rimanere invariata per un uso successivo della pagina. Al primo accesso viene impostata una configurazione di default con tutte le colonne visibili. .. image:: ../_static/web/pages/tabella_nodi_config.png Funzionalita' di ricerca ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Cliccando sul pulsante **Search** si accede al riquadro di ricerca della tabella. Qui è possibile filtrare i dati sui nodi in base a una chiave di ricerca o in base al loro tag di appartenenza. .. image:: ../_static/web/pages/tabella_nodi_search.png Per effettuare una ricerca scrivere un testo (almeno due caratteri) nell'apposito riquadro di input (B) e premere invio o il pulsante di ricerca. Per visualizzare di nuovo tutti i nodi disponibili dopo aver effettuato una ricerca, cancellare la chiave immessa ed effettuare una ricerca vuota. Per filtrare i nodi in base al tag di appartenenza, selezionare dal menù a tendina (A) uno dei tag disponibili. I tag vengono visualizzati con il loro path completo all'interno del tagtree. L'applicazione del filtro su un tag parent permette di visualizzare i nodi appartenenti ad esso e tutti quelli appartenenti ai tag figli. La selezione di un tag farà aggiornare automaticamente la tabella mostrando i nodi filtrati. .. image:: ../_static/web/pages/tabella_nodi_search_tags.png È possibile combinare i due metodi applicando un filtro sui tag e una chiave di ricerca. Esportazione in CSV ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Cliccando il pulsante **Export to CSV** viene aperto un dialog nel quale è possibile scegliere se esportare soltanto i dati relativi ai nodi della pagina corrente della tabella o se esportare quelli relativi a tutti i nodi che soddisfano la ricerca. .. image:: ../_static/web/pages/tabella_nodi_esporta_csv.png Pagina diagnostica ==================================================================================== Il pulsante in alto a destra di diagnostica riporta lo stato complessivo del sistema di monitoraggio. * verde: tutte le componenti sono funzionati * giallo: alcune processi/servizi di Sanet non stanno funzionando correttamente o presentano delle anomalie * rosso: sanet non funziona completamente o e' compromesso in maniera grave. Cliccando sul pulsante si puo' accedere alla pagina di diagnostica, che serve per avere informazioni dettagliate sullo stato delle diverse componenti di Sanet: * Server centrale (sanetd) * Sistema di notifica (entables) * Agenti (locali e remoti) .. image:: ../_static/web/pages/system_status_page.png :width: 640px