[comment]: # attributes: notoc

[comment]: # ({a4b21e35-8981e17d})
# 5 Zabbix 内部

[comment]: # ({/a4b21e35-8981e17d})

[comment]: # ({3592298d-34928067})
#### 概述

内部检查可用于监控 Zabbix 的内部进程。
换句话说，您可以监控 Zabbix 服务器或 Zabbix proxy 的运行情况。

内部检查的计算位置如下：

-   在 Zabbix 服务器上 - 如果主机由服务器监控
-   在 Zabbix proxy 上 - 如果主机由 proxy 监控

无论主机维护状态如何，内部检查都会由服务器或 proxy 处理。

要使用此监控项，请选择 **Zabbix internal** 监控项类型。

::: notetip
内部检查由 Zabbix poller 处理。
:::

[comment]: # ({/3592298d-34928067})

[comment]: # ({c3dbb6df-5d8f3b63})
#### 性能

使用某些内部监控项可能会对性能产生负面影响。
这些监控项包括：

-   `zabbix[host,,items]`
-   `zabbix[host,,items_unsupported]`
-   `zabbix[hosts]`
-   `zabbix[items]`
-   `zabbix[items_unsupported]`
-   `zabbix[queue,,]`
-   `zabbix[requiredperformance]`
-   `zabbix[stats,,,queue,,]`
-   `zabbix[triggers]`

[系统信息](/manual/web_interface/frontend_sections/reports/status_of_zabbix) 和 [队列](/manual/web_interface/frontend_sections/administration/queue)  
前端部分也会受到影响。

[comment]: # ({/c3dbb6df-5d8f3b63})

[comment]: # ({67dd6194-74b446f4})
#### 支持的检查项

以下列出了不含可自定义参数和附加信息的监控项键。
单击监控项键可查看完整详细信息。

