9 Mantenimiento
Descripción general
El mantenimiento se utiliza para suprimir problemas durante períodos de tiempo predefinidos.
Puede definir períodos de mantenimiento para hosts y grupos de hosts en Zabbix.
Además, es posible definir mantenimiento solo para un único trigger (o un subconjunto de triggers) especificando etiquetas de trigger. En este caso, el mantenimiento se activará solo para esos triggers; todos los demás triggers del host o del grupo de hosts no estarán en mantenimiento.
Hay dos tipos de mantenimiento: Con recopilación de datos y Sin recopilación de datos.
Durante el mantenimiento Con recopilación de datos, los triggers se procesan como de costumbre y los eventos se crean cuando es necesario. Sin embargo, si la opción Pausar operaciones para problemas suprimidos está marcada en la configuración de acciones, las escaladas de problemas se pausarán para los hosts/triggers en mantenimiento. En este caso, los pasos de escalada que pueden incluir el envío de notificaciones o comandos remotos se ignorarán mientras dure el período de mantenimiento. Tenga en cuenta que las operaciones de recuperación y actualización de problemas no se suprimen durante el mantenimiento, solo las escaladas. Las notificaciones de recuperación no se envían si el problema comenzó durante el mantenimiento.
Por ejemplo, si los pasos de escalada están programados a los 0, 30 y 60 minutos después del inicio de un problema, y hay un mantenimiento de media hora que dura desde los 10 hasta los 40 minutos después de que surge un problema real, los pasos dos y tres se ejecutarán media hora más tarde, es decir, a los 60 y 90 minutos (siempre que el problema siga existiendo). Del mismo modo, si un problema surge durante el mantenimiento, la escalada comenzará después del mantenimiento.
Para recibir notificaciones de problemas durante el mantenimiento de forma normal (sin retraso), debe desmarcar la opción Pausar operaciones para problemas suprimidos en la configuración de acciones.
Si al menos un host (utilizado en la expresión del trigger) no está en modo de mantenimiento, Zabbix enviará una notificación de problema.
El server de Zabbix debe estar en ejecución durante el mantenimiento. Los mantenimientos se recalculan cada minuto o tan pronto como se recarga la caché de configuración si hay cambios en el período de mantenimiento.
Los procesos timer comprueban si el estado del host debe cambiar a/desde mantenimiento en el segundo 0 de cada minuto. Además, cada segundo el proceso timer comprueba si debe iniciarse/detenerse algún mantenimiento en función de si hay cambios en los [períodos de mantenimiento] después de la actualización de la configuración. Por lo tanto, la velocidad de inicio/detención de los períodos de mantenimiento depende del intervalo de actualización de la configuración (10 segundos de forma predeterminada). Tenga en cuenta que los cambios en el período de mantenimiento no incluyen la configuración Activo desde/Activo hasta. Además, si se añade un host/grupo de hosts a un período de mantenimiento activo existente, los cambios solo serán activados por el proceso timer al comienzo del siguiente minuto.
Tenga en cuenta que cuando un host entra en mantenimiento, los procesos timer del server de Zabbix leerán todos los problemas abiertos para comprobar si es necesario suprimirlos. Esto puede afectar al rendimiento si hay muchos problemas abiertos. El server de Zabbix también leerá todos los problemas abiertos al iniciarse, incluso si en ese momento no hay mantenimientos configurados.
Tenga en cuenta que el server de Zabbix (o proxy) siempre recopila datos independientemente del tipo de mantenimiento (incluido el mantenimiento Sin recopilación de datos). Posteriormente, el server ignorará los datos si está configurado Sin recopilación de datos.
Cuando finaliza el mantenimiento Sin recopilación de datos, los triggers que utilizan la función nodata() no se activarán antes de la siguiente comprobación dentro del período que están comprobando.
Si se añade un item de log mientras un host está en mantenimiento y el mantenimiento finaliza, solo se recopilarán las nuevas entradas del archivo de log desde el final del mantenimiento.
Si se envía un valor con marca de tiempo para un host que está en mantenimiento Sin recopilación de datos (por ejemplo, usando Zabbix sender), este valor se descartará; sin embargo, es posible enviar un valor con marca de tiempo para un período de mantenimiento ya expirado, y será aceptado.
Si el usuario cambia el período de mantenimiento, los hosts, los grupos o las etiquetas, los cambios solo surtirán efecto después de la sincronización de la caché de configuración.
Configuración
Para configurar un período de mantenimiento:
- Vaya a: Recopilación de datos > Mantenimiento.
- Haga clic en Crear período de mantenimiento (o en el nombre de un período de mantenimiento existente).
- Introduzca los parámetros de mantenimiento en el formulario.

