.. raw:: html
	<style> 
		.red    {color:red} 
		.yellow {color:yellow} 
		.green  {color:green}
	</style>



*****************************************************************************************************************************
Stato del monitoraggio
*****************************************************************************************************************************

.. contents:: Contenuti

Stati e colorazione
===================================================================================================================================================

Per mostrare lo stato del monitoraggio delle diverse entita' monitorare Sanet utilizza principalmente tre colori:

	+--------+----------------+--------------------------------------------------------------------------------------------------+
	| Colore | Definizione    | Descrizione                                                                                      |
	+========+================+==================================================================================================+
	| Rosso  | DOWN           | allarmi molto gravi (es: down completo di un nodo)                                               |
	+--------+----------------+--------------------------------------------------------------------------------------------------+
	| Giallo | FAILING        | allarmi temporanei (FAILING) o parziali.                                                         |
	+--------+----------------+--------------------------------------------------------------------------------------------------+
	| Verde  | UP             | Nessun allarme significativo da segnalare                                                        |
	+--------+----------------+--------------------------------------------------------------------------------------------------+
	| Grigio | UNCHECKABLE    | Monitoraggio non configurato o non decidibile.                                                   |
	+--------+----------------+--------------------------------------------------------------------------------------------------+

Il numero di allarmi (*condition*) e la loro gravita' puo' dipendere da:
	* livello priorita' 
	* tipologia della *condition*: normale o primaria.

.. _web-critical-minimum-level:

Livelli priorita minimo e critico
================================================================================================================================================

Esistono due soglie configurabili per decidere la gravita' di un allarme:

	* *Minimum level* : Livello di priorita' minimo
		
		Gli allarmi associati a condition con una priorita' inferiore a questa soglia vengono *ignorati* e non influenzano lo stato delle entita' di monitoraggio
		
		Se non configurato tutti gli allarmi (indipendentemente dalla loro priorita') sono considerati validi.

	* *Critical Level*: Livello di priorita' critico
		
		Gli allarmi associati a condition con una priorita' sono critici e forzano a stato DOWN (rosso) le entita' coinvolte dall'allarme.
		
		Se non configurato, nessun allarme e' considerato critico.

Il *Minimum level* e *Critical Level* si configurano indicando quale livello di prorita' (tra quelli definiti) deve essere usato come limite inferiore.

Esempio: Ipotizzando di aver definito un livello  LOW  con priorita' da 50 a 60, se si imposta come livello *minimum* il livello LOW il sistema impostera il livello *minimum* a 50.

**IMPORTANTE**: il livello *Critical Level* non puo' mai essere configurato inferiore al livello *Minimum level*.


Esempio:  Sistema con diversi livelli di priorita' configurati e quali sono il livello minimo e critico scelti.

::
	
	Scala priorita:      1.......10........20........30........40........50........60........70........80........90.......100         
	
	Livelli              <---IGNORE--------><-------LOW--------><---WARNING--------><-------ALARM------><-------FATAL------->
	
	                                        ^                                                          ^
	                                        |                                                          |
	                                        |                                                          `--- Critical Level
	                                        `--- Minimum Level


Configurazione
------------------------------------------------------------------------

WEB
~~~

Andare nella pagina di configurazione del tenant, nella sezione globale:

.. image:: ../_static/web/pages/page_tenant_config_critical_minimum_priority.png
	:width: 640px

CLI
~~~

Impostare il livello bisogna entrare in configurazione nella sezione del *tenant* e dare i seguetni comandi:

::
	
	minimum-priority-level  <level name>
	critical-priority-level <level name>

Rimuovere il livello

::
	
	no minimum-priority-level
	no critical-priority-level



.. _web-alarms-block:

Blocco Allarmi in corso
================================================================================================================================================

Il blocco degli allarmi in corso contiene informazioni sulle *condition* che sono attulamente *down*.

**NOTA**: Il blocco degli allarmi e' sempre posizionato in alto a destra all'interno della pagina.

.. image:: ../_static/web/pages/alarms.png
	:width: 640px
	

Contatori allarmi per livello di prirorita
------------------------------------------

Per ogni livello di priorita' definito, viene indicato il numero di condition **DOWN**.

**IMPORTANTE**: le condition che non hanno una priorita' associata vengono classificate con l'etichetta **N/A**.

Modalita' ridotta/espansa
---------------------------

Il blocco degli allarmi ha due modalita' di rappresentazione:

	* Ridotta: vengono visualizzati solo i contatoti delle condition down
	* Espansa: viene visualizzato **ANCHE** l'elenco puntuale delle condition.

Quando il blocco e' in modalita' *espansa* e' possibile filtrare/ordinare le condition con diverse modalita':

	* Allarmi piu' o meno recenti delle ultime 24 ore
	* Allarmi raggruppati per risorsa di monitoraggio associata all'allarme.
	* Allarmi raggruppati per livello di priorita
	* Allarmi per tipologia di risorsa (nodi, interfacce, ecc)


.. image:: ../_static/web/pages/alarms_expanded.png
	:width: 640px
	

Informazioni aggiuntive all'allarme
-----------------------------------

Per ogni allarme e' possibile espandere alcune informazioni aggiuntive usando il pulsante di *discesa*.


Impostazioni avanzate
---------------------

E' possibile impostare il blocco degli allarmi in modo tale che occupi l'intera larghezza della homepage del tenant. Con questa configurazione, il blocco rimane in modalita' espansa.
Per attivare questa impostazione aggiungere al file *conf/settings.py*:

::
	
	TENANT_HOMEPAGE_ALARMS_SECTION_PAGE_WIDE=True