[comment]: # ({9eea6187-e92d6298})
# 1 监控配置同步

[comment]: # ({/9eea6187-e92d6298})

[comment]: # ({e92356a4-49859c37})

### 概览

本页面提供有关Proxy监控配置更新的详细信息，即Server上对监控配置进行的更改如何同步到Proxy。

[comment]: # ({/e92356a4-49859c37})

[comment]: # ({bb4b4fe9-0a1602c8})

### 增量更新

Proxy配置更新是增量的。在配置同步期间，只会更新修改过的实体（因此，如果没有实体被修改，将不会发送任何数据）。这种方法可以节省资源，并且可以设置更小的间隔（几乎是即时的）用于Proxy配置更新。

Proxy配置更改使用修订号进行跟踪。仅当实体的修订号大于Proxy配置修订号时，才会将其包含在发送给Proxy的配置数据中。

配置同步的实体如下：

| 实体 | 详细信息 |
| -- | -------- |
| *autoregistration tls data* | 所有自动注册 TLS 数据。 |
| *expressions* | 所有表达式（正则表达式、表达式列表）。 |
| *global configuration* | 存储在 'config' 表中的全局配置。 |
| *host* | 主机的所有属性、接口、资产、监控项、监控项预处理、监控项参数、网页场景。 |
| *host macros* | 主机上定义的所有宏以及与之关联的所有模板 ID。 |
| *proxy discovery rule* | 分配给Proxy的发现规则和检查。 |

这意味着：

- 如果在一个 **主机** 上更改了一个监控项，该主机的所有配置都将被同步。
- 如果更改了一个 **正则表达式**，所有正则表达式将被同步。

例外情况是主机宏，即使主机上的任何内容都已更改，也会发送它们。

在Proxy上使用 `-R config_cache_reload` 命令也会启动增量更新。

请注意，在Proxy启动/重新启动、HA 故障转移、会话令牌更改或Proxy上的配置更新失败（例如，在接收配置数据时连接中断）时，将进行完整的配置同步。

[comment]: # ({/bb4b4fe9-0a1602c8})

[comment]: # ({7b2e0cba-7636f8f7})

### 配置参数

**ProxyConfigFrequency** 参数决定Proxy配置与Server同步的频率（默认为 10 秒）。

请注意，ProxyConfigFrequency 是：

- 被动Proxy的server参数
- 主动Proxy的server参数

对于主动Proxy来说，ProxyConfigFrequency 是自 Zabbix 6.4 版本后的新参数，必须代替现已弃用的 ConfigFrequency 参数使用。

::: noteimportant
如果同时使用 ProxyConfigFrequency 和 ConfigFrequency，代理将记录错误并终止。
:::

[comment]: # ({/7b2e0cba-7636f8f7})

[comment]: # ({de7d29ed-0e2ceffb})
#### 维护期间队列的计算

::: noteimportant
Zabbix proxy 不会感知维护期；详情请参见[维护期间队列的计算](/manual/maintenance#calculation-of-queues-during-maintenance)。
:::

[comment]: # ({/de7d29ed-0e2ceffb})