11 维护
概述
维护用于在预定义的时间段内抑制问题。
您可以在 Zabbix 中为主机和主机组定义维护时段。
此外,还可以通过指定触发器标签,仅为单个触发器(或部分触发器)定义维护。 在这种情况下,维护将只对这些触发器生效;主机或主机组中的所有其他触发器将不会处于维护中。
维护有两种类型:采集数据 和 不采集数据。
在 采集数据 维护期间,触发器会像往常一样处理,并在需要时创建事件。 但是,如果在action configuration中选中了 Pause operations for suppressed problems 选项,则处于维护中的主机/触发器的问题升级将被暂停。 在这种情况下,只要维护期持续,可能包括发送通知或远程命令的升级步骤都将被忽略。 请注意,在维护期间,问题恢复和更新操作不会被抑制,只有升级会被抑制。 如果问题是在维护期间开始的,则不会发送恢复通知。
例如,如果升级步骤计划在问题开始后的 0、30 和 60 分钟执行,而在真实问题出现后的第 10 分钟到第 40 分钟之间有一个持续半小时的维护,那么第二步和第三步将延后半小时执行,即在第 60 分钟和第 90 分钟执行(前提是问题仍然存在)。 同样,如果问题是在维护期间出现的,则升级将在维护结束后开始。
如果您希望在维护期间正常接收问题通知(不延迟),则必须在动作配置中取消选中 Pause operations for suppressed problems 选项。
如果至少有一台主机(在触发器表达式中使用)不处于维护模式,Zabbix 将发送问题通知。
Zabbix 服务器在维护期间必须处于运行状态。 维护会每分钟重新计算一次;如果维护时段发生变化,则在配置缓存重新加载后也会立即重新计算。
timer 进程会在每分钟的第 0 秒检查是否必须将主机状态切换为维护/非维护。 此外,在配置更新后,timer 进程还会每秒检查是否有任何维护需要根据[维护时段]启动/停止。 因此,维护时段启动/停止的速度取决于配置更新间隔(默认 10 秒)。 请注意,维护时段的更改不包括 Active since/Active till 设置。 另外,如果将主机/主机组添加到现有的活动维护时段中,这些更改只会在下一分钟开始时由 timer 进程激活。
请注意,当主机进入维护时,Zabbix 服务器 timer 进程将读取所有未关闭的问题,以检查是否需要抑制这些问题。 如果存在大量未关闭的问题,这可能会对性能产生影响。 Zabbix 服务器在启动时也会读取所有未关闭的问题,即使当时没有配置任何维护。
请注意,无论维护类型如何(包括 不采集数据 维护),Zabbix 服务器(或 proxy)始终都会采集数据。 如果设置为 不采集数据,这些数据随后将被服务器忽略。
当 不采集数据 维护结束时,使用 nodata() 函数的触发器在其检查周期内、下一次检查发生之前不会触发。
如果在主机处于维护期间时添加了一个日志监控项,并且维护结束,则只会采集自维护结束以来的新日志文件条目。
如果为处于 不采集数据 维护中的主机发送带时间戳的值(例如使用Zabbix sender),则该值将被丢弃;但是,可以为已过期的维护时段发送带时间戳的值,并且该值会被接受。
如果用户更改了维护时段、主机、组或标签,则这些更改只有在配置缓存同步后才会生效。
配置
要配置维护周期:
- 转到:Data collection > Maintenance。
- 单击 Create maintenance period(或现有维护周期的名称)。
- 在表单中输入维护参数。

所有必填输入字段都用红色星号标记。
| Parameter | Description |
|---|---|
| Name | 维护周期的名称。 |
| Maintenance type | 可设置两种维护类型: With data collection - 在维护期间由服务器收集数据,并处理触发器; No data collection - 数据仍可能被收集,但在维护期间不会保存到数据库中,并且触发器(包括 nodata() 函数)不会触发。有关每种类型如何影响可用性报告,请参见维护周期的影响。 |
| Active since | 执行维护周期开始生效的日期和时间。 注意: 仅设置此时间不会激活维护周期;必须在 Periods 中配置维护周期(见下文)。 |
| Active till | 执行维护周期停止生效的日期和时间。 |
| Periods | 此部分允许您定义维护发生的具体日期和小时。单击 会打开一个弹出窗口,其中包含灵活的 Maintenance period 表单,您可以在其中定义维护计划。有关详细说明,请参见维护周期。 |
| Host groups | 选择要为其激活维护的主机组。维护将对指定主机组中的所有主机生效。此字段支持自动补全,因此开始输入时会显示所有可用主机组的下拉列表。 指定父主机组会隐式选择所有嵌套主机组。因此,维护也将对嵌套组中的主机生效。 |
| Hosts | 选择要为其激活维护的主机。此字段支持自动补全,因此开始输入时会显示所有可用主机的下拉列表。 |
| Tags | 指定标签,以便对维护中的主机上匹配标签的问题进行抑制。 可以设置多个条件。标签名称匹配始终区分大小写。 每个条件有两种可用运算符: Contains - 包含指定的标签名称,其中标签值包含输入的字符串(子串匹配,区分大小写); Equals - 包含指定的标签名称和值(区分大小写)。 条件有两种计算类型: And/Or - 必须满足所有条件,具有相同标签名称的条件将按 Or 条件分组; Or - 满足任一条件即可。 仅当选择 With data collection 维护类型时,才能指定标签。 |
| Description | 维护周期的描述。 |
维护时段
维护时段窗口用于为周期性或一次性维护安排时间。 该表单是动态的,可用字段会根据所选的 时段类型 发生变化。

