9 Manutenzione
Panoramica
In Zabbix è possibile definire periodi di manutenzione per host e gruppi di host.
Inoltre, è possibile definire la manutenzione solo per un singolo trigger (o un sottoinsieme di trigger) specificando i tag del trigger. In questo caso la manutenzione verrà attivata solo per quei trigger; tutti gli altri trigger dell'host o del gruppo di host non saranno in manutenzione.
Esistono due tipi di manutenzione: con raccolta dati e senza raccolta dati.
Durante una manutenzione "con raccolta dati", i trigger vengono elaborati normalmente e gli eventi vengono creati quando necessario. Tuttavia, le escalation dei problemi vengono messe in pausa per host/trigger in manutenzione, se nell'azione è selezionata l'opzione Pause operations for suppressed problems. In questo caso, i passaggi di escalation che possono includere l'invio di notifiche o comandi remoti verranno ignorati per tutta la durata del periodo di manutenzione. Si noti che le operazioni di ripristino e aggiornamento dei problemi non vengono soppresse durante la manutenzione, ma solo le escalation.
Ad esempio, se i passaggi di escalation sono pianificati a 0, 30 e 60 minuti dall'inizio di un problema, e c'è una manutenzione di mezz'ora che dura da 10 minuti a 40 minuti dopo il verificarsi di un problema reale, il secondo e il terzo passaggio verranno eseguiti mezz'ora più tardi, cioè a 60 minuti e 90 minuti (a condizione che il problema esista ancora). Allo stesso modo, se un problema si verifica durante la manutenzione, l'escalation inizierà dopo la manutenzione.
Per ricevere normalmente le notifiche dei problemi durante la manutenzione (senza ritardi), è necessario deselezionare l'opzione Pause operations for suppressed problems nella configurazione dell'azione.
Se almeno un host (utilizzato nell'espressione del trigger) non è in modalità manutenzione, Zabbix invierà una notifica di problema.
Il server Zabbix deve essere in esecuzione durante la manutenzione. Le manutenzioni vengono ricalcolate ogni minuto oppure non appena la cache di configurazione viene ricaricata, se ci sono modifiche al periodo di manutenzione.
I processi timer verificano se lo stato dell'host deve essere cambiato da/in manutenzione allo scoccare di ogni minuto. Inoltre, ogni secondo il processo timer verifica se eventuali manutenzioni devono essere avviate/interrotte in base alla presenza di modifiche nei [periodi di manutenzione] dopo l'aggiornamento della configurazione. Pertanto, la velocità di avvio/interruzione dei periodi di manutenzione dipende dall'intervallo di aggiornamento della configurazione (10 secondi per impostazione predefinita). Si noti che le modifiche al periodo di manutenzione non includono le impostazioni Active since/Active till. Inoltre, se un host/gruppo di host viene aggiunto a un periodo di manutenzione attivo esistente, le modifiche verranno attivate dal processo timer solo all'inizio del minuto successivo.
Si noti che quando un host entra in manutenzione, i processi timer del server Zabbix leggeranno tutti i problemi aperti per verificare se è necessario sopprimerli. Ciò può avere un impatto sulle prestazioni se ci sono molti problemi aperti. Il server Zabbix leggerà inoltre tutti i problemi aperti all'avvio, anche se in quel momento non sono configurate manutenzioni.
Si noti che il server Zabbix (o proxy) raccoglie sempre i dati indipendentemente dal tipo di manutenzione (inclusa la manutenzione "senza dati"). I dati vengono successivamente ignorati dal server se è impostata l'opzione 'no data collection'.
Quando termina una manutenzione "senza dati", i trigger che utilizzano la funzione nodata() non si attiveranno prima del controllo successivo nel periodo che stanno verificando.
Se un item di log viene aggiunto mentre un host è in manutenzione e la manutenzione termina, verranno raccolte solo le nuove voci del file di log dalla fine della manutenzione.
Se viene inviato un valore con timestamp per un host che si trova in una manutenzione di tipo “senza dati” (ad esempio usando Zabbix sender), tale valore verrà scartato; tuttavia è possibile inviare un valore con timestamp relativo a un periodo di manutenzione scaduto e questo verrà accettato.
Se il periodo di manutenzione, gli host, i gruppi o i tag vengono modificati dall'utente, le modifiche avranno effetto solo dopo la sincronizzazione della cache di configurazione.
Configurazione
Per configurare un periodo di manutenzione:
- Vai a: Raccolta dati > Manutenzione.
- Fai clic su Crea periodo di manutenzione (oppure sul nome di un periodo di manutenzione esistente).
- Inserisci i parametri di manutenzione nel modulo.
Tutti i campi di input obbligatori sono contrassegnati da un asterisco rosso.
| Parametro | Descrizione |
|---|---|
| Name | Nome del periodo di manutenzione. |
| Maintenance type | È possibile impostare due tipi di manutenzione: Con raccolta dati - i dati verranno raccolti dal server durante la manutenzione, i trigger verranno elaborati; Senza raccolta dati - i dati non verranno raccolti dal server durante la manutenzione. Vedi Effetto dei periodi di manutenzione per sapere come ciascun tipo influisce sul report di disponibilità. |
| Active since | La data e l'ora a partire dalle quali l'esecuzione dei periodi di manutenzione diventa attiva. Nota: impostare solo questa ora non attiva un periodo di manutenzione; i periodi di manutenzione devono essere configurati in Periods (vedi sotto). |
| Active till | La data e l'ora fino alle quali l'esecuzione dei periodi di manutenzione rimane attiva. |
| Periods | Questo blocco consente di definire i giorni e gli orari esatti in cui si svolge la manutenzione. Facendo clic su  si apre una finestra popup con un modulo flessibile Maintenance period in cui è possibile definire la pianificazione della manutenzione. Vedi Periodi di manutenzione per una descrizione dettagliata. |
| Host groups | Seleziona i gruppi di host per i quali verrà attivata la manutenzione. La manutenzione verrà attivata per tutti gli host dei gruppi di host specificati. Questo campo supporta il completamento automatico, quindi iniziando a digitare verrà visualizzato un menu a discesa con tutti i gruppi di host disponibili. Specificare un gruppo di host padre seleziona implicitamente tutti i gruppi di host nidificati. Pertanto, la manutenzione verrà attivata anche sugli host dei gruppi nidificati. |
| Hosts | Seleziona gli host per i quali verrà attivata la manutenzione. Questo campo supporta il completamento automatico, quindi iniziando a digitare verrà visualizzato un menu a discesa con tutti gli host disponibili. |
| Tags | Specifica i tag per sopprimere i problemi con tag corrispondenti sugli host in manutenzione. È possibile impostare diverse condizioni. La corrispondenza del nome del tag distingue sempre tra maiuscole e minuscole. Sono disponibili due operatori per ciascuna condizione: Contiene - include i nomi di tag specificati in cui i valori dei tag contengono la stringa inserita (corrispondenza per sottostringa, distinzione tra maiuscole e minuscole); Uguale a - include i nomi e i valori dei tag specificati (distinzione tra maiuscole e minuscole). Sono disponibili 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. I tag possono essere specificati solo se è selezionata la modalità Con raccolta dati. |
| Description | Descrizione del periodo di manutenzione. |
Periodi di manutenzione
La finestra del periodo di manutenzione serve per pianificare il tempo per una manutenzione ricorrente o una tantum. Il modulo è dinamico e i campi disponibili cambiano in base al Tipo di periodo selezionato.
| Tipo di periodo | Descrizione |
|---|---|
| Solo una volta | Configura un periodo di manutenzione una tantum: Data - data e ora del periodo di manutenzione; Durata del periodo di manutenzione - per quanto tempo la manutenzione sarà attiva. |
| Giornaliero | Configura un periodo di manutenzione giornaliero: Ogni giorno/i - frequenza della manutenzione (1 - (predefinito) ogni giorno, 2 - ogni due giorni, ecc.); Alle (ora:minuto) - ora del giorno in cui inizia la manutenzione; Durata del periodo di manutenzione - per quanto tempo la manutenzione sarà attiva. Quando il parametro Ogni giorno/i è maggiore di "1", il giorno iniziale è il giorno in cui ricade l'ora Attivo da. Esempi: - se Attivo da è impostato su "2021-01-01 12:00", Ogni giorno/i è impostato su "2" e Alle (ora:minuto) è impostato su "23:00", allora il primo periodo di manutenzione inizierà il 1° gennaio alle 23:00, mentre il secondo periodo di manutenzione inizierà il 3 gennaio alle 23:00; - se Attivo da è impostato su "2021-01-01 12:00", Ogni giorno/i è impostato su "2" e Alle (ora:minuto) è impostato su "01:00", allora il primo periodo di manutenzione inizierà il 3 gennaio alle 01:00, mentre il secondo periodo di manutenzione inizierà il 5 gennaio alle 01:00. |
| Settimanale | Configura un periodo di manutenzione settimanale: Ogni settimana/e - frequenza della manutenzione (1 - (predefinito) ogni settimana, 2 - ogni due settimane, ecc.); Giorno della settimana - in quale giorno deve avere luogo la manutenzione; Alle (ora:minuto) - ora del giorno in cui inizia la manutenzione; Durata del periodo di manutenzione - per quanto tempo la manutenzione sarà attiva. Quando il parametro Ogni settimana/e è maggiore di "1", la settimana iniziale è la settimana in cui ricade l'ora Attivo da. Per esempi, vedere la descrizione del parametro Giornaliero sopra. |
| Mensile | Configura un periodo di manutenzione mensile: Mese - selezionare tutti i mesi durante i quali viene eseguita la manutenzione regolare; Data: Giorno del mese - selezionare questa opzione se la manutenzione deve avere luogo nella stessa data di ogni mese (ad esempio, ogni 1° giorno del mese), quindi selezionare il giorno richiesto nel campo Giorno del mese che appare; Data: Giorno della settimana - selezionare questa opzione se la manutenzione deve avere luogo solo in determinati giorni (ad esempio, ogni primo lunedì del mese), quindi selezionare (nell'elenco a discesa) la settimana del mese richiesta (prima, seconda, terza, quarta o ultima), quindi contrassegnare le caselle di controllo per il/i giorno/i di manutenzione; Alle (ora:minuto) - ora del giorno in cui inizia la manutenzione; Durata del periodo di manutenzione - per quanto tempo la manutenzione sarà attiva. |
Quando si crea un periodo di manutenzione, viene utilizzato il fuso orario dell'utente che lo crea. Tuttavia, quando vengono pianificati periodi di manutenzione ricorrenti (Giornalieri, Settimanali, Mensili), viene utilizzato il fuso orario del server Zabbix. Per garantire un comportamento prevedibile dei periodi di manutenzione ricorrenti, è necessario utilizzare un fuso orario comune per tutte le parti di Zabbix.
Una volta fatto, premere Aggiungi per aggiungere il periodo di manutenzione al blocco Periodi.
Si noti che i cambiamenti dell'ora legale (DST) non influiscono sulla durata della manutenzione. Ad esempio, supponiamo di avere una manutenzione di due ore configurata che di solito inizia alle 01:00 e termina alle 03:00:
- se dopo un'ora di manutenzione (alle 02:00) avviene un cambio dell'ora legale e l'ora corrente passa dalle 02:00 alle 03:00, la manutenzione continuerà per un'altra ora (fino alle 04:00);
- se dopo due ore di manutenzione (alle 03:00) avviene un cambio dell'ora legale e l'ora corrente passa dalle 03:00 alle 02:00, la manutenzione si interromperà, perché sono trascorse due ore;
- se un periodo di manutenzione inizia durante l'ora che viene saltata a causa di un cambio dell'ora legale, la manutenzione non verrà avviata.
Se un periodo di manutenzione è impostato su "1 giorno" (il periodo effettivo della manutenzione è di 24 ore, poiché Zabbix calcola i giorni in ore), inizia alle 00:00 e termina alle 00:00 del giorno successivo:
- la manutenzione terminerà alle 01:00 del giorno successivo se l'ora corrente viene spostata avanti di un'ora;
- la manutenzione terminerà alle 23:00 di quel giorno se l'ora corrente viene spostata indietro di un'ora.
Visualizzazione
Visualizzazione degli host in manutenzione
Un'icona a forma di chiave inglese arancione 
accanto al nome dell'host indica che questo host è in manutenzione in:
- Dashboard
- Monitoring > Problems
- Inventory > Hosts > Host inventory details
- Data collection > Hosts (vedere la colonna 'Status')
I dettagli della manutenzione vengono visualizzati quando il puntatore del mouse viene posizionato sull'icona.
Inoltre, gli host in manutenzione hanno uno sfondo arancione in Monitoring > Maps.
Visualizzazione dei problemi soppressi
Normalmente i problemi per gli host in manutenzione sono soppressi, cioè non vengono visualizzati nel frontend. Tuttavia, è anche possibile configurare la visualizzazione dei problemi soppressi selezionando l'opzione Mostra problemi soppressi nelle seguenti posizioni:
- Dashboard (nella configurazione dei widget Host con problemi, Problemi, Problemi per gravità, Panoramica trigger)
- Monitoraggio > Problemi (nel filtro)
- Monitoraggio > Mappe (nella configurazione della mappa)
- Notifiche globali (nella configurazione del profilo utente)
Quando i problemi soppressi vengono visualizzati, viene mostrata la seguente icona: 
.
Passando il mouse sopra l'icona vengono visualizzati ulteriori dettagli.
Calcolo delle code durante la manutenzione
Le code visualizzate nel frontend di Zabbix (Administration > Queue) sono calcolate dal server Zabbix. Non includono gli item in manutenzione senza raccolta dati: per questi item la lunghezza della coda è sempre zero, anche quando i loro valori sono in ritardo. Gli item in ritardo in manutenzione con raccolta dati vengono comunque conteggiati nella coda.
Il proxy Zabbix non è a conoscenza dei periodi di manutenzione perché non esiste sincronizzazione della configurazione di manutenzione tra il server Zabbix e il proxy.
I controlli interni calcolati sui proxy Zabbix (ad esempio, zabbix[queue,,] e zabbix[stats,,,queue,,]) segnalano gli item in ritardo indipendentemente dallo stato di manutenzione sul server Zabbix.
Di conseguenza, il frontend di Zabbix e i controlli interni sui proxy Zabbix possono riportare lunghezze della coda diverse per gli stessi item in manutenzione senza raccolta dati.