[comment]: # attributes: notoc [comment]: # ({4963afdf-4963afdf}) # 6 Zabbix agent 2 (Windows) [comment]: # ({/4963afdf-4963afdf}) [comment]: # ({00c81087-9fe069f9}) ### 概述 Zabbix agent 2 是 Zabbix agent 的新一代版本，可用于替代 Zabbix agent。 本节列出了 Windows Zabbix agent 2 配置文件（zabbix\_agent2.conf）支持的参数。 参数仅列出，不提供额外信息。 单击参数可查看完整详情。 |Parameter|Description| |--|--------| |[Alias](#alias)|为监控项键设置别名。| |[AllowKey](#allowkey)|允许执行与模式匹配的监控项键。| |[BufferSend](#buffersend)|缓冲区中的数据保留时间不超过 N 秒。| |[BufferSize](#buffersize)|内存缓冲区中的最大值数量。| |[ControlSocket](#controlsocket)|控制套接字，用于通过 '-R' 选项发送运行时命令。| |[DebugLevel](#debuglevel)|调试级别。| |[DenyKey](#denykey)|拒绝执行与模式匹配的监控项键。| |[EnablePersistentBuffer](#enablepersistentbuffer)|启用对主动监控项使用本地持久化存储。| |[ForceActiveChecksOnStart](#forceactivechecksonstart)|在重启后收到的第一个配置生效时立即执行主动检查。| |[HeartbeatFrequency](#heartbeatfrequency)|心跳消息的发送频率，单位为秒。| |[HostInterface](#hostinterface)|定义主机接口的可选参数。| |[HostInterfaceItem](#hostinterfaceitem)|定义用于获取主机接口的监控项的可选参数。| |[HostMetadata](#hostmetadata)|定义主机元数据的可选参数。| |[HostMetadataItem](#hostmetadataitem)|定义用于获取主机元数据的 Zabbix agent 监控项的可选参数。| |[Hostname](#hostname)|定义主机名的可选参数。| |[HostnameItem](#hostnameitem)|定义用于获取主机名的 Zabbix agent 监控项的可选参数。| |[Include](#include)|您可以在配置文件中包含单个文件或目录中的所有文件。| |[ListenIP](#listenip)|以逗号分隔的 IP 地址列表，agent 应监听这些地址。| |[ListenPort](#listenport)|agent 将在此端口上监听来自服务器的连接。| |[LogFile](#logfile)|日志文件名。| |[LogFileSize](#logfilesize)|日志文件的最大大小。| |[LogType](#logtype)|日志输出类型。| |[PersistentBufferFile](#persistentbufferfile)|Zabbix agent 2 应将 SQLite 数据库存放在此文件中。| |[PersistentBufferPeriod](#persistentbufferperiod)|当无法连接到服务器或 proxy 时，数据应被存储的时间段。| |[Plugins..System.Capacity](#plugins.systemcapacity)|每个插件可同时执行的检查数量限制。| |[Plugins.Log.MaxLinesPerSecond](#plugins.log.maxlinespersecond)|在处理 'log' 和 'logrt' 主动检查时，agent 每秒向 Zabbix 服务器或 proxy 发送的新行最大数量。| |[Plugins.SystemRun.LogRemoteCommands](#plugins.systemrun.logremotecommands)|将已执行的 shell 命令记录为警告。| |[PluginSocket](#pluginsocket)|用于可加载插件通信的 Windows 命名管道路径。| |[PluginTimeout](#plugintimeout)|与可加载插件连接的超时时间，单位为秒。| |[PerfCounter](#perfcounter)|定义一个新参数 ，其值为指定时间段 （秒）内系统性能计数器 的平均值。| |[PerfCounterEn](#perfcounteren)|定义一个新参数 ，其值为指定时间段 （秒）内系统性能计数器 的平均值。与 PerfCounter 相比，perfcounter 路径必须使用英文。| |[RefreshActiveChecks](#refreshactivechecks)|刷新主动检查列表的频率。| |[Server](#server)|以逗号分隔的 IP 地址列表，可选使用 CIDR 表示法，或 Zabbix 服务器和 Zabbix proxy 的 DNS 名称。| |[ServerActive](#serveractive)|用于获取主动检查的 Zabbix 服务器/proxy 地址或集群配置。| |[SourceIP](#sourceip)|源 IP 地址。| |[StatusPort](#statusport)|如果设置，agent 将在此端口上监听 HTTP 状态请求（http://localhost:/status）。| |[Timeout](#timeout)|指定与 Zabbix proxy 或服务器建立连接并交换数据时的等待时间（秒）。| |[TLSAccept](#tlsaccept)|接受哪些传入连接。| |[TLSCAFile](#tlscafile)|包含用于对等证书验证的顶级 CA 证书的文件完整路径名，用于 Zabbix 组件之间的加密通信。| |[TLSCertFile](#tlscertfile)|包含 agent 证书或证书链的文件完整路径名，用于 Zabbix 组件之间的加密通信。| |[TLSCipherAll13](#tlscipherall13)|OpenSSL 密码字符串（TLS 1.3）。覆盖基于证书和 PSK 加密的默认密码套件选择标准。| |[TLSCipherCert13](#tlsciphercert13)|OpenSSL 密码字符串（TLS 1.3）。覆盖基于证书加密的默认密码套件选择标准。| |[TLSCipherPSK13](#tlscipherpsk13)|OpenSSL 密码字符串（TLS 1.3）。覆盖基于 PSK 加密的默认密码套件选择标准。| |[TLSConnect](#tlsconnect)|agent 应如何连接到 Zabbix 服务器或 proxy。| |[TLSCRLFile](#tlscrlfile)|包含已吊销证书的文件完整路径名。此参数用于 Zabbix 组件之间的加密通信。| |[TLSKeyFile](#tlskeyfile)|包含 agent 私钥的文件完整路径名，用于 Zabbix 组件之间的加密通信。| |[TLSPSKFile](#tlspskfile)|包含 agent 预共享密钥的文件完整路径名，用于与 Zabbix 服务器的加密通信。| |[TLSPSKIdentity](#tlspskidentity)|预共享密钥标识字符串，用于与 Zabbix 服务器的加密通信。| |[TLSServerCertIssuer](#tlsservercertissuer)|允许的服务器（proxy）证书颁发者。| |[TLSServerCertSubject](#tlsservercertsubject)|允许的服务器（proxy）证书主题。| |[UnsafeUserParameters](#unsafeuserparameters)|允许将所有字符作为参数传递给用户自定义参数。| |[UserParameter](#userparameter)|要监控的用户自定义参数。| |[UserParameterDir](#userparameterdir)|UserParameter 命令的默认搜索路径。| 除非明确说明该参数为必填，否则所有参数均为非必填。 注意： - 默认值反映的是进程默认值，而不是随产品提供的配置文件中的值； - Zabbix 仅支持 UTF-8 编码且不带 [BOM](https://en.wikipedia.org/wiki/Byte_order_mark) 的配置文件； - 以 "\#" 开头的注释仅支持在行首。
[comment]: # ({/00c81087-9fe069f9}) [comment]: # ({8085875f-324d4c30}) ### 参数详情 [comment]: # ({/8085875f-324d4c30}) [comment]: # ({0e8f6372-fa6993fd}) ##### Alias 为监控项键设置alias别名。 可用于将复杂冗长的监控项键替换为更简洁的键名。
允许存在多个*alias*参数。 禁止为同一*alias*键名设置多个参数。
不同的*alias*键可以引用相同的监控项键。
别名可用于*HostMetadataItem*参数，但不能用于*HostnameItem*参数。 示例1：从服务器获取分页file使用百分比。 ```default Alias=pg_usage:perf_counter[\Paging File(_Total)\% Usage] ``` 现在可以使用简写键**pg_usage**来获取数据。 示例2：使用默认和自定义参数获取CPU负载。 ```default Alias=cpu.load:system.cpu.load Alias=cpu.load[*]:system.cpu.load[*] ``` 这样既可以使用**cpu.load**键get默认参数的CPU负载，也可以使用**cpu.load[percpu,avg15]**来getCPU负载的特定数据。 示例3：运行多个处理相同发现监控项的[low-level discovery](/manual/discovery/low_level_discovery)规则。 ```default Alias=vfs.fs.discovery[*]:vfs.fs.discovery ``` 现在可以为**vfs.fs.discovery**设置多个使用不同参数的发现规则，例如**vfs.fs.discovery[foo]**、**vfs.fs.discovery[bar]**等。 [comment]: # ({/0e8f6372-fa6993fd}) [comment]: # ({3ed0c834-e05b8a23}) ##### AllowKey 允许执行那些匹配特定模式的监控项键值。 键名模式为支持"\*"通配符的表达式，可匹配任意数量的任意字符。
可通过与DenyKey组合定义多个键名匹配规则。 系统将按照参数出现的顺序逐一处理这些规则。 另请参阅：[Restricting agent checks](/manual/config/items/restrict_checks)。 [comment]: # ({/3ed0c834-e05b8a23}) [comment]: # ({fc56d912-5d573779}) ##### BufferSend 该时间间隔（以秒为单位）决定了数值从缓冲区发送到Zabbix server的频率。
请注意，如果缓冲区已满，数据将会提前发送。 默认值：`5`
范围：1-3600 [comment]: # ({/fc56d912-5d573779}) [comment]: # ({bd027b5f-adbf2018}) ##### BufferSize memory缓冲区中值的最大数量。 当缓冲区满时，agent会将所有收集的数据发送到Zabbix server或proxy。
此参数仅在禁用持久缓冲区时使用（*EnablePersistentBuffer=0*）。 默认值：`1000`
范围：2-65535 [comment]: # ({/bd027b5f-adbf2018}) [comment]: # ({78069119-dee4d084}) ##### ControlSocket 控制套接字，用于通过'-R'选项发送运行时命令。 默认值：`\\.\pipe\agent.sock` [comment]: # ({/78069119-dee4d084}) [comment]: # ({9c071f70-74594585}) ##### DebugLevel 指定调试级别：
*0* - 关于Zabbix进程启动和停止的基本信息
*1* - 关键信息
*2* - 错误信息
*3* - 警告信息
*4* - 调试信息（产生大量输出）
*5* - 扩展调试信息（产生更多输出） 默认值：`3`
范围：0-5 [comment]: # ({/9c071f70-74594585}) [comment]: # ({26eddabd-ad027e43}) ##### DenyKey 拒绝执行那些匹配特定模式的监控项键值。 键名模式是支持使用"*"字符匹配任意数量任意字符的通配符表达式。
可通过与AllowKey组合定义多个键名匹配规则。 系统将按照参数出现的顺序逐一处理这些规则。 另请参阅：[Restricting agent checks](/manual/config/items/restrict_checks)。 [comment]: # ({/26eddabd-ad027e43}) [comment]: # ({ae3ff74a-d9d538db}) ##### EnablePersistentBuffer 启用本地持久化存储以支持主动式监控项。 若禁用持久化存储，将使用memory缓冲区。 默认值：`0`
可选值：0 - 禁用，1 - 启用 [comment]: # ({/ae3ff74a-d9d538db}) [comment]: # ({da2ce1bd-1970c2c5}) ##### ForceActiveChecksOnStart 在重启后立即对首次接收到的配置执行主动检查。 也可作为每个插件的配置参数使用，例如：`Plugins.Uptime.System.ForceActiveChecksOnStart=1` 默认值：`0`
取值：0 - 禁用，1 - 启用 [comment]: # ({/da2ce1bd-1970c2c5}) [comment]: # ({70ff69c8-bce527af}) ##### HeartbeatFrequency 心跳消息的频率（以秒为单位）。 用于监控主动检查的可用性。
0 - 禁用心跳消息。 默认值：`60`
范围：0-3600 [comment]: # ({/70ff69c8-bce527af}) [comment]: # ({cd35abda-9d3624af}) ##### HostInterface 一个可选参数，用于定义在主机 [自动注册](/manual/discovery/auto_registration) 过程中使用的主机接口（IP 地址或 DNS 名称）。 该值将用于填充新创建主机中的接口，并允许显式配置 IP 或 DNS 地址。 更多详情，请参见 [将 DNS 用作默认接口](/manual/discovery/auto_registration#using-dns-as-default-interface)。 如果未定义，该值将从 HostInterfaceItem 获取。 如果该值超过 255 个字符的限制，agent 将报错并且不会启动。 范围：0-255 个字符 [comment]: # ({/cd35abda-9d3624af}) [comment]: # ({dc29c465-7378e07f}) ##### HostInterfaceItem 一个可选参数，用于定义在主机 [自动注册](/manual/discovery/auto_registration) 过程中确定主机接口（IP 地址或 DNS 名称）所使用的监控项。 仅当未定义 HostInterface 时，才会使用此值。 有关更多详细信息，请参见 [将 DNS 用作默认接口](/manual/discovery/auto_registration#using-dns-as-default-interface)。 在自动注册请求期间，如果指定监控项返回的值超过 255 个字符的限制，agent 将记录一条警告消息。 无论 AllowKey/DenyKey 设置如何，都会支持 [system.run[]](/manual/config/items/itemtypes/zabbix_agent#system.run) 监控项。 [comment]: # ({/dc29c465-7378e07f}) [comment]: # ({ed067cab-3b42353f}) ##### HostMetadata 一个可选参数，用于定义在主机[autoregistration](/manual/discovery/auto_registration)过程中用于识别或区分主机的[metadata](/manual/discovery/auto_registration#using-host-metadata)（主动agent）。 HostMetadata允许通过主机名之外的方式区分主机。 如果未定义，该值将从HostMetadataItem获取。 当指定值超过2034字节限制或使用非UTF-8string时，agent将问题错误且不会启动。 当参数需要IP地址或DNS名称时，有效UTF-8编码但不符合IP或DNS命名规范的值也将被拒绝并报告为无效。 不支持多行元数据——输出将在第一个换行符处截断。 范围：0-2034字节 [comment]: # ({/ed067cab-3b42353f}) [comment]: # ({1ef8844f-eff97518}) ##### HostMetadataItem 一个可选参数，用于定义获取[host metadata](/manual/discovery/auto_registration#using-host-metadata)时使用的Zabbix agent监控项。 该选项仅在未定义HostMetadata时使用。 HostMetadataItem值会在每次[autoregistration](/manual/discovery/auto_registration)尝试时获取，并仅用于主机自动注册过程（主动式agent）。 HostMetadataItem允许通过主机名之外的主机进行区分。 支持用户参数和别名。 无论AllowKey/DenyKey设置如何，都支持[system.run[]](/manual/config/监控项/itemtypes/zabbix_agent#system.run)监控项。 在自动注册请求期间，如果指定监控项返回的值超过65535个UTF-8码点限制，agent将记录警告消息。 监控项返回的值必须是UTF-8string，否则将被忽略。 当参数需要IP地址或DNS名称时，虽然是有效的UTF-8但不符合IP或DNS名称格式的值也将被拒绝并报告为无效。 不支持多行元数据——输出将在第一个换行符处截断。 [comment]: # ({/1ef8844f-eff97518}) [comment]: # ({39406dda-542b591a}) ##### Hostname 以逗号分隔的唯一主机名列表（区分大小写）。 主动检查所必需，且必须与服务器上配置的主机名相匹配。 若未定义，该值将从HostnameItem获取。
允许字符：字母数字、'.'、' '、'\_'及'-'。 最大长度：每个主机名128字符，整行2048字符。 默认值：由HostnameItem设置 [comment]: # ({/39406dda-542b591a}) [comment]: # ({77a62307-085b8ddc}) ##### HostnameItem 一个可选参数，用于定义获取主机名称时使用的监控项。 该选项仅在未定义主机名时使用。 不支持用户参数或别名，但无论AllowKey/DenyKey值如何，都支持[system.run[]](/manual/config/监控项/itemtypes/zabbix_agent#system.run) 监控项。 默认值：`system.hostname` [comment]: # ({/77a62307-085b8ddc}) [comment]: # ({183802f3-d06cc342}) ##### Include 您可以在配置文件file中包含单个文件或目录中的所有文件（如果Zabbix agent通过Windows MSI安装包安装，默认位于`C:\Program Files\Zabbix Agent 2`；如果Zabbix agent以zip压缩包形式安装，则位于安装时指定的文件夹）。 所有被包含的文件必须具有 正确的语法，否则agent将无法启动。 路径可以是相对于*zabbix_agent2.conf*配置文件file的位置（例如， `Include=.\zabbix_agent2.d\plugins.d\*.conf`）。
若仅包含指定目录中的相关文件，支持使用星号通配符进行模式匹配。
关于限制条件，请参阅[special notes](special_notes_include)。 示例： ```default Include=C:\Program Files\Zabbix Agent2\zabbix_agent2.d\*.conf ``` [comment]: # ({/183802f3-d06cc342}) [comment]: # ({43e741ee-21abf7b1}) ##### ListenIP 一个逗号分隔的IP地址列表，agent应监听这些地址。 第一个IP地址会被发送到Zabbix server（如果连接到它）以获取活动检查的列表。 默认值：`0.0.0.0` [comment]: # ({/43e741ee-21abf7b1}) [comment]: # ({5f95bc53-2f2c8140}) ##### ListenPort agent将在此端口监听来自服务器的连接。 默认值：`10050`
范围：1024-32767 [comment]: # ({/5f95bc53-2f2c8140}) [comment]: # ({d3241aab-988826b6}) ##### LogFile file日志的agent名称. 默认值: `c:\zabbix_agent2.log`
必填: 是，当LogType设置为*file*时；否则为否 [comment]: # ({/d3241aab-988826b6}) [comment]: # ({f7604f8f-ae05fc8d}) ##### LogFileSize 日志file的最大大小，单位为MB。
0 - 禁用自动日志轮转。
*注意*：如果日志file大小达到限制且file轮转失败（无论何种原因），现有日志file将被截断并重新开始记录。 默认值：`1`
范围：0-1024 [comment]: # ({/f7604f8f-ae05fc8d}) [comment]: # ({4226072e-e8dc6df9}) ##### LogType 日志输出类型:
*file* - 将日志写入LogFile参数指定的file;
*console* - 将日志写入标准输出. 默认值: `file` [comment]: # ({/4226072e-e8dc6df9}) [comment]: # ({357a4f09-dde3e6b9}) ##### PersistentBufferFile file 应保留 SQLite 数据库的 Zabbix agent 2 必须是一个完整的文件名。 此参数仅在启用持久缓冲区时使用（*EnablePersistentBuffer=1*）。 [comment]: # ({/357a4f09-dde3e6b9}) [comment]: # ({2937cc76-379dc265}) ##### PersistentBufferPeriod 当与server 或 proxy无连接时数据应存储的时间段. 较早的数据将被丢弃. 日志数据将被保留. 此参数仅在启用持久缓冲区时生效(*EnablePersistentBuffer=1*). 默认值: `1h`
范围: 1m-365d [comment]: # ({/2937cc76-379dc265}) [comment]: # ({9b0fb2d6-a2a522ee}) ##### Plugins..System.Capacity {#plugins.systemcapacity} 每个``插件可以同时执行的检查数量限制. 默认值: `1000` 范围: 1-1000 [comment]: # ({/9b0fb2d6-a2a522ee}) [comment]: # ({99218c04-c6daef84}) ##### Plugins.Log.MaxLinesPerSecond 当处理'日志'、'logrt'和'eventlog'主动检查时，agent每秒向Zabbix server或proxy发送的最大新行数。 提供的值将被'日志'、'logrt'或'eventlog' 监控项键中的'maxlines'参数覆盖。
*注意*: Zabbix将处理比*MaxLinesPerSecond*设置多10倍的新行数，以在日志监控项中查找所需的string。 默认值: `20`
范围: 1-1000 [comment]: # ({/99218c04-c6daef84}) [comment]: # ({487e5b60-d7133c6e}) ##### Plugins.SystemRun.LogRemoteCommands 启用已执行shell命令的日志记录为警告级别。 该日志记录仅在远程执行命令时生效。 若system.run\[\]通过HostMetadataItem、HostInterfaceItem或HostnameItem参数在本地启动，则不会生成日志条目。 默认值：`0`
可选值：0 - 禁用，1 - 启用 [comment]: # ({/487e5b60-d7133c6e}) [comment]: # ({e879decb-c712bfb8}) ##### PluginSocket 用于可加载插件通信的 Windows 命名管道路径。 默认值：`\\.\pipe\agent.plugin.sock` [comment]: # ({/e879decb-c712bfb8}) [comment]: # ({14afe8ce-1db534a6}) ##### PluginTimeout 可加载插件连接超时时间（秒） 默认值：`Timeout`
范围：1-30 [comment]: # ({/14afe8ce-1db534a6}) [comment]: # ({444f6259-69cf2ccd}) ##### PerfCounter 定义一个新参数，该参数表示系统性能计数器在指定时间段（以秒为单位）内的平均值。
语法：,"", 例如，如果您希望获取过去一分钟内处理器每秒中断次数的平均值，可以按如下方式定义一个名为"interrupts"的新参数：
```default PerfCounter = interrupts,"\Processor(0)\Interrupts/sec",60 ``` 请注意性能计数器路径两侧的双引号。 参数名称(interrupts)在创建监控项时应作为监控项键使用。 系统将每秒采集一次样本用于计算平均值。
您可以使用run "typeperf -qx"命令来get Windows中所有可用的性能计数器列表。 [comment]: # ({/444f6259-69cf2ccd}) [comment]: # ({c2cc7bf4-e983c97e}) ##### PerfCounterEn 定义一个新参数，该参数表示系统性能计数器在指定时间段（以秒为单位）内的平均值。 与PerfCounter相比，perfcounter路径必须使用英文。 仅支持**Windows Server 2008/Vista**及更高版本。
语法：,"", 例如，如果您希望获取过去一分钟内处理器每秒中断次数的平均值，可以按以下方式定义名为"interrupts"的新参数：
```default PerfCounterEn = interrupts,"\Processor(0)\Interrupts/sec",60 ``` 请注意性能计数器路径两侧的双引号。 参数名(interrupts)将作为创建监控项时的监控项键使用。 系统将每秒采集一次样本用于计算平均值。
您可以通过查看以下注册表项获取英文字符串列表：`HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Perflib\009`。 [comment]: # ({/c2cc7bf4-e983c97e}) [comment]: # ({3d47a4c2-25e3871b}) ##### RefreshActiveChecks 主动检查列表的刷新频率，以秒为单位。 请注意，若主动检查刷新失败，下一次刷新尝试将在60秒后进行。 默认值：`5`
范围：1-86400 [comment]: # ({/3d47a4c2-25e3871b}) [comment]: # ({bb2bfe8d-0ad80cbc}) ##### Server 一个以逗号分隔的IP地址列表（可选CIDR表示法）或Zabbix servers和Zabbix proxies的DNS名称。 仅接受来自此处列出的主机的传入连接。 如果启用了IPv6支持，则'127.0.0.1'、'::127.0.0.1'、'::ffff:127.0.0.1'将被同等对待，而'::/0'将允许任何IPv4或IPv6地址。 '0.0.0.0/0'可用于允许任何IPv4地址。 允许包含空格。 如果未指定此参数，将禁用被动检查且agent不会监听任何TCP端口。 示例： ```default Server=127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com ``` [comment]: # ({/bb2bfe8d-0ad80cbc}) [comment]: # ({56b8410d-0d31e03a}) ##### ServerActive 用于获取主动检查的 Zabbix 服务器/proxy 地址或集群配置。 服务器/proxy 地址是 IP 地址或 DNS 名称，后跟可选端口，二者用冒号分隔。
集群配置是一个或多个服务器或 proxy 组成员地址，地址之间用分号分隔。 可以指定多个 Zabbix 服务器/集群和 Zabbix proxy，彼此之间用逗号分隔。 除非使用 proxy 组，否则每个 Zabbix 服务器/集群不应指定多个 Zabbix proxy。 如果指定了某个 Zabbix proxy，则不应再为该 proxy 指定对应的 Zabbix 服务器/集群。
可以提供多个以逗号分隔的地址，以便并行使用多个独立的 Zabbix 服务器。 允许包含空格。
如果未指定端口，则使用默认端口。
如果为该主机指定了端口，则 IPv6 地址必须用方括号括起来。 如果未指定端口，则 IPv6 地址的方括号可选。
如果未指定此参数，则会禁用主动检查。 Zabbix proxy 示例： ```default ServerActive=127.0.0.1:10051 ``` Zabbix proxy 组示例： ServerActive=proxy1.example.com;proxy2.example.com;proxy3.example.com;proxy4.example.com;proxy5.example.com 多个服务器示例： ```default ServerActive=127.0.0.1:20051,zabbix.domain,\[::1\]:30051,::1,\[12fc::1\] ``` 高可用示例： ```default ServerActive=zabbix.cluster.node1;zabbix.cluster.node2:20051;zabbix.cluster.node3 ``` 包含两个集群和一台服务器的高可用示例： ```default ServerActive=zabbix.cluster.node1;zabbix.cluster.node2:20051,zabbix.cluster2.node1;zabbix.cluster2.node2,zabbix.domain ``` [comment]: # ({/56b8410d-0d31e03a}) [comment]: # ({76194937-f96761ad}) ##### SourceIP 源IP地址用于： - 与Zabbix server或Zabbix proxy建立的出站连接； - 执行某些监控项时建立的连接（web.page.get、net.tcp.port等）。 [comment]: # ({/76194937-f96761ad}) [comment]: # ({7d3f343b-8b9a658a}) ##### StatusPort 若设置此参数，agent将监听该端口以处理HTTP状态请求（http://localhost:<端口>/status）。 取值范围：1024-32767 [comment]: # ({/7d3f343b-8b9a658a}) [comment]: # ({37e987ac-baa42b03}) ##### Timeout 指定与Zabbix proxy或服务器建立连接及交换数据的等待时间（秒）。
该参数定义各类通信操作的最长持续时间，包括： - 等待Zabbix server响应； - 向Zabbix server发送请求，包括[主动检查](/manual/appendix/items/activepassive#主动检查)中的监控项配置请求和监控项数据； - 通过日志文件或Windows事件日志监控获取日志数据； - 发送心跳消息； - `vfs.*`检查的最大持续时间； - 作为version 7.0以下版本的server 或 proxy发送无超时检查时的后备方案。 该超时设置**不**适用于在前端（全局、proxy或单个监控项级别）可配置超时时间的agent检查项。 默认值：`3`
取值范围：1-30 [comment]: # ({/37e987ac-baa42b03}) [comment]: # ({2200adc7-5fffe23e}) ##### TLSAccept 接受的传入连接类型。 用于被动检查。 可指定多个值，以逗号分隔：
*unencrypted* - 接受未加密的连接（默认）
*psk* - 接受使用TLS及预共享密钥(PSK)的连接
*cert* - 接受使用TLS及证书的连接 必填项：若定义了TLS证书或PSK参数则为必填（即使针对*unencrypted*连接）；否则非必填 [comment]: # ({/2200adc7-5fffe23e}) [comment]: # ({65d07bda-01a58fb9}) ##### TLSCAFile 包含用于对等证书验证的Top级别CA证书的file完整路径名，用于Zabbix组件之间的加密通信。 [comment]: # ({/65d07bda-01a58fb9}) [comment]: # ({005f60f1-64ff2b38}) ##### TLSCertFile 包含用于与Zabbix组件进行加密通信的agent证书或证书链的file完整路径名。 [comment]: # ({/005f60f1-64ff2b38}) [comment]: # ({a467b58d-fd228a11}) ##### TLSCipherAll13 OpenSSL加密套件string（TLS 1.3版本）。 覆盖基于证书和PSK加密的默认密码套件选择标准。 示例： ```default TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256 ``` 该参数从Zabbix 7.0.4版本开始支持。 [comment]: # ({/a467b58d-fd228a11}) [comment]: # ({8e8a68b3-2900b2ec}) ##### TLSCipherCert13 OpenSSL加密套件string（TLS 1.3版本）。 覆盖基于证书加密的默认加密套件选择标准。 注意：该参数不能与`TLSAccept=cert,psk`同时使用；对于证书连接（`TLSConnect=cert`）请改用TLSCipherAll13。 该参数自Zabbix 7.0.4版本起支持。 [comment]: # ({/8e8a68b3-2900b2ec}) [comment]: # ({6cb7784a-e8316817}) ##### TLSCipherPSK13 OpenSSL加密套件string（TLS 1.3版本）。 覆盖基于PSK加密的默认密码套件选择标准。 示例： ```default TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256 ``` 该参数自Zabbix 7.0.4版本起支持。 [comment]: # ({/6cb7784a-e8316817}) [comment]: # ({e2ebc18f-0c14341a}) ##### TLSConnect agent应如何连接到Zabbix server或proxy. 用于主动检查. 仅可指定一个值:
*unencrypted* - 不加密连接(默认)
*psk* - 使用TLS和预共享密钥(PSK)连接
*cert* - 使用TLS和证书连接 必填项: 如果定义了TLS证书或PSK参数则为是(即使使用*unencrypted*连接); 否则为否 [comment]: # ({/e2ebc18f-0c14341a}) [comment]: # ({ad4dc889-353fa6b2}) ##### TLSCRLFile 包含已撤销证书的file完整路径名。 该参数用于Zabbix组件之间的加密通信。 [comment]: # ({/ad4dc889-353fa6b2}) [comment]: # ({c2aa4315-40db7da5}) ##### TLSKeyFile 包含用于Zabbix组件间加密通信的agent私钥的file完整路径名。 [comment]: # ({/c2aa4315-40db7da5}) [comment]: # ({11defa44-216346d5}) ##### TLSPSKFile 包含用于与Zabbix server进行加密通信的agent预共享密钥的file完整路径名. [comment]: # ({/11defa44-216346d5}) [comment]: # ({92d3eff0-d9d037af}) ##### TLSPSKIdentity 预共享密钥标识string，用于与Zabbix server进行加密通信。 [comment]: # ({/92d3eff0-d9d037af}) [comment]: # ({ae5c568f-4a08c667}) ##### TLSServerCertIssuer 允许的服务器(proxy)证书颁发机构。 [comment]: # ({/ae5c568f-4a08c667}) [comment]: # ({fb69617f-6446ac76}) ##### TLSServerCertSubject 允许的服务器(proxy)证书主题。 [comment]: # ({/fb69617f-6446ac76}) [comment]: # ({8fffe818-42a95de3}) ##### UnsafeUserParameters 允许在用户自定义参数参数中传递所有字符。 以下字符不允许使用：\\ ' " \` \* ? \[ \] { } \~ $ ! & ; ( ) < > \| \# @
此外，换行符也不允许使用。 默认值：`0`
取值：0 - 不允许，1 - 允许 [comment]: # ({/8fffe818-42a95de3}) [comment]: # ({e817d9a2-cba7618d}) ##### UserParameter 用于监控的用户自定义参数。 可以定义多个用户自定义参数。
格式: UserParameter=<键值>,
注意shell命令不能返回空的string或仅包含EOL。 如果指定了UserParameterDir参数，shell命令可以使用相对路径。 示例: ```default UserParameter=system.test,dir /b | find /c /v "" UserParameter=check_cpu,.\custom\_script.bat ``` [comment]: # ({/e817d9a2-cba7618d}) [comment]: # ({c9cc7c82-f6be7620}) ##### UserParameterDir UserParameter命令的默认搜索路径。 若启用此参数，agent将在执行命令前将工作目录切换至此处指定的路径。 因此，UserParameter命令可使用相对路径的`.\`前缀替代完整路径。
仅允许配置单个路径条目。 示例： ```default UserParameterDir=C:\opt\myscripts ``` [comment]: # ({/c9cc7c82-f6be7620})