| 时段类型 | 说明 |
|---|---|
| 仅一次 | 配置一次性维护时段: 日期 - 维护时段的日期和时间; 维护时段长度 - 维护将保持活动状态的时长。 |
| 每日 | 配置每日维护时段: 每隔 N 天 - 维护频率(1 - (默认) 每天,2 - 每两天一次,依此类推); 在(时:分) - 维护开始的当天时间; 维护时段长度 - 维护将保持活动状态的时长。 当 每隔 N 天 参数大于“1”时,起始日为 活动自 时间所在的那一天。示例: - 如果 活动自 设置为“2021-01-01 12:00”,每隔 N 天 设置为“2”,且 在(时:分) 设置为“23:00”,则第一个维护时段将于 1 月 1 日 23:00 开始,第二个维护时段将于 1 月 3 日 23:00 开始; - 如果 活动自 设置为“2021-01-01 12:00”,每隔 N 天 设置为“2”,且 在(时:分) 设置为“01:00”,则第一个维护时段将于 1 月 3 日 01:00 开始,第二个维护时段将于 1 月 5 日 01:00 开始。 |
| 每周 | 配置每周维护时段: 每隔 N 周 - 维护频率(1 - (默认) 每周,2 - 每两周一次,依此类推); 星期几 - 维护应在哪一天进行; 在(时:分) - 维护开始的当天时间; 维护时段长度 - 维护将保持活动状态的时长。 当 每隔 N 周 参数大于“1”时,起始周为 活动自 时间所在的那一周。示例请参见上文 每日 参数说明。 |
| 每月 | 配置每月维护时段: 月份 - 选择执行定期维护的所有月份; 日期:每月第几天 - 如果维护应在每月相同日期进行(例如每月 1 日),请选择此选项,然后在出现的 每月第几天 字段中选择所需日期; 日期:星期几 - 如果维护应仅在某些特定日期进行(例如每月第一个星期一),请选择此选项,然后在下拉列表中选择所需的月份中的周次(第一、第二、第三、第四或最后一周),再勾选维护日; 在(时:分) - 维护开始的当天时间; 维护时段长度 - 维护将保持活动状态的时长。 |
在创建维护期时,使用创建者的时区。 然而,当选定维护周期(每天、每周、每月)时,会使用使用 Zabbix Server的时区。 为确保重复维护期内的可预测行为,需要在为Zabbix 的所有部分分配使用统一的时区设置。
完成后,点击 Add,将维护周期添加到 Periods 区块中。
请注意,夏令时(DST)变更不会影响维护持续的时长。
例如,假设我们配置了一个持续两小时的维护,通常从 01:00 开始,到 03:00 结束:
- 如果在维护进行一小时后(02:00)发生 DST 变更,当前时间从 02:00 变为 03:00,则维护还会继续一小时(直到 04:00);
- 如果在维护进行两小时后(03:00)发生 DST 变更,当前时间从 03:00 变为 02:00,则维护将停止,因为两小时已经过去;
- 如果维护周期开始于 DST 变更中被跳过的那个小时,则维护不会开始。
如果维护周期设置为“1 day”(维护的实际周期为 24 小时,因为 Zabbix 按小时计算天数),并且从 00:00 开始,到次日 00:00 结束:
- 如果当前时间向前调整一小时,则维护会在次日 01:00 停止;
- 如果当前时间向后调整一小时,则维护会在当天 23:00 停止。
展示
在维护中显示主机
主机名称旁边的橙色扳手图标
表示该主机在以下位置处于维护中:
- 仪表板
- 监控 > 问题
- 资产记录 > 主机 > 主机资产记录详情
- 数据采集 > 主机(参见“状态”列)
![]()
将鼠标指针悬停在该图标上时,会显示维护详情。
此外,处于维护中的主机在 监控 > 拓扑图 中会显示为橙色背景。
显示被抑制的问题
通常,处于维护中的主机的问题会被抑制,也就是说不会在前端中显示。
不过,也可以通过在以下位置选择 显示被抑制的问题 选项来配置显示这些被抑制的问题:
- 仪表板(在 问题主机、问题、按严重性划分的问题、触发器概览 小部件配置中)
- 监控 > 问题(在过滤器中)
- 监控 > 地图(在地图配置中)
- 全局 通知(在用户配置文件配置中)
当显示被抑制的问题时,会显示以下图标:
。
将鼠标悬停在该图标上会显示更多详细信息。

维护期间队列的计算
Zabbix 前端(管理 > 队列)中显示的队列由 Zabbix 服务器计算。 其中不包括处于 不收集数据 维护状态的监控项,即使这些监控项的值已延迟,其队列长度也始终为零。 处于 收集数据 维护状态的延迟监控项仍会被计入队列。
Zabbix proxy 并不知道维护时间段,因为 Zabbix 服务器与 proxy 之间不会同步维护配置。
在 Zabbix proxy 上计算的内部检查(例如,zabbix[queue,,] 和 zabbix[stats,,,queue,,])会报告延迟的监控项,而不考虑 Zabbix 服务器上的维护状态。
因此,对于处于 不收集数据 维护状态的同一批监控项,Zabbix 前端与 Zabbix proxy 上的内部检查可能会报告不同的队列长度。
会打开一个弹出窗口,其中包含灵活的 Maintenance period 表单,您可以在其中定义维护计划。有关详细说明,请参见