9 Manutenzione
Panoramica
La manutenzione viene utilizzata per sopprimere i problemi durante periodi di tempo predefiniti.
In Zabbix è possibile definire periodi di manutenzione per host e gruppi di host.
Inoltre, è possibile definire la manutenzione solo per un singolo trigger (o per 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: With data collection e No data collection.
Durante la manutenzione With data collection, i trigger vengono elaborati come di consueto e gli eventi vengono creati quando necessario. Tuttavia, se l'opzione Pause operations for suppressed problems è selezionata nella configurazione dell'action, le escalation dei problemi vengono messe in pausa per gli host/trigger in manutenzione. 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 il ripristino del problema e le operazioni di aggiornamento non vengono soppressi durante la manutenzione, ma solo le escalation. Le notifiche di ripristino non vengono inviate se il problema è iniziato durante la manutenzione.
Ad esempio, se i passaggi di escalation sono pianificati a 0, 30 e 60 minuti dopo l'inizio di un problema, e c'è una manutenzione di mezz'ora che va da 10 minuti a 40 minuti dopo l'insorgere di un problema reale, i passaggi due e tre verranno eseguiti mezz'ora più tardi, cioè a 60 e 90 minuti (a condizione che il problema esista ancora). Allo stesso modo, se un problema insorge durante la manutenzione, l'escalation inizierà dopo la manutenzione.
Per ricevere normalmente le notifiche dei problemi durante la manutenzione (senza ritardo), è necessario deselezionare l'opzione Pause operations for suppressed problems nella configurazione dell'action.
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 modificato da/verso la manutenzione a 0 secondi di ogni minuto. Inoltre, ogni secondo il processo timer verifica se eventuali manutenzioni devono essere avviate/interrotte in base alla presenza di modifiche ai [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. Questo può avere un impatto sulle prestazioni se ci sono molti problemi aperti. Il server Zabbix leggerà anche tutti i problemi aperti all'avvio, anche se al momento non sono configurate manutenzioni.
Si noti che il server Zabbix (o il proxy) raccoglie sempre i dati indipendentemente dal tipo di manutenzione (inclusa la manutenzione No data collection). I dati vengono successivamente ignorati dal server se è impostato No data collection.
Quando termina la manutenzione No data collection, i trigger che usano la funzione nodata() non si attiveranno prima del controllo successivo durante il periodo in cui stanno effettuando il controllo.
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 successive alla fine della manutenzione.
Se viene inviato un valore con timestamp per un host che si trova in manutenzione No data collection (ad esempio usando Zabbix sender), questo valore verrà scartato; tuttavia è possibile inviare un valore con timestamp per un periodo di manutenzione scaduto, e 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: Data collection > Maintenance.
- Fai clic su Create maintenance period (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.
| Parameter | Description |
|---|---|
| Name | Nome del periodo di manutenzione. |
| Maintenance type | È possibile impostare due tipi di manutenzione: With data collection - i dati vengono raccolti dal server durante la manutenzione e i trigger vengono elaborati; No data collection - i dati possono comunque essere raccolti, ma durante la manutenzione non vengono salvati nel database e i trigger (inclusa la funzione nodata()) non si attivano.Vedi Effect of maintenance periods per sapere come ciascun tipo influisce sul report di disponibilità. |
| Active since | La data e l'ora in cui l'esecuzione dei periodi di manutenzione diventa attiva. Nota: impostare solo questo orario non attiva un periodo di manutenzione; i periodi di manutenzione devono essere configurati in Periods (vedi sotto). |
| Active till | La data e l'ora in cui l'esecuzione dei periodi di manutenzione smette di essere attiva. |
| Periods | Questo blocco consente di definire i giorni e le ore esatti in cui avviene 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 Maintenance periods per una descrizione dettagliata. |
| Host groups | Seleziona i gruppi di host per i quali la manutenzione verrà attivata. La manutenzione verrà attivata per tutti gli host dei gruppi di host specificati. Questo campo supporta l'autocompletamento, 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 la manutenzione verrà attivata. Questo campo supporta l'autocompletamento, quindi iniziando a digitare verrà visualizzato un menu a discesa con tutti gli host disponibili. |
| Tags | Specifica i tag per suppress problems con tag corrispondenti sugli host in manutenzione. È possibile impostare più condizioni. La corrispondenza del nome del tag fa sempre distinzione tra maiuscole e minuscole. Per ogni condizione sono disponibili due operatori: Contains - include i nomi dei tag specificati in cui i valori del tag contengono la stringa inserita (corrispondenza di sottostringa, con distinzione tra maiuscole e minuscole); Equals - include i nomi e i valori dei tag specificati (con 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 una condizione sia soddisfatta. I tag possono essere specificati solo se è selezionato il tipo di manutenzione With data collection. |
| 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.
Quando hai terminato, fai clic su Add per aggiungere il periodo di manutenzione al blocco Periods.
Nota che le modifiche dell'ora legale (DST) non influiscono sulla durata della manutenzione. Ad esempio, supponiamo di avere una manutenzione configurata di due ore che di solito inizia alle 01:00 e termina alle 03:00:
- se dopo un'ora di manutenzione (alle 02:00) avviene un cambio DST e l'ora corrente passa da 02:00 a 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 DST e l'ora corrente passa da 03:00 a 02:00, la manutenzione si fermerà, perché sono trascorse due ore;
- se un periodo di manutenzione inizia durante l'ora che viene saltata da un cambio DST, la manutenzione non inizierà.
Se un periodo di manutenzione è impostato su "1 day" (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 si fermerà alle 01:00 del giorno successivo se l'ora corrente avanza di un'ora;
- la manutenzione si fermerà alle 23:00 di quel giorno se l'ora corrente torna 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 vengono soppressi, cioè non visualizzati nel frontend. Tuttavia, è anche possibile configurare la visualizzazione dei problemi soppressi selezionando l'opzione Mostra problemi soppressi in queste 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 sull'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 No data collection e, per questi item, la lunghezza della coda è sempre zero, anche quando i loro valori sono in ritardo. Gli item in ritardo nella manutenzione With data collection vengono comunque conteggiati nella coda.
Il proxy di Zabbix non è a conoscenza dei periodi di manutenzione perché non esiste alcuna 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 con No data collection.
si apre una finestra popup con un modulo flessibile Maintenance period in cui è possibile definire la pianificazione della manutenzione. Vedi