|监控项键|描述|
|--|--------|
|[zabbix\[boottime\]](#boottime)|Zabbix 服务器或 Zabbix proxy 进程的启动时间（秒）。|
|[zabbix\[cluster,discovery,nodes\]](#cluster.discovery)|发现[高可用集群](/manual/concepts/server/ha)节点。|
|[zabbix\[connector_queue\]](#connector.queue)|connector 队列中已入队的值的数量。|
|[zabbix\[discovery_queue\]](#discovery.queue)|discovery 队列中已入队的网络检查数量。|
|[zabbix\[host,,items\]](#host.items)|主机上已启用监控项（支持和不支持）的数量。|
|[zabbix\[host,,items_unsupported\]](#host.items.unsupported)|主机上已启用且不受支持的监控项数量。|
|[zabbix\[host,,maintenance\]](#maintenance)|主机当前的维护状态。|
|[zabbix\[host,active_agent,available\]](#active.available)|主机上主动 agent 检查的可用性。|
|[zabbix\[host,discovery,interfaces\]](#discovery.interfaces)|Zabbix 前端中主机所有已配置接口的详细信息。|
|[zabbix\[host,,available\]](#host.available)|主机上特定类型检查的主接口可用性。|
|[zabbix\[hosts\]](#hosts)|受监控主机的数量。|
|[zabbix\[items\]](#items)|已启用监控项（支持和不支持）的数量。|
|[zabbix\[items_unsupported\]](#items.unsupported)|不受支持的监控项数量。|
|[zabbix\[java,,\]](#java)|有关 Zabbix Java 网关 的信息。|
|[zabbix\[lld_queue\]](#lld.queue)|低级别发现处理队列中已入队的值的数量。|
|[zabbix\[preprocessing\]](#preprocessing)|预处理管理器接收到的值的统计信息。|
|[zabbix\[preprocessing_queue\]](#preprocessing.queue)|预处理队列中已入队的值的数量。|
|[zabbix\[process,,,\]](#process)|特定 Zabbix 进程或一组进程（由 \<type\> 和 \<mode\> 标识）处于 \<state\> 的时间百分比。|
|[zabbix\[proxy,,\]](#proxy)|有关 Zabbix proxy 的信息。|
|[zabbix\[proxy,discovery\]](#proxy.discovery)|Zabbix proxies 列表。|
|[zabbix\[proxy group,,available\]](#proxy.group.a)|proxy 组中在线 proxy 的数量。|
|[zabbix\[proxy group,,pavailable\]](#proxy.group.b)|proxy 组中在线 proxy 的百分比。|
|[zabbix\[proxy group,,proxies\]](#proxy.group.c)|proxy 组中的 Zabbix proxies 列表。|
|[zabbix\[proxy group,,state\]](#proxy.group.d)|proxy 组的状态。|
|[zabbix\[proxy group,discovery\]](#proxy.group.e)|返回包含配置数据和实时数据的 proxy 组列表。|
|[zabbix\[proxy_buffer,buffer,\]](#proxy.buffer.mode)|返回 proxy 内存缓冲区使用情况统计信息。|
|[zabbix\[proxy_buffer,state,changes\]](#proxy.state.changes)|返回自启动以来磁盘/内存缓冲模式之间状态切换的次数。|
|[zabbix\[proxy_buffer,state,current\]](#proxy.state.current)|返回当前用于存储新数据的工作状态。|
|[zabbix\[proxy_history\]](#proxy.history)|proxy history 表中等待发送到服务器的值的数量。|
|[zabbix\[queue,,\]](#queue)|队列中受监控监控项的数量，这些监控项的延迟至少为 \<from\> 秒，但小于 \<to\> 秒。|
|[zabbix\[rcache,,\]](#rcache)|Zabbix 配置缓存的可用性统计信息。|
|[zabbix\[requiredperformance\]](#required.performance)|Zabbix 服务器或 Zabbix proxy 所需的性能，以预期每秒新值数表示。|
|[zabbix\[stats,,\]](#stats)|返回 Zabbix 服务器或 proxy 的内部指标。如果指定了 \<ip\> 和 \<port\>，则从远程实例获取指标；否则从本地实例获取。|
|[zabbix\[stats,,,queue,,\]](#stats.queue)|返回 Zabbix 服务器或 proxy 的内部队列指标。如果指定了 \<ip\> 和 \<port\>，则从远程实例获取指标；否则从本地实例获取。|
|[zabbix\[tcache,,\]](#tcache)|Zabbix 趋势函数缓存的有效性统计信息。|
|[zabbix\[triggers\]](#triggers)|Zabbix 数据库中已启用触发器的数量，其中启用的主机上的所有监控项也均已启用。|
|[zabbix\[uptime\]](#uptime)|Zabbix 服务器或 proxy 进程的运行时间（秒）。|
|[zabbix\[vcache,buffer,\]](#vcache)|Zabbix 值缓存的可用性统计信息。|
|[zabbix\[vcache,cache,\]](#vcache.parameter)|Zabbix 值缓存的有效性统计信息。|
|[zabbix\[version\]](#version)|Zabbix 服务器或 proxy 的版本。|
|[zabbix\[vmware,buffer,\]](#vmware)|Zabbix vmware 缓存的可用性统计信息。|
|[zabbix\[vps,written\]](#vps)|写入数据库的历史值总数。|
|[zabbix\[wcache,,\]](#wcache)|Zabbix 写缓存的统计信息和可用性。|

[comment]: # ({/67dd6194-74b446f4})

[comment]: # ({7ca89d39-0f6066ab})
#### 监控项键值详情

-   不带尖括号的参数为必填项，必须*按原样*使用（例如，`zabbix[host,<type>,available]` 中的“host”和“available”）。
-   带有尖括号 **<** **>** 的参数必须替换为有效值。
如果参数具有默认值，则可以省略。
-   标记为“not supported on proxy”的监控项和监控项参数，其值只有在主机由服务器监控时才能获取。
相反，标记为“not supported on server”的值，只有在主机由 proxy 监控时才能获取。

[comment]: # ({/7ca89d39-0f6066ab})

[comment]: # ({148a8a10-e52bbd1a})
##### zabbix[boottime] {#boottime}

<br>
Zabbix 服务器或 Zabbix 代理进程的启动时间（以秒为单位）。<br>
返回值：*整数*。

[comment]: # ({/148a8a10-e52bbd1a})

[comment]: # ({90f6506e-d1cde038})
##### zabbix[cluster,discovery,nodes] {#cluster.discovery}

<br>
发现[高可用集群](/manual/concepts/server/ha)节点。<br>
返回值：*JSON 对象*。

说明：

-   此监控项可用于低级别发现。
-   返回的字段大多与[高可用节点对象](/manual/api/reference/hanode/object)的属性一致。
-   附加字段：
    -   `db_timestamp` — 响应中包含的当前服务器时间（Unix 时间戳）
    -   `lastaccess_age` — 自节点上次心跳以来的秒数（db_timestamp - lastaccess）
    -   `status` — 节点状态：
        -   0 — 备用
        -   1 — 手动停止
        -   2 — 不可用
        -   3 — 活动

返回值示例：

```json
[
  {
    "id": "ckvupihk70001z8mkpw5cg0u3",
    "name": "zabbix-prod-01",
    "status": 3,
    "address": "10.0.4.12:10051",
    "port": 10051,
    "lastaccess": 1756115995,
    "db_timestamp": 1756116000,
    "lastaccess_age": 5
  },
  {
    "id": "ckvx2a9k70004b1nq2hz9d7f",
    "name": "zabbix-standby-02",
    "status": 0,
    "address": "10.0.4.13:10051",
    "port": 10051,
    "lastaccess": 1756115550,
    "db_timestamp": 1756116000,
    "lastaccess_age": 450
  },
  {
    "id": "ckw0bq3l70007y4r1a0m5kz8",
    "name": "zabbix-backup-eu1",
    "status": 1,
    "address": "backup.example.com:10051",
    "port": 10051,
    "lastaccess": 1756105080,
    "db_timestamp": 1756116000,
    "lastaccess_age": 10920
  }
]
```

[comment]: # ({/90f6506e-d1cde038})

[comment]: # ({95827395-09c4f0cf})
##### zabbix[connector_queue] {#connector.queue}

<br>
连接器队列中排队的值的数量。<br>
返回值：*整数*。

[comment]: # ({/95827395-09c4f0cf})

[comment]: # ({15dcffea-fcd989ee})
##### zabbix[discovery_queue] {#discovery.queue}

<br>
发现队列中排队的网络检查数量。<br>
返回值：*整数*。

[comment]: # ({/15dcffea-fcd989ee})

[comment]: # ({099bfd88-f065c85f})
##### zabbix[host,,items] {#host.items}

<br>
主机上启用的监控项数（支持和不支持）。<br>
返回值：*整数*。

[comment]: # ({/099bfd88-f065c85f})

[comment]: # ({4b7ee3b8-31a0bdcc})
##### zabbix[host,,items_unsupported] {#host.items.unsupported}

<br>
主机上启用的不支持监控项的数量。<br>
返回值：*整数*。

[comment]: # ({/4b7ee3b8-31a0bdcc})

[comment]: # ({d1d26ce3-6220db31})
##### zabbix[host,,maintenance] {#maintenance}

<br>
主机当前的维护状态。<br>
返回值：*0* - 正常状态；*1* - 采集数据的维护状态；*2* - 不采集数据的维护状态。

注释：

-   无论主机位于何处（在服务器上或在 proxy 上），该监控项始终由 Zabbix 服务器处理。  
proxy 不会在配置数据中收到该监控项。
-   第二个参数必须为空，并保留供将来使用。

[comment]: # ({/d1d26ce3-6220db31})

[comment]: # ({c0f07926-ec7187d4})
##### zabbix[host,active_agent,available] {#active.available}

<br>
检查主机上活动代理的可用性。<br>
返回值：*0* - 未知；*1* - 可用；*2* - 不可用。

[comment]: # ({/c0f07926-ec7187d4})

[comment]: # ({e96b325e-48ad1e26})
##### zabbix[host,discovery,interfaces] {#discovery.interfaces}

<br>
Zabbix 前端中主机的所有已配置接口的详细信息。<br>

返回值：*JSON 对象*。

注释：

- 此项可用于 [低级别自动发现](/manual/discovery/low_level_discovery/examples/host_interfaces)；
- Zabbix 代理不支持此项。

[comment]: # ({/e96b325e-48ad1e26})

[comment]: # ({f62c1ba4-9752a684})
##### zabbix[host,<type>,available] {#host.available}

<br>
主机上特定检查类型的主接口可用性。<br>
返回值：*0* - 不可用；*1* - 可用；*2* - 未知。

参数：

-   **type** - *agent*、*snmp*、*ipmi* 或 *jmx*。

注释：

-   监控项值根据与主机[不可达/不可用](/manual/appendix/items/unreachability)相关的配置参数计算。

[comment]: # ({/f62c1ba4-9752a684})

[comment]: # ({e4039f9c-a65ef5bf})
##### zabbix[hosts] {#hosts}

<br>
受监控主机的数量。<br>
返回值：*整数*。

[comment]: # ({/e4039f9c-a65ef5bf})

[comment]: # ({6cfb760d-f291ac50})
##### zabbix[items] {#items}

<br>
启用的监控项数（支持和不支持）。<br>
返回值：*整数*。

[comment]: # ({/6cfb760d-f291ac50})

[comment]: # ({241ba13b-53295b6d})
##### zabbix[items_unsupported] {#items.unsupported}

<br>
不支持的监控项数。<br>
返回值：*整数*。

[comment]: # ({/241ba13b-53295b6d})

[comment]: # ({2cc12aed-ba37fff4})
##### zabbix[java,,<param>] {#java}

<br>
有关 Zabbix Java 网关的信息。<br>
返回值：*1* - 如果 <param> 为 *ping*；*Java 网关版本* - 如果 <param> 为 *version*（例如："8.0.0"）。

参数：

-   **param** - *ping* 或 *version*。

注释：

-   此监控项可用于使用 `nodata()` 触发器函数检查 Java 网关的可用性。
-   第二个参数必须为空，并保留供将来使用。

[comment]: # ({/2cc12aed-ba37fff4})

[comment]: # ({3a719da4-8f8235d6})
##### zabbix[lld_queue] {#lld.queue}

<br>
低级发现处理队列中已入队的值的数量。<br>
返回值：*整数*。

备注：

-   此监控项可用于监控低级发现处理队列的长度。

[comment]: # ({/3a719da4-8f8235d6})

[comment]: # ({b85885da-b01e6c31})
##### zabbix[preprocessing] {#preprocessing}

<br>
预处理管理器接收到的值的统计信息：

-   *queued* - 需要预处理的排队值的数量和大小（计数器）
-   *direct* - 不需要预处理的排队值的数量和大小（计数器）
-   *queue* - 已进入预处理队列的值的数量（与 `zabbix[preprocessing_queue]` 相同）

返回值：*JSON*。

返回值示例：

```json
{"data":
    {
    "queued": {
        "count": 106,
        "size": 58620
    },
    "direct": {
        "count": 395,
        "size": 33843
    },
    "queue": 0
    }
}
```

[comment]: # ({/b85885da-b01e6c31})

[comment]: # ({cea1b6b0-3e07a93d})
##### zabbix[preprocessing_queue] {#preprocessing.queue}

<br>
预处理队列中已入队的值的数量。<br>
返回值：*Integer*。

注释：

-   此监控项可用于监控预处理队列长度。

[comment]: # ({/cea1b6b0-3e07a93d})

[comment]: # ({edd93889-b74b9537})
##### zabbix[process,<type>,<mode>,<state>] {#process}

<br>
特定 Zabbix 进程或一组进程（由 \<type\> 和 \<mode\> 标识）处于 \<state\> 状态所花费时间的百分比。  
仅针对最近一分钟进行计算。<br>
返回值：*Float*。

参数：

-   **type** - 对于[服务器进程](/manual/concepts/server#server-process-types-and-threads)：*agent poller*、*alert manager*、*alert syncer*、*alerter*、*availability manager*、*browser poller*、*configuration syncer*、*configuration syncer worker*、*connector manager*、*connector worker*、*discovery manager*、*discovery worker*、*escalator*、*ha manager*、*history poller*、*history syncer*、*housekeeper*、*http agent poller*、*http poller*、*icmp pinger*、*internal poller* *ipmi manager*、*ipmi poller*、*java poller*、*lld manager*、*lld worker*、*odbc poller*、*poller*、*preprocessing manager*、*preprocessing worker*、*proxy group manager*、*proxy poller*、*self-monitoring*、*service manager*、*snmp poller*、*snmp trapper*、*task manager*、*timer*、*trapper*、*trigger housekeeper*、*unreachable poller*、*vmware collector*；<br>对于[proxy 进程](/manual/concepts/proxy#proxy-process-types-and-threads)：*agent poller*、*availability manager*、*browser poller*、*configuration syncer*、*data sender*、*discovery manager*、*discovery worker*、*history syncer*、*housekeeper*、*http agent poller*、*http poller*、*icmp pinger*、*internal poller* *ipmi manager*、*ipmi poller*、*java poller*、*odbc poller*、*poller*、*preprocessing manager*、*preprocessing worker*、*self-monitoring*、*snmp poller*、*snmp trapper*、*task manager*、*trapper*、*unreachable poller*、*vmware collector*；
-   **mode** - *avg* - 给定类型所有进程的平均值（默认）；<br>*count* - 返回给定进程类型的 fork 数，且不应指定 <state>；<br>*max* - 最大值；<br>*min* - 最小值；<br>*<process number>* - 进程编号（介于 1 和预 fork 实例数之间；例如，如果有 4 个 trapper 正在运行，则该值介于 1 到 4 之间）；
-   **state** - *busy* - 进程处于忙碌状态，例如正在处理请求（默认）；<br>*idle* - 进程处于空闲状态，未执行任何操作。

说明：

-   如果 \<mode\> 是一个未运行的 Zabbix 进程编号（例如，当前运行了 5 个 poller，但将 \<mode\> 指定为 6），则此类监控项将变为不支持。
-   最小值和最大值指的是单个进程的使用百分比。  
因此，如果一组 3 个 poller 中每个进程的使用百分比分别为 2、18 和 66，则 min 将返回 2，max 将返回 66。
-   进程会将其正在执行的操作报告到共享内存中，而 self-monitoring 进程每秒汇总一次这些数据。  
状态变化（busy/idle）会在发生变化时被记录——因此，一个变为 busy 的进程会登记为 busy，并且在变为 idle 之前不会更改或更新该状态。  
这可确保即使是完全卡死的进程，也会被正确记录为 100% busy。
-   当前，“busy” 表示“未休眠”，但未来可能会引入其他状态——例如等待锁、执行数据库查询等。  
请注意，如果异步 poller 已达到 MaxConcurrentChecksPerPoller [服务器](/manual/appendix/config/zabbix_server#maxconcurrentchecksperpoller)/[proxy](/manual/appendix/config/zabbix_proxy#maxconcurrentchecksperpoller) 配置参数设置的限制，则也会被视为 busy。
-   在 Linux 和大多数其他系统上，分辨率为 1/100 秒。

示例：

```default
zabbix[process,poller,avg,busy] #最近一分钟内 poller 进程执行操作所花费时间的平均值
zabbix[process,"icmp pinger",max,busy] #最近一分钟内任一 ICMP pinger 进程执行操作所花费时间的最大值
zabbix[process,"history syncer",2,busy] #最近一分钟内编号为 2 的 history syncer 执行操作所花费的时间
zabbix[process,trapper,count] #当前正在运行的 trapper 进程数量
```

[comment]: # ({/edd93889-b74b9537})

[comment]: # ({0eada28f-d90bc125})
##### zabbix[proxy,<name>,<param>] {#proxy}

<br>
有关 Zabbix proxy 的信息。<br>
返回值：*Integer*。

参数：

-   **name** - proxy 名称；
-   **param** - *lastaccess* - 从 proxy 接收到的最后一条心跳消息的时间戳；<br>*delay* - 已采集值尚未发送的时长；计算方式为“proxy delay” + （“当前服务器时间” - “proxy lastaccess”），其中 “proxy delay” 是当前 proxy 时间与 proxy 上最早一条未发送值的时间戳之间的差值。

说明：

-   无论主机位于何处（在服务器上或在 proxy 上），该监控项始终由 Zabbix 服务器处理。
-   可使用 [`fuzzytime()`](/manual/config/triggers/expression/history#fuzzytime) 函数检查 proxy 的可用性。

示例：

```default
zabbix[proxy,"Germany",lastaccess] #从 "Germany" proxy 接收到的最后一条心跳消息的时间戳
```

[comment]: # ({/0eada28f-d90bc125})

[comment]: # ({32bb15b6-fd9ea3f4})
##### zabbix[proxy,discovery] {#proxy.discovery}

<br>
Zabbix 代理列表，包括名称、模式、加密、压缩、版本、上次查看、主机数、监控项数、每秒所需值 (vps)、版本状态（当前/过时/不支持）、按监控项类型划分的超时、代理组名称（如果代理属于组）、状态（未知/离线/在线）。<br>
返回值：*JSON 对象*。

[comment]: # ({/32bb15b6-fd9ea3f4})

[comment]: # ({64d10731-128da6e4})
##### zabbix[proxy group,<name>,available] {#proxy.group.a}

<br>
代理组中的在线代理数量。<br>
返回值：*Integer*。

参数：

- **name** - 代理组名称。

[comment]: # ({/64d10731-128da6e4})

[comment]: # ({b98b7e02-f6409765})
##### zabbix[proxy group,<name>,pavailable] {#proxy.group.b}

<br>
代理组中的在线代理百分比。<br>
返回值：*Float*。

参数：

- **name** - 代理组名称。

[comment]: # ({/b98b7e02-f6409765})

[comment]: # ({2d33356a-eb80ae15})
##### zabbix[proxy group,<name>,proxies] {#proxy.group.c}

<br>
代理组中的 Zabbix 代理列表，包括名称、模式、加密、压缩、版本、上次查看、主机数、监控项数、每秒所需值 (vps)、版本状态（当前/过时/不支持）、超时、代理组名称、状态（未知/离线/在线）。<br>
返回值：*JSON*。

参数：

- **name** - 代理组名称。

[comment]: # ({/2d33356a-eb80ae15})

[comment]: # ({ae123401-5e626558})
##### zabbix[proxy group,<name>,state] {#proxy.group.d}

<br>
代理组的状态。<br>
返回值：*0* - 未知；*1* - 离线；*2* - 恢复中；*3* - 在线；*4* - 降级。

参数：

- **name** - 代理组名称。

[comment]: # ({/ae123401-5e626558})

[comment]: # ({b7aaf303-4c4e2443})
##### zabbix[proxy group,discovery] {#proxy.group.e}

<br>
返回包含配置数据和实时数据的 proxy 组列表。
配置数据包括 proxy 组名称、故障转移延迟以及所需的最少在线 proxy 数量。
实时数据包括 proxy 组状态（详见注释）、在线 proxy 数量以及在线 proxy 的百分比。<br>
返回值：*JSON*。

注释：

-    此监控项不返回未分组的 proxy。
-    如果 "failover_delay" 或 "min_online" 的值无效，则会报告特殊值 *-1* 以表示该情况。
如果配置中使用了宏，而这些宏无法展开为有效值，则可能会出现无效值。
-    proxy 组状态以整数形式报告：*0* - 未知；*1* - 离线；*2* - 恢复中；*3* - 在线；*4* - 降级。

返回值示例：

```json
{
    "groups": [
       { "name": "Riga", "failover_delay": 60, "min_online": 1 },
       { "name": "Tokyo", "failover_delay": 60, "min_online": 2 },
       { "name": "Porto Alegre", "failover_delay": 60, "min_online": 3 }
    ],
    "details": {
        "Riga": { "state": 3, "available": 10, "pavailable": 20 },
        "Tokyo": { "state": 3, "available": 10, "pavailable": 20 },
        "Porto Alegre": { "state": 1, "available": 0, "pavailable": 0 }
    }
}
```

[comment]: # ({/b7aaf303-4c4e2443})

[comment]: # ({96175ec3-3cbda156})
##### zabbix[proxy_buffer,buffer,<mode>] {#proxy.buffer.mode}

<br>
proxy 内存缓冲区使用统计。<br>
返回值：*Integer*（大小）；*Float*（百分比）。

参数：

-   **mode**：*total* - 缓冲区总大小（可用于检查是否启用了内存缓冲区）；<br>*free* - 空闲缓冲区大小；<br>*pfree* - 空闲缓冲区百分比；<br>*used* - 已用缓冲区大小；<br>*pused* - 已用缓冲区百分比。

说明：

-   当内存缓冲区被禁用时，返回“Proxy memory buffer is disabled”错误；<br>
-   此监控项在 Zabbix 服务器上不受支持。

[comment]: # ({/96175ec3-3cbda156})

[comment]: # ({c82bd137-2cf98704})
##### zabbix[proxy_buffer,state,changes] {#proxy.state.changes}

<br>
返回自启动以来磁盘/内存缓冲区模式之间的状态变化次数。<br>
返回值：*整数*；*0* - 内存缓冲区已禁用。

注释：

- 频繁的状态变化表明必须增加内存缓冲区的大小或使用期限；
- 如果不频繁监控内存缓冲区状态（例如，每分钟一次），则缓冲区可能会在未注册的情况下翻转其状态。

[comment]: # ({/c82bd137-2cf98704})

[comment]: # ({0a1b1d6a-c72fc132})
##### zabbix[proxy_buffer,state,current] {#proxy.state.current}

<br>
返回当前正在存储新数据的工作状态。<br>
返回值：*0* - 磁盘；*1* - 内存。

注释：

-   当内存缓冲区被禁用时，也会返回“0”。

[comment]: # ({/0a1b1d6a-c72fc132})

[comment]: # ({5e74b0db-5b463b30})
##### zabbix[proxy_history] {#proxy.history}

<br>
proxy 历史记录表中等待发送到服务器的值的数量。<br>
返回值：*整数*。

注释：

-   此监控项在 Zabbix 服务器上不受支持。

[comment]: # ({/5e74b0db-5b463b30})

[comment]: # ({60c8e55e-ebe20dec})
##### zabbix[queue,<from>,<to>] {#queue}

<br>
队列中延迟至少 \<from\> 秒但小于 \<to\> 秒的受监控监控项数量。<br>
返回值：*Integer*。

参数：

-   **from** - 至少延迟多久（默认值为 6 秒）；
-   **to** - 最多延迟多久（默认值为无穷大）。

说明：

-   参数支持[时间后缀](/manual/appendix/suffixes)（s、m、h、d、w）。

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

[comment]: # ({/60c8e55e-ebe20dec})

[comment]: # ({f4422d28-04aafd0c})
##### zabbix[rcache,<cache>,<mode>] {#rcache}

<br>
Zabbix 配置缓存的可用性统计信息。<br>
返回值：*Integer*（表示大小）；*Float*（表示百分比）。

参数：

- **cache** - *buffer*;
- **mode** - *total* - 缓冲区的总大小<br>*free* - 可用缓冲区的大小<br>*pfree* - 可用缓冲区的百分比<br>*used* - 已使用缓冲区的大小<br>*pused* - 已使用缓冲区的百分比

[comment]: # ({/f4422d28-04aafd0c})

[comment]: # ({2b0828e0-f2b37a90})
##### zabbix[requiredperformance] {#required.performance}

<br>
Zabbix 服务器或 Zabbix proxy 的所需性能，以预期的每秒新值数量表示。<br>
返回值：*Float*。

注释：

-   大致对应于 *报告 > [系统信息](/manual/web_interface/frontend_sections/reports/status_of_zabbix)* 中的“所需服务器性能，每秒新值数”。

[comment]: # ({/2b0828e0-f2b37a90})

[comment]: # ({e1c3ca5f-8054c8ab})
##### zabbix[stats,<ip>,<port>] {#stats}

<br>
返回 Zabbix 服务器或 proxy 的内部指标。如果指定了 \<ip\> 和 \<port\>，则从远程实例获取指标；否则，从本地实例获取。<br>
返回值：*JSON object*。

参数：

-   **ip** - 要远程查询的服务器/proxy 的 IP/DNS/网络掩码列表（默认值为 127.0.0.1）；
-   **port** - 要远程查询的服务器/proxy 端口（默认值为 10051）。

注释：

-   统计请求仅接受来自目标实例上 'StatsAllowedIP' [server](/manual/appendix/config/zabbix_server)/[proxy](/manual/appendix/config/zabbix_proxy) 参数中列出的地址。
-   此监控项会返回一组选定的内部指标。  
有关详细信息，请参见 [Remote monitoring of Zabbix stats](/manual/appendix/items/remote_stats#exposed-metrics)。

[comment]: # ({/e1c3ca5f-8054c8ab})

[comment]: # ({7f993eed-d7c2c9be})
##### zabbix[stats,<ip>,<port>,queue,<from>,<to>] {#stats.queue}

<br>
返回 Zabbix 服务器或 proxy 的内部队列指标（参见 `zabbix[queue,<from>,<to>]`）。如果指定了 \<ip\> 和 \<port\>，则从远程实例获取指标；否则，从本地实例获取。<br>
返回值：*JSON object*。

参数：

-   **ip** - 要远程查询的服务器/proxy 的 IP/DNS/网络掩码列表（默认值为 127.0.0.1）；
-   **port** - 要远程查询的服务器/proxy 端口（默认值为 10051）；
-   **from** - 至少延迟多久（默认值为 6 秒）；
-   **to** - 最多延迟多久（默认值为无穷大）。

说明：

-   统计请求仅会从目标实例上 'StatsAllowedIP' [server](/manual/appendix/config/zabbix_server)/[proxy](/manual/appendix/config/zabbix_proxy) 参数中列出的地址接受。
-   此监控项会返回一组选定的内部指标。
有关详细信息，请参见 [Remote monitoring of Zabbix stats](/manual/appendix/items/remote_stats#exposed-metrics)。

::: noteimportant
Zabbix proxy 无法感知维护期；详情请参见 [Calculation of queues during maintenance](/manual/maintenance#calculation-of-queues-during-maintenance)。
:::

[comment]: # ({/7f993eed-d7c2c9be})

[comment]: # ({6176cbcb-c688d590})
##### zabbix[tcache,cache,<parameter>] {#tcache}

<br>
Zabbix 趋势函数缓存的有效性统计。<br>
返回值：*Integer*（用于大小）；*Float*（用于百分比）。

参数：

-   **parameter** - *all* - 缓存请求总数（默认）；<br>*hits* - 缓存命中次数；<br>*phits* - 缓存命中百分比；<br>*misses* - 缓存未命中次数；<br>*pmisses* - 缓存未命中百分比；<br>*items* - 已缓存监控项的数量；<br>*requests* - 已缓存请求的数量；<br>*pitems* - 已缓存监控项占已缓存监控项与请求总和的百分比。
较低的百分比很可能意味着可以减小缓存大小。

注释：

-   此监控项在 Zabbix proxy 上不受支持。

[comment]: # ({/6176cbcb-c688d590})

[comment]: # ({5ed7a34c-9699e4ca})
##### zabbix[triggers] {#triggers}

<br>
Zabbix 数据库中已启用触发器的数量，且这些触发器所在的已启用主机上的所有监控项也均已启用。<br>
返回值：*Integer*。

说明：

-   此监控项在 Zabbix proxy 上不受支持。

[comment]: # ({/5ed7a34c-9699e4ca})

[comment]: # ({3883a5b8-a5c8cdec})
##### zabbix[uptime] {#uptime}

<br>
Zabbix 服务器或代理进程的正常运行时间（以秒为单位）。<br>
返回值：*整数*。

[comment]: # ({/3883a5b8-a5c8cdec})

[comment]: # ({84585ed2-304cb09c})
##### zabbix[vcache,buffer,<mode>] {#vcache}

<br>
Zabbix 值缓存的可用性统计信息。<br>
返回值：*Integer*（用于大小）；*Float*（用于百分比）。

参数：

-   **mode** - *total* - 缓冲区总大小；<br>*free* - 空闲缓冲区大小；<br>*pfree* - 空闲缓冲区百分比；<br>*used* - 已用缓冲区大小；<br>*pused* - 已用缓冲区百分比。

注释：

-   此监控项在 Zabbix proxy 上不受支持。

[comment]: # ({/84585ed2-304cb09c})

[comment]: # ({e8f4addd-1454b994})
##### zabbix[vcache,cache,<parameter>] {#vcache.parameter}

<br>
Zabbix 值缓存的有效性统计。<br>
返回值：*Integer*。
如果将 <parameter> 设置为 *mode*，则返回值为：*0* - 正常模式；*1* - 低内存模式。

参数：

-   **parameter** - *requests* - 请求总数；<br>*hits* - 缓存命中次数（从缓存中获取的历史值）；<br>*misses* - 缓存未命中次数（从数据库中获取的历史值）；<br>*mode* - 值缓存的运行模式。

注释：

-   一旦切换到低内存模式，即使触发该模式的问题更早得到解决，值缓存也会在此状态下保持 24 小时。
-   您可以将此键与 *Change per second* 预处理步骤一起使用，以获取每秒值数统计。
-   此监控项在 Zabbix proxy 上不受支持。

[comment]: # ({/e8f4addd-1454b994})

[comment]: # ({9c7b0ac5-ddde46a0})
##### zabbix[version] {#version}

<br>
Zabbix 服务器或 proxy 的版本。<br>
返回值：*String*。例如：`8.0.0`。

[comment]: # ({/9c7b0ac5-ddde46a0})

[comment]: # ({aae81fd0-dda0c008})
##### zabbix[vmware,buffer,<mode>] {#vmware}

<br>
Zabbix vmware 缓存的可用性统计信息。<br>
返回值：*Integer*（用于大小）；*Float*（用于百分比）。

参数：

- **mode** - *total* - 缓冲区的总大小<br>*free* - 可用缓冲区的大小<br>*pfree* - 可用缓冲区的百分比<br>*used* - 已使用缓冲区的大小<br>*pused* - 已使用缓冲区的百分比

[comment]: # ({/aae81fd0-dda0c008})

[comment]: # ({510ec9a7-39aec89e})
##### zabbix[vps,written] {#vps}

<br>
写入数据库的历史值总数。<br>
返回值：*整数*。

[comment]: # ({/510ec9a7-39aec89e})

[comment]: # ({8fd5987f-9fa76fcd})
##### zabbix[wcache,<cache>,<mode>] {#wcache}

<br>
Zabbix 写缓存的统计信息和可用性。<br>
返回值：*Integer*（用于数量/大小）；*Float*（用于百分比）。

参数：

-   **cache** - *values*、*history*、*index* 或 *trend*；
-   **mode** - （与 *values* 一起使用）*all*（默认）- Zabbix 服务器/proxy 处理的值总数，不包括不支持的监控项（计数器）；<br>*float* - 已处理的浮点值数量（计数器）；<br>*uint* - 已处理的无符号整数值数量（计数器）；<br>*str* - 已处理的字符/字符串值数量（计数器）；<br>*log* - 已处理的日志值数量（计数器）；<br>*text* - 已处理的文本值数量（计数器）；<br>*bin* - 已处理的二进制值数量（计数器）；<br>*json* - 已处理的 JSON 值数量（计数器）；<br>*not supported* - 监控项处理导致监控项变为不支持状态或保持该状态的次数（计数器）；<br>（与 *history*、*index*、*trend* 缓存一起使用）*pfree*（默认）- 空闲缓冲区的百分比；<br>*total* - 缓冲区总大小；<br>*free* - 空闲缓冲区大小；<br>*used* - 已用缓冲区大小；<br>*pused* - 已用缓冲区的百分比。

注释：

-   `trend` 缓存参数不支持 Zabbix proxy。
-   历史缓存用于存储监控项值。
较低的数值表示数据库端存在性能问题。
-   历史索引缓存用于为存储在历史缓存中的值建立索引。
-   在历史缓存被填满后再清空时，历史索引缓存仍会保留部分数据。
这是预期行为，它通过避免因持续调整内存大小而需要的额外处理，帮助系统更高效地运行。
-   趋势缓存存储当前小时内所有接收数据的监控项的聚合值。
-   您可以将 zabbix[wcache,values] 键与 *Change per second* 预处理步骤一起使用，以获取每秒值数统计信息。

[comment]: # ({/8fd5987f-9fa76fcd})