Todos los campos de entrada obligatorios están marcados con un asterisco rojo.
| Parámetro | Descripción |
|---|---|
| Name | Nombre del período de mantenimiento. |
| Maintenance type | Se pueden establecer dos tipos de mantenimiento: With data collection: el server recopila datos durante el mantenimiento y los triggers se procesan; No data collection: los datos aún pueden recopilarse, pero no se guardan en la base de datos durante el mantenimiento, y los triggers (incluida la función nodata()) no se activan. Consulte Efecto de los períodos de mantenimiento para saber cómo afecta cada tipo al informe de disponibilidad. |
| Active since | La fecha y hora a partir de las cuales la ejecución de los períodos de mantenimiento pasa a estar activa. Nota: Configurar solo esta hora no activa un período de mantenimiento; los períodos de mantenimiento deben configurarse en Periods (véase más abajo). |
| Active till | La fecha y hora en la que la ejecución de los períodos de mantenimiento deja de estar activa. |
| Periods | Este bloque le permite definir los días y horas exactos en los que tiene lugar el mantenimiento. Al hacer clic en se abre una ventana emergente con un formulario flexible de Maintenance period en el que puede definir la programación del mantenimiento. Consulte Períodos de mantenimiento para ver una descripción detallada. |
| Host groups | Seleccione los grupos de hosts para los que se activará el mantenimiento. El mantenimiento se activará para todos los hosts de los grupos de hosts especificados. Este campo tiene autocompletado, por lo que al empezar a escribir en él se mostrará una lista desplegable con todos los grupos de hosts disponibles. Al especificar un grupo de hosts padre, se seleccionan implícitamente todos los grupos de hosts anidados. Por lo tanto, el mantenimiento también se activará en los hosts de los grupos anidados. |
| Hosts | Seleccione los hosts para los que se activará el mantenimiento. Este campo tiene autocompletado, por lo que al empezar a escribir en él se mostrará una lista desplegable con todos los hosts disponibles. |
| Tags | Especifique etiquetas para suprimir problemas con etiquetas coincidentes en los hosts en mantenimiento. Se pueden establecer varias condiciones. La coincidencia del nombre de la etiqueta siempre distingue entre mayúsculas y minúsculas. Hay dos operadores disponibles para cada condición: Contains: incluir los nombres de etiqueta especificados cuando los valores de etiqueta contengan la cadena introducida (coincidencia de subcadena, distingue entre mayúsculas y minúsculas); Equals: incluir los nombres y valores de etiqueta especificados (distingue entre mayúsculas y minúsculas). Hay dos tipos de cálculo para las condiciones: And/Or: deben cumplirse todas las condiciones; las condiciones que tengan el mismo nombre de etiqueta se agruparán mediante la condición Or; Or: basta con que se cumpla una condición. Las etiquetas solo pueden especificarse si está seleccionado el tipo de mantenimiento With data collection. |
| Description | Descripción del período de mantenimiento. |
Períodos de mantenimiento
La ventana de período de mantenimiento es para programar tiempo para un mantenimiento recurrente o único. El formulario es dinámico y los campos disponibles cambian según el Tipo de período seleccionado.

| Tipo de período | Descripción |
|---|---|
| Solo una vez | Configurar un período de mantenimiento único: Fecha - fecha y hora del período de mantenimiento; Duración del período de mantenimiento - durante cuánto tiempo estará activo el mantenimiento. |
| Diario | Configurar un período de mantenimiento diario: Cada día(s) - frecuencia del mantenimiento (1 - (por defecto) cada día, 2 - cada dos días, etc.); A las (hora:minuto) - hora del día en que comienza el mantenimiento; Duración del período de mantenimiento - durante cuánto tiempo estará activo el mantenimiento. Cuando el parámetro Cada día(s) es mayor que "1", el día de inicio es el día en que cae la hora Activo desde. Ejemplos: - si Activo desde está configurado en "2021-01-01 12:00", Cada día(s) está configurado en "2" y A las (hora:minuto) está configurado en "23:00", entonces el primer período de mantenimiento comenzará el 1 de enero a las 23:00, mientras que el segundo período de mantenimiento comenzará el 3 de enero a las 23:00; - si Activo desde está configurado en "2021-01-01 12:00", Cada día(s) está configurado en "2" y A las (hora:minuto) está configurado en "01:00", entonces el primer período de mantenimiento comenzará el 3 de enero a la 01:00, mientras que el segundo período de mantenimiento comenzará el 5 de enero a la 01:00. |
| Semanal | Configurar un período de mantenimiento semanal: Cada semana(s) - frecuencia del mantenimiento (1 - (por defecto) cada semana, 2 - cada dos semanas, etc.); Día de la semana - en qué día debe realizarse el mantenimiento; A las (hora:minuto) - hora del día en que comienza el mantenimiento; Duración del período de mantenimiento - durante cuánto tiempo estará activo el mantenimiento. Cuando el parámetro Cada semana(s) es mayor que "1", la semana de inicio es la semana en la que cae la hora Activo desde. Para ejemplos, consulte la descripción del parámetro Diario arriba. |
| Mensual | Configurar un período de mantenimiento mensual: Mes - seleccione todos los meses durante los cuales se realiza el mantenimiento regular; Fecha: Día del mes - seleccione esta opción si el mantenimiento debe realizarse el mismo día de cada mes (por ejemplo, el primer día de cada mes), y luego seleccione el día requerido en el campo Día del mes que aparece; Fecha: Día de la semana - seleccione esta opción si el mantenimiento debe realizarse solo en ciertos días (por ejemplo, cada primer lunes del mes), luego seleccione (en el desplegable) la semana requerida del mes (primera, segunda, tercera, cuarta o última), y luego marque las casillas de verificación para el/los día(s) de mantenimiento; A las (hora:minuto) - hora del día en que comienza el mantenimiento; Duración del período de mantenimiento - durante cuánto tiempo estará activo el mantenimiento. |
Al crear un período de mantenimiento, se utiliza la zona horaria del usuario que lo crea. Sin embargo, cuando se programan períodos de mantenimiento recurrentes (Diario, Semanal, Mensual), se utiliza la zona horaria del servidor Zabbix. Para garantizar un comportamiento predecible de los períodos de mantenimiento recurrentes, se requiere utilizar una zona horaria común para todas las partes de Zabbix.
Cuando haya terminado, pulse Añadir para agregar el periodo de mantenimiento al bloque Periodos.
Tenga en cuenta que los cambios de horario de verano (DST) no afectan a la duración del mantenimiento. Por ejemplo, supongamos que tenemos un mantenimiento de dos horas configurado que normalmente comienza a las 01:00 y termina a las 03:00:
- si después de una hora de mantenimiento (a las 02:00) ocurre un cambio de horario de verano y la hora actual cambia de 02:00 a 03:00, el mantenimiento continuará durante una hora más (hasta las 04:00);
- si después de dos horas de mantenimiento (a las 03:00) ocurre un cambio de horario de verano y la hora actual cambia de 03:00 a 02:00, el mantenimiento se detendrá, porque han pasado dos horas;
- si un periodo de mantenimiento comienza durante la hora que se omite por un cambio de horario de verano, entonces el mantenimiento no comenzará.
Si un periodo de mantenimiento se establece en "1 día" (el periodo real del mantenimiento es de 24 horas, ya que Zabbix calcula los días en horas), comienza a las 00:00 y termina a las 00:00 del día siguiente:
- el mantenimiento se detendrá a las 01:00 del día siguiente si la hora actual avanza una hora;
- el mantenimiento se detendrá a las 23:00 de ese día si la hora actual retrocede una hora.
Visualización
Mostrar equipos en mantenimiento
Un icono de llave inglesa naranja
junto al nombre del equipo indica que este equipo está en mantenimiento en:
- Tableros
- Supervisión > Problemas
- Inventario > Equipos > Detalles del inventario del equipo
- Recopilación de datos > Equipos (ver columna 'Estado')
![]()
Los detalles del mantenimiento se muestran cuando el puntero del ratón se posiciona sobre el icono.
Además, los equipos en mantenimiento obtienen un fondo naranja en Supervisión > Mapas.
Mostrar problemas suprimidos
Normalmente, los problemas de los equipos en mantenimiento se suprimen, es decir, no se muestran en la interfaz. Sin embargo, también es posible configurar que se muestren los problemas suprimidos, seleccionando la opción Mostrar problemas suprimidos en las siguientes ubicaciones:
- Tableros (en la configuración de los widgets Equipos con problemas, Problemas, Problemas por severidad, Resumen de disparadores)
- Supervisión > Problemas (en el filtro)
- Supervisión > Mapas (en la configuración del mapa)
- Notificaciones globales (en la configuración del perfil de usuario)
Cuando se muestran los problemas suprimidos, se muestra el siguiente icono:
.
Al pasar el ratón sobre el icono se muestran más detalles.

Cálculo de las colas durante el mantenimiento
Las colas mostradas en el frontend de Zabbix (Administration > Queue) son calculadas por el server de Zabbix. No incluyen los items en mantenimiento de Sin recopilación de datos, y la longitud de la cola siempre es cero para estos items, incluso cuando sus valores están retrasados. Los items retrasados en mantenimiento de Con recopilación de datos siguen contándose en la cola.
El proxy de Zabbix no conoce los períodos de mantenimiento porque no hay sincronización de la configuración de mantenimiento entre el server de Zabbix y el proxy.
Las comprobaciones internas calculadas en los proxies de Zabbix (por ejemplo, zabbix[queue,,] y zabbix[stats,,,queue,,]) informan de los items retrasados independientemente del estado de mantenimiento en el server de Zabbix.
Como resultado, el frontend de Zabbix y las comprobaciones internas en los proxies de Zabbix pueden informar longitudes de cola diferentes para los mismos items en mantenimiento de Sin recopilación de datos.
se abre una ventana emergente con un formulario flexible de Maintenance period en el que puede definir la programación del mantenimiento. Consulte