[comment]: # translation:outdated [comment]: # attributes: notoc [comment]: # ({7a29bf66-871f8735}) # 1 Zabbix agent 2 [comment]: # ({/7a29bf66-871f8735}) [comment]: # ({31b266f5-3728d5da}) Zabbix agent 2 支持 Zabbix agent 在 [Unix](/manual/config/items/itemtypes/zabbix_agent) 和 [Windows](/manual/config/items/itemtypes/zabbix_agent/win_keys) 上支持的所有监控项键值。 本页提供仅可与 Zabbix agent 2 一起使用的附加监控项键值的详细信息，并按其所属插件分组。 监控项键值列表未包含参数和附加信息。 单击监控项键值可查看完整详细信息。 |监控项键值|描述|插件| |--|-------|-| |[ceph.df.details](#ceph.df.details)|集群的数据使用情况以及在各个池之间的分布。|[Ceph](/manual/concepts/agent2/loadable_plugins)
(可加载)| |[ceph.osd.stats](#ceph.osd.stats)|汇总的以及按 OSD 分别统计的信息。|^| |[ceph.osd.discovery](#ceph.osd.discovery)|已发现的 OSD 列表。|^| |[ceph.osd.dump](#ceph.osd.dump)|OSD 的使用阈值和状态。|^| |[ceph.ping](#ceph.ping)|测试是否可以建立到 Ceph 的连接。|^| |[ceph.pool.discovery](#ceph.pool.discovery)|已发现的池列表。|^| |[ceph.status](#ceph.status)|整个集群的状态。|^| |[docker.container_info](#docker.container.info)|有关容器的底层信息。|[Docker](/manual/concepts/agent2/builtin_plugins)| |[docker.container_stats](#docker.container.stats)|容器资源使用统计信息。|^| |[docker.containers](#docker.containers)|返回容器列表。|^| |[docker.containers.discovery](#docker.containers.discovery)|返回容器列表。用于低级别发现。|^| |[docker.data.usage](#docker.data.usage)|有关当前数据使用情况的信息。|^| |[docker.images](#docker.images)|返回镜像列表。|^| |[docker.images.discovery](#docker.images.discovery)|返回镜像列表。用于低级别发现。|^| |[docker.info](#docker.info)|系统信息。|^| |[docker.ping](#docker.ping)|测试 Docker 守护进程是否存活。|^| |[ember.get](#ember.get)|返回所需设备的结果。|[Ember+](/manual/concepts/agent2/loadable_plugins)
(可加载)| |[memcached.ping](#memcached.ping)|测试连接是否存活。|[Memcached](/manual/concepts/agent2/builtin_plugins)| |[memcached.stats](#memcached.stats)|获取 STATS 命令的输出。|^| |[mongodb.cfg.discovery](#mongodb.cfg.discovery)|返回已发现的配置服务器列表。|[MongoDB](/manual/concepts/agent2/loadable_plugins)
(可加载)| |[mongodb.collection.stats](#mongodb.collection.stats)|返回指定集合的各种存储统计信息。|^| |[mongodb.collections.discovery](#mongodb.collections.discovery)|返回已发现的集合列表。|^| |[mongodb.collections.usage](#mongodb.collections.usage)|返回集合的使用统计信息。|^| |[mongodb.connpool.stats](#mongodb.connpool.stats)|返回当前数据库实例到分片集群或副本集其他成员的已打开出站连接信息。|^| |[mongodb.db.stats](#mongodb.db.stats)|返回反映指定数据库系统状态的统计信息。|^| |[mongodb.db.discovery](#mongodb.db.discovery)|返回已发现的数据库列表。|^| |[mongodb.jumbo_chunks.count](#mongodb.jumbo.chunks.count)|返回 jumbo chunk 的数量。|^| |[mongodb.oplog.stats](#mongodb.oplog.stats)|使用从 oplog 轮询的数据返回副本集状态。|^| |[mongodb.ping](#mongodb.ping)|测试连接是否存活。|^| |[mongodb.rs.config](#mongodb.rs.config)|返回副本集的当前配置。|^| |[mongodb.rs.status](#mongodb.rs.status)|从运行该方法的成员视角返回副本集状态。|^| |[mongodb.server.status](#mongodb.server.status)|返回数据库状态。|^| |[mongodb.sh.discovery](#mongodb.sh.discovery)|返回集群中存在的已发现分片列表。|^| |[mongodb.version](#mongodb.version)|返回数据库服务器版本。|^| |[mqtt.get](#mqtt.get)|订阅所提供 broker 的一个或多个特定主题（支持通配符），并等待发布消息。|[MQTT](/manual/concepts/agent2/builtin_plugins)| |[mssql.availability.group.get](#mssql-availability-groups)|返回可用性组。|[MSSQL](/manual/concepts/agent2/loadable_plugins)
(可加载)| |[mssql.custom.query](#mssql-custom-query)|返回自定义查询的结果。|^| |[mssql.db.get](#mssql-db)|返回所有可用的 MSSQL 数据库。|^| |[mssql.job.status.get](#mssql-job-status)|返回作业状态。|^| |[mssql.last.backup.get](#mssql-last-backup)|返回所有数据库的上次备份时间。|^| |[mssql.local.db.get](#mssql-local-db)|返回参与 Always On 可用性组和副本（主副本或辅助副本），且位于建立连接的服务器上的数据库。|^| |[mssql.mirroring.get](#mssql-mirroring)|返回镜像信息。|^| |[mssql.nonlocal.db.get](#mssql-nonlocal-db)|返回参与 Always On 可用性组和副本（主副本或辅助副本），且位于其他服务器上的数据库（该数据库不在建立连接的 SQL Server 实例本地）。|^| |[mssql.perfcounter.get](#mssql-perfcounter)|返回性能计数器。|^| |[mssql.ping](#mssql-ping)|测试连接是否存活。|^| |[mssql.quorum.get](#mssql-quorum)|返回仲裁信息。|^| |[mssql.quorum.member.get](#mssql-quorum-member)|返回仲裁成员。|^| |[mssql.replica.get](#mssql-replica)|返回副本。|^| |[mssql.version](#mssql-version)|返回 MSSQL 版本。|^| |[mysql.custom.query](#mysql.custom.query)|返回自定义查询的结果。|[MySQL](/manual/concepts/agent2/builtin_plugins)| |[mysql.db.discovery](#mysql.db.discovery)|返回 MySQL 数据库列表。|^| |[mysql.db.size](#mysql.db.size)|数据库大小，单位为字节。|^| |[mysql.get_status_variables](#mysql.get.status.variables)|全局状态变量的值。|^| |[mysql.ping](#mysql.ping)|测试连接是否存活。|^| |[mysql.replication.discovery](#mysql.replication.discovery)|返回 MySQL 复制列表。|^| |[mysql.replication.get_slave_status](#mysql.replication.get.slave.status)|复制状态。|^| |[mysql.version](#mysql.version)|MySQL 版本。|^| |[net.dns.get](#net.dns.get)|执行 DNS 查询并返回详细的 DNS 记录信息。|[Network](/manual/concepts/agent2/builtin_plugins)| |[nvml.device.count](#nvml.device.count)|GPU 设备数量。|[NVIDIA GPU](/manual/concepts/agent2/loadable_plugins)
(可加载)| |[nvml.device.decoder.utilization](#nvml.device.decoder.utilization)|GPU 设备解码器利用率。|^| |[nvml.device.ecc.mode](#nvml.device.ecc.mode)|GPU 设备 ECC 模式。|^| |[nvml.device.encoder.stats.get](#nvml.device.encoder.stats.get)|GPU 设备编码器统计信息。|^| |[nvml.device.encoder.utilization](#nvml.device.encoder.utilization)|GPU 设备编码器利用率。|^| |[nvml.device.energy.consumption](#nvml.device.energy.consumption)|GPU 设备能耗。|^| |[nvml.device.errors.memory](#nvml.device.errors.memory)|GPU 设备 ECC 内存错误信息。|^| |[nvml.device.errors.register](#nvml.device.errors.register)|GPU 设备 ECC 寄存器错误信息。|^| |[nvml.device.fan.speed.avg](#nvml.device.fan.speed.avg)|GPU 设备风扇平均转速。|^| |[nvml.device.get](#nvml.device.get)|发现的 GPU，包含 UUID 和名称。|^| |[nvml.device.graphics.frequency](#nvml.device.graphics.frequency)|GPU 设备图形时钟频率。|^| |[nvml.device.memory.bar1.get](#nvml.device.memory.bar1.get)|GPU 设备 BAR1 内存信息。|^| |[nvml.device.memory.fb.get](#nvml.device.memory.fb.get)|GPU 设备帧缓冲内存信息。|^| |[nvml.device.memory.frequency](#nvml.device.memory.frequency)|GPU 设备内存时钟频率。|^| |[nvml.device.pci.utilization](#nvml.device.pci.utilization)|GPU 设备 PCI 利用率。|^| |[nvml.device.performance.state](#nvml.device.performance.state)|GPU 设备性能状态。|^| |[nvml.device.power.limit](#nvml.device.power.limit)|GPU 设备功率限制。|^| |[nvml.device.power.usage](#nvml.device.power.usage)|GPU 设备功耗。|^| |[nvml.device.serial](#nvml.device.serial)|GPU 设备序列号。|^| |[nvml.device.sm.frequency](#nvml.device.sm.frequency)|GPU 设备流式多处理器时钟频率。|^| |[nvml.device.temperature](#nvml.device.temperature)|GPU 设备温度。|^| |[nvml.device.utilization](#nvml.device.utilization)|GPU 设备利用率统计信息。|^| |[nvml.device.video.frequency](#nvml.device.video.frequency)|GPU 设备视频时钟频率。|^| |[nvml.system.driver.version](#nvml.system.driver.version)|NVIDIA 驱动程序版本。|^| |[nvml.version](#nvml.version)|NVML 库版本。|^| |[oracle.diskgroups.stats](#oracle.diskgroups.stats)|返回 Automatic Storage Management (ASM) 磁盘组统计信息。|[Oracle](/manual/concepts/agent2/builtin_plugins)| |[oracle.diskgroups.discovery](#oracle.diskgroups.discovery)|返回 ASM 磁盘组列表。|^| |[oracle.archive.info](#oracle.archive.info)|归档日志统计信息。|^| |[oracle.cdb.info](#oracle.cdb.info)|Container Databases (CDBs) 信息。|^| |[oracle.custom.query](#oracle.custom.query)|自定义查询的结果。|^| |[oracle.datafiles.stats](#oracle.datafiles.stats)|返回数据文件统计信息。|^| |[oracle.db.discovery](#oracle.db.discovery)|返回数据库列表。|^| |[oracle.fra.stats](#oracle.fra.stats)|返回 Fast Recovery Area (FRA) 统计信息。|^| |[oracle.instance.info](#oracle.instance.info)|实例统计信息。|^| |[oracle.pdb.info](#oracle.pdb.info)|Pluggable Databases (PDBs) 信息。|^| |[oracle.pdb.discovery](#oracle.pdb.discovery)|返回 PDB 列表。|^| |[oracle.pga.stats](#oracle.pga.stats)|返回 Program Global Area (PGA) 统计信息。|^| |[oracle.ping](#oracle.ping)|测试是否可以建立到 Oracle 的连接。|^| |[oracle.proc.stats](#oracle.proc.stats)|返回进程统计信息。|^| |[oracle.redolog.info](#oracle.redolog.info)|来自控制文件的日志文件信息。|^| |[oracle.sga.stats](#oracle.sga.stats)|返回 System Global Area (SGA) 统计信息。|^| |[oracle.sessions.stats](#oracle.sessions.stats)|返回会话统计信息。|^| |[oracle.sys.metrics](#oracle.sys.metrics)|返回一组系统指标值。|^| |[oracle.sys.params](#oracle.sys.params)|返回一组系统参数值。|^| |[oracle.ts.stats](#oracle.ts.stats)|返回表空间统计信息。|^| |[oracle.ts.discovery](#oracle.ts.discovery)|返回表空间列表。|^| |[oracle.user.info](#oracle.user.info)|返回 Oracle 用户信息。|^| |[oracle.version](#oracle.version)|返回数据库服务器版本。|^| |[pgsql.autovacuum.count](#pgsql.autovacuum.count)|autovacuum worker 数量。|[PostgreSQL](/manual/concepts/agent2/loadable_plugins)
(可加载)| |[pgsql.archive](#pgsql.archive)|有关归档文件的信息。|^| |[pgsql.bgwriter](#pgsql.bgwriter)|数据库集群的检查点总数，按检查点类型细分。|^| |[pgsql.cache.hit](#pgsql.cache.hit)|PostgreSQL 缓冲区缓存命中率。|^| |[pgsql.connections](#pgsql.connections)|按类型返回连接。|^| |[pgsql.custom.query](#pgsql.custom.query)|返回自定义查询的结果。|^| |[pgsql.db.age](#pgsql.db.age)|数据库中最老 FrozenXID 的年龄。|^| |[pgsql.db.bloating_tables](#pgsql.db.bloating.tables)|每个数据库中的膨胀表数量。|^| |[pgsql.db.discovery](#pgsql.db.discovery)|PostgreSQL 数据库列表。|^| |[pgsql.db.size](#pgsql.db.size)|数据库大小，单位为字节。|^| |[pgsql.dbstat](#pgsql.dbstat)|收集每个数据库的统计信息。|^| |[pgsql.dbstat.sum](#pgsql.dbstat.sum)|集群中所有数据库的汇总数据。|^| |[pgsql.locks](#pgsql.locks)|每个数据库已授予锁的信息。|^| |[pgsql.oldest.xid](#pgsql.oldest.xid)|最老 XID 的年龄。|^| |[pgsql.ping](#pgsql.ping)|测试连接是否存活。|^| |[pgsql.queries](#pgsql.queries)|按执行时间统计的查询指标。|^| |[pgsql.replication.count](#pgsql.replication.count)|备用服务器数量。|^| |[pgsql.replication.process](#pgsql.replication.process)|每个发送进程的 flush lag、write lag 和 replay lag。|^| |[pgsql.replication.process.discovery](#pgsql.replication.process.discovery)|复制进程名称发现。|^| |[pgsql.replication.recovery_role](#pgsql.replication.recovery.role)|恢复状态。|^| |[pgsql.replication.status](#pgsql.replication.status)|复制状态。|^| |[pgsql.replication_lag.b](#pgsql.replication.lag.b)|以字节为单位的复制延迟。|^| |[pgsql.replication_lag.sec](#pgsql.replication.lag.sec)|以秒为单位的复制延迟。|^| |[pgsql.uptime](#pgsql.uptime)|PostgreSQL 运行时间，单位为毫秒。|^| |[pgsql.version](#pgsql.version)|返回 PostgreSQL 版本。|^| |[pgsql.wal.stat](#pgsql.wal.stat)|WAL 统计信息。|^| |[redis.config](#redis.config)|获取与模式匹配的 Redis 实例配置参数。|[Redis](/manual/concepts/agent2/builtin_plugins)| |[redis.info](#redis.info)|获取 INFO 命令的输出。|^| |[redis.ping](#redis.ping)|测试连接是否存活。|^| |[redis.slowlog.count](#redis.slowlog.count)|自 Redis 启动以来的慢日志条目数。|^| |[smart.attribute.discovery](#smart.attribute.discovery)|返回 S.M.A.R.T. 设备属性列表。|[S.M.A.R.T.](/manual/concepts/agent2/builtin_plugins)| |[smart.disk.discovery](#smart.disk.discovery)|返回 S.M.A.R.T. 设备列表。|^| |[smart.disk.get](#smart.disk.get)|返回 S.M.A.R.T. 设备的所有可用属性。|^| |[systemd.unit.get](#systemd.unit.get)|返回 systemd 单元的所有属性。|[Systemd](/manual/concepts/agent2/builtin_plugins)| |[systemd.unit.info](#systemd.unit.info)|systemd 单元信息。|^| |[systemd.unit.discovery](#systemd.unit.discovery)|systemd 单元及其详细信息列表。|^| |[web.certificate.get](#web.certificate.get)|验证证书并返回证书详细信息。|[Web certificates](/manual/concepts/agent2/builtin_plugins)| [comment]: # ({/31b266f5-3728d5da}) [comment]: # ({dc120678-3077d649}) ### 监控项键值详情 不带尖括号的参数为必填参数。 带有尖括号 **<** **>** 标记的参数为可选参数。 [comment]: # ({/dc120678-3077d649}) [comment]: # ({cb224c09-e443ac84}) ##### ceph.df.details[connString,,] {#ceph.df.details}
集群的数据使用情况以及在各个池之间的分布。
返回值：*JSON object*。 参数： - **connString** - URI 或会话名称；
- **user, apikey** - 用于连接到 Ceph 的用户名和 API 密钥。
[comment]: # ({/cb224c09-e443ac84}) [comment]: # ({35504811-8b08b33c}) ##### ceph.osd.stats[connString,,] {#ceph.osd.stats}
聚合统计信息和每个 OSD 的统计信息。
返回值：*JSON object*。 参数： - **connString** - URI 或会话名称；
- **user, apikey** - 用于连接 Ceph 的用户名和 API 密钥。
[comment]: # ({/35504811-8b08b33c}) [comment]: # ({b0e11d48-07bfdcb6}) ##### ceph.osd.discovery[connString,,] {#ceph.osd.discovery}
已发现的 OSD 列表。 用于[低级别发现](/manual/discovery/low_level_discovery)。
返回值：*JSON 对象*。 参数： - **connString** - URI 或会话名称；
- **user, apikey** - 用于连接 Ceph 的用户名和 API 密钥。
[comment]: # ({/b0e11d48-07bfdcb6}) [comment]: # ({a1fec239-236454b9}) ##### ceph.osd.dump[connString,,] {#ceph.osd.dump}
OSD 的使用率阈值和状态。
返回值：*JSON 对象*。 参数： - **connString** - URI 或会话名称；
- **user, apikey** - 用于连接 Ceph 的用户名和 API 密钥。
[comment]: # ({/a1fec239-236454b9}) [comment]: # ({07aea781-04750a8f}) ##### ceph.ping[connString,,] {#ceph.ping}
测试是否可以建立到 Ceph 的连接。
返回值：*0* - 连接已中断（如果出现任何错误，包括 AUTH 和配置问题）；*1* - 连接成功。 参数： - **connString** - URI 或会话名称；
- **user, apikey** - 用于连接到 Ceph 的用户名和 API 密钥。
[comment]: # ({/07aea781-04750a8f}) [comment]: # ({77065742-5930838a}) ##### ceph.pool.discovery[connString,,] {#ceph.pool.discovery}
已发现的池列表。 用于[低级别发现](/manual/discovery/low_level_discovery)。
返回值：*JSON 对象*。 参数： - **connString** - URI 或会话名称；
- **user, apikey** - 用于连接 Ceph 的用户名和 API 密钥。
[comment]: # ({/77065742-5930838a}) [comment]: # ({57e02fe0-d2e29bd4}) ##### ceph.status[connString,,] {#ceph.status}
集群的整体状态。
返回值：*JSON object*。 参数： - **connString** - URI 或会话名称；
- **user, apikey** - 用于连接 Ceph 的用户名和 API 密钥。
[comment]: # ({/57e02fe0-d2e29bd4}) [comment]: # ({0c7c0596-0f9ad2d9}) ##### docker.container_info[,] {#docker.container.info}
容器的低级别信息。
返回值：[ContainerInspect](https://docs.docker.com/engine/api/v1.28/#operation/ContainerInspect) API 调用的输出，序列化为 JSON。 参数： - **ID** - 容器的 ID 或名称；
- **info** - 返回的信息量。 支持的值：*short*（默认）或 *full*。 必须将 Agent 2 用户（'zabbix'）添加到 'docker' [group](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) 中，以获得足够的权限。 否则，该检查将失败。 [comment]: # ({/0c7c0596-0f9ad2d9}) [comment]: # ({8660cae8-9e9006b3}) ##### docker.container_stats[] {#docker.container.stats}
容器资源使用统计信息。
返回值：以 JSON 序列化的 [ContainerStats](https://docs.docker.com/engine/api/v1.28/#operation/ContainerStats) API 调用输出以及 CPU 使用率百分比。 参数： - **ID** - 容器的 ID 或名称。 必须将 Agent 2 用户（'zabbix'）添加到 'docker' [group](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) 中，以获得足够的权限。 否则检查将失败。 [comment]: # ({/8660cae8-9e9006b3}) [comment]: # ({1aa135d2-30610c8f}) ##### docker.containers {#docker.containers}
容器列表。
返回值：[ContainerList](https://docs.docker.com/engine/api/v1.28/#operation/ContainerList) API 调用的输出，序列化为 JSON。 必须将 Agent 2 用户（'zabbix'）添加到 'docker' [group](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) 中，以获得足够的权限。 否则，该检查将失败。 [comment]: # ({/1aa135d2-30610c8f}) [comment]: # ({08d667eb-39cceff0}) ##### docker.containers.discovery[] {#docker.containers.discovery}
返回容器列表。 用于[低级别发现](/manual/discovery/low_level_discovery/)。
返回值：*JSON object*。 参数： - **options** - 指定应发现所有容器还是仅发现正在运行的容器。 支持的值：*true* - 返回所有容器；*false* - 仅返回正在运行的容器（默认）。 Agent 2 用户（'zabbix'）必须添加到 'docker' [group](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) 中，以获得足够的权限。 否则，该检查将失败。 [comment]: # ({/08d667eb-39cceff0}) [comment]: # ({0e079948-7a99eb4b}) ##### docker.data.usage {#docker.data.usage}
有关当前数据使用情况的信息。
返回值：以 JSON 序列化的 [SystemDataUsage](https://docs.docker.com/engine/api/v1.28/#operation/SystemDataUsage) API 调用输出。 必须将 Agent 2 用户（'zabbix'）添加到 'docker' [group](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) 中，以获得足够的权限。 否则，该检查将失败。 [comment]: # ({/0e079948-7a99eb4b}) [comment]: # ({051ee3d4-6c71011c}) ##### docker.images {#docker.images}
返回镜像列表。
返回值：[ImageList](https://docs.docker.com/engine/api/v1.28/#operation/ImageList) API 调用序列化后的 JSON 输出。 必须将 Agent 2 用户（'zabbix'）添加到 'docker' [group](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) 中，以获得足够的权限。 否则检查将失败。 [comment]: # ({/051ee3d4-6c71011c}) [comment]: # ({94a965a7-1c03f201}) ##### docker.images.discovery {#docker.images.discovery}
返回镜像列表。 用于[低级别发现](/manual/discovery/low_level_discovery/)。
返回值：*JSON 对象*。 必须将 Agent 2 用户（'zabbix'）添加到 'docker' [组](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user)中，以获得足够的权限。 否则检查将失败。 [comment]: # ({/94a965a7-1c03f201}) [comment]: # ({b067b5fe-d549fed5}) ##### docker.info {#docker.info}
系统信息。
返回值：[SystemInfo](https://docs.docker.com/engine/api/v1.28/#operation/SystemInfo) API 调用的输出，序列化为 JSON。 必须将 Agent 2 用户（'zabbix'）添加到 'docker' [group](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) 中，以获得足够的权限。 否则，该检查将失败。 [comment]: # ({/b067b5fe-d549fed5}) [comment]: # ({0c7a4baa-e8a64d82}) ##### docker.ping {#docker.ping}
测试 Docker 守护进程是否存活。
返回值：*1* - 连接存活；*0* - 连接已断开。 必须将 Agent 2 用户（'zabbix'）添加到 'docker' [组](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) 中，以获得足够的权限。 否则，该检查将失败。 [comment]: # ({/0c7a4baa-e8a64d82}) [comment]: # ({c10d6d06-96264c65}) ##### ember.get[,] {#ember.get}
返回所需设备的结果。
返回值：*JSON 对象*。 参数： - **uri** - Ember+ 设备 URI。 默认值：127.0.0.1:9998;
- **path** - 设备的 OID 路径。 默认为空，返回根集合数据。
[comment]: # ({/c10d6d06-96264c65}) [comment]: # ({7849bde9-d4eb298e}) ##### memcached.ping[connString,,] {#memcached.ping} 测试连接是否存活。 返回值：*1* - 连接存活；*0* - 连接断开（如果出现任何错误，包括 AUTH 和配置问题）。 参数： - **connString** - URI 或会话名称； - **user, password** - Memcached 登录凭据。 [comment]: # ({/7849bde9-d4eb298e}) [comment]: # ({52d1a7a8-ceb374d4}) ##### memcached.stats[connString,,,] {#memcached.stats} 获取 STATS 命令的输出。 返回值：*JSON* - 输出被序列化为 JSON。 参数： - **connString** - URI 或会话名称； - **user, password** - Memcached 登录凭据； - **type** - 要返回的统计类型：*items*、*sizes*、*slabs* 或 *settings*（默认为空，返回一般统计信息）。 [comment]: # ({/52d1a7a8-ceb374d4}) [comment]: # ({96758cfd-ba10c6a3}) ##### mongodb.collection.stats[connString,,,,collection] {#mongodb.collection.stats} 返回给定集合的各种存储统计信息。 返回值：*JSON 对象*。 参数： - **connString** - URI 或会话名称； - **user, password** - MongoDB 登录凭据； - **database** - 数据库名称（默认为 admin）； - **collection** - 集合名称。 [comment]: # ({/96758cfd-ba10c6a3}) [comment]: # ({a531a5df-c2741170}) ##### mongodb.cfg.discovery[connString,,] {#mongodb.cfg.discovery}
返回已发现的配置服务器列表。
返回值：*JSON object*。 参数： - **connString** - URI 或会话名称；
- **user, password** - MongoDB 登录凭据。
[comment]: # ({/a531a5df-c2741170}) [comment]: # ({cd6b8821-d3f908ab}) ##### mongodb.collections.discovery[connString,,] {#mongodb.collections.discovery}
返回已发现集合的列表。 用于[低级别发现](/manual/discovery/low_level_discovery)。
返回值：*JSON 对象*。 参数： - **connString** - URI 或会话名称；
- **user, password** - MongoDB 登录凭据。
[comment]: # ({/cd6b8821-d3f908ab}) [comment]: # ({f403e136-d9af9de6}) ##### mongodb.collections.usage[connString,,] {#mongodb.collections.usage} 返回集合的使用统计信息。 返回值：*JSON 对象*。 参数： - **connString** - URI 或会话名称； - **user, password** - MongoDB 登录凭据。 [comment]: # ({/f403e136-d9af9de6}) [comment]: # ({35a0f44c-20da93d0}) ##### mongodb.connpool.stats[connString,,] {#mongodb.connpool.stats}
返回有关当前数据库实例到分片集群或副本集其他成员的已打开出站连接的信息。
返回值：*JSON 对象*。 参数： - **connString** - URI 或会话名称；
- **user, password** - MongoDB 登录凭据。 [comment]: # ({/35a0f44c-20da93d0}) [comment]: # ({15d8595f-52b800b7}) ##### mongodb.db.stats[connString,,,] {#mongodb.db.stats} 返回反映给定数据库系统状态的统计信息。 返回值：*JSON 对象*。 参数： - **connString** - URI 或会话名称； - **user, password** - MongoDB 登录凭据； - **database** - 数据库名称（默认为 admin）。 [comment]: # ({/15d8595f-52b800b7}) [comment]: # ({3cafe4a6-e12a4df1}) ##### mongodb.db.discovery[connString,,] {#mongodb.db.discovery}
返回已发现数据库的列表。 用于[低级别发现](/manual/discovery/low_level_discovery)。
返回值：*JSON 对象*。 参数： - **connString** - URI 或会话名称；
- **user, password** - MongoDB 登录凭据。
[comment]: # ({/3cafe4a6-e12a4df1}) [comment]: # ({9d00bcc9-2d0db89c}) ##### mongodb.jumbo_chunks.count[connString,,] {#mongodb.jumbo.chunks.count} 返回超大块的计数。 返回值：*JSON 对象*。 参数： - **connString** - URI 或会话名称； - **user, password** - MongoDB 登录凭据。 [comment]: # ({/9d00bcc9-2d0db89c}) [comment]: # ({f8da8fd1-5bb28367}) ##### mongodb.oplog.stats[connString,,] {#mongodb.oplog.stats} 使用从 oplog 中获取的数据返回副本集的状态。 返回值：*JSON 对象*。 参数： - **connString** - URI 或会话名称； - **user, password** - MongoDB 登录凭据。 [comment]: # ({/f8da8fd1-5bb28367}) [comment]: # ({f43ecfdd-57fd60cc}) ##### mongodb.ping[connString,,] {#mongodb.ping} 测试连接是否存活。 返回值：*1* - 连接存活；*0* - 连接断开（如果出现任何错误，包括 AUTH 和配置问题）。 参数： - **connString** - URI 或会话名称； - **user, password** - MongoDB 登录凭据。 [comment]: # ({/f43ecfdd-57fd60cc}) [comment]: # ({0f7e3c66-7bd73d75}) ##### mongodb.rs.config[connString,,] {#mongodb.rs.config} 返回副本集的当前配置。 返回值：*JSON 对象*。 参数： - **connString** - URI 或会话名称； - **user, password** - MongoDB 登录凭据。 [comment]: # ({/0f7e3c66-7bd73d75}) [comment]: # ({ab923404-fbfe0a2b}) ##### mongodb.rs.status[connString,,] {#mongodb.rs.status} 从运行方法的成员的角度返回副本集的状态。 返回值：*JSON 对象*。 参数： - **connString** - URI 或会话名称； - **user, password** - MongoDB 登录凭据。 [comment]: # ({/ab923404-fbfe0a2b}) [comment]: # ({263d5f42-df1e29bd}) ##### mongodb.server.status[connString,,] {#mongodb.server.status} 返回数据库状态。 返回值：*JSON 对象*。 参数： - **connString** - URI 或会话名称； - **user, password** - MongoDB 登录凭据。 [comment]: # ({/263d5f42-df1e29bd}) [comment]: # ({1ffbe870-989959f8}) ##### mongodb.sh.discovery[connString,,] {#mongodb.sh.discovery} 返回集群中存在的已发现 shard 的列表。 返回值：*JSON 对象*。 参数： - **connString** - URI 或会话名称； - **user, password** - MongoDB 登录凭据。 [comment]: # ({/1ffbe870-989959f8}) [comment]: # ({3b5f81c6-28a9c65c}) ##### mongodb.version[connString,,] {#mongodb.version} 返回数据库服务器版本。 返回值：*字符串*。 参数： - **connString** - URI 或会话名称； - **user, password** - MongoDB 登录凭据。 [comment]: # ({/3b5f81c6-28a9c65c}) [comment]: # ({0cfb5384-d1bb976a}) ##### mqtt.get[,topic,,] {#mqtt.get}
订阅所提供 broker 的特定主题或多个主题（支持通配符），并等待发布消息。
返回值：取决于主题内容。 如果使用了通配符，则以 JSON 格式返回主题内容。 参数： - **broker url** - MQTT broker 的 URL，格式为 `protocol://host:port`，不包含查询参数（支持的协议：`tcp`、`ssl`、`ws`）。 如果未指定值，agent 将使用 `tcp://localhost:1883`。 如果省略协议或端口，将分别使用默认协议（`tcp`）或默认端口（`1883`）；
- **topic** - MQTT 主题（必填）。 支持通配符（+,\#）；
- **user, password** - 身份验证凭据（如需要）。
注释： - 该监控项必须配置为[主动检查](/manual/appendix/items/activepassive#active-checks)（“Zabbix agent（主动）”监控项类型）； - 可以通过将 TLS 加密证书保存到默认位置来使用它们（例如 Ubuntu 的 `/etc/ssl/certs/` 目录）。 对于 TLS，请使用 `tls://` 方案。 [comment]: # ({/0cfb5384-d1bb976a}) [comment]: # ({1ebfd6dc-6c398c8e}) ##### mssql.availability.group.get[URI,,] {#mssql-availability-groups}
返回可用性组。
返回值：*JSON object*。 参数： - **URI** - MSSQL 服务器 URI（唯一支持的 schema 是 `sqlserver://`）。 嵌入的凭据将被忽略。 可以将实例名称指定为 URI 的一部分，例如：`sqlserver://localhost/InstanceName`（无端口）。 如果指定了端口，则实例名称将被忽略；
- **user, password** - 用于发送到受保护 MSSQL 服务器的用户名、密码。
更多信息请参见 [MSSQL plugin](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md) 的 readme。 [comment]: # ({/1ebfd6dc-6c398c8e}) [comment]: # ({c0f90266-cd610587}) ##### mssql.custom.query[URI,,,queryName,] {#mssql-custom-query}
返回自定义查询的结果。
返回值：*JSON object*。 参数： - **URI** - MSSQL 服务器 URI（唯一支持的 schema 是 `sqlserver://`）。 嵌入的凭据将被忽略。 可以将实例名称指定为 URI 的一部分，例如：`sqlserver://localhost/InstanceName`（无端口）。 如果指定了端口，则实例名称将被忽略；
- **user, password** - 要发送到受保护 MSSQL 服务器的用户名、密码；
- **queryName** - 在 `Plugins.MSSQL.CustomQueriesDir` 中配置的自定义查询名称，不包含 .sql 扩展名；
- **args** - 传递给查询的一个或多个以逗号分隔的参数。 更多信息请参见 [MSSQL plugin](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md) readme。 [comment]: # ({/c0f90266-cd610587}) [comment]: # ({874a4ac9-2ccaed02}) ##### mssql.db.get {#mssql-db} 返回所有可用的 MSSQL 数据库。 返回值：*JSON 对象*。 有关更多信息，请参阅[MSSQL 插件](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md)的自述文件。 [comment]: # ({/874a4ac9-2ccaed02}) [comment]: # ({50a1dbd5-9a01c58d}) ##### mssql.job.status.get {#mssql-job-status} 返回作业的状态。 返回值：*JSON 对象*。 有关更多信息，请参阅[MSSQL 插件](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md)的自述文件。 [comment]: # ({/50a1dbd5-9a01c58d}) [comment]: # ({ad17438c-82f6b4a7}) ##### mssql.last.backup.get {#mssql-last-backup} 返回所有数据库的最后备份时间。 返回值：*JSON 对象*。 有关更多信息，请参阅[MSSQL 插件](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md)的自述文件。 [comment]: # ({/ad17438c-82f6b4a7}) [comment]: # ({119e0c81-e113d3b4}) ##### mssql.local.db.get {#mssql-local-db} 返回参与 Always On 可用性组和副本（主要或次要）并位于建立连接的服务器上的数据库。 返回值：*JSON 对象*。 有关更多信息，请参阅[MSSQL 插件](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md)的自述文件。 [comment]: # ({/119e0c81-e113d3b4}) [comment]: # ({fac5053e-fe193722}) ##### mssql.mirroring.get {#mssql-mirroring} 返回镜像信息。 返回值：*JSON 对象*。 有关更多信息，请参阅[MSSQL 插件](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md)的自述文件。 [comment]: # ({/fac5053e-fe193722}) [comment]: # ({d379eab8-0473c1ed}) ##### mssql.nonlocal.db.get {#mssql-nonlocal-db} 返回参与 Always On 可用性组和副本（主要或次要）并位于其他服务器上（数据库不是连接建立到的 SQL Server 实例的本地数据库）的数据库。 返回值：*JSON 对象*。 有关更多信息，请参阅[MSSQL 插件](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md)的自述文件。 [comment]: # ({/d379eab8-0473c1ed}) [comment]: # ({c4292e4e-57c1330b}) ##### mssql.perfcounter.get {#mssql-perfcounter} 返回性能计数器。 返回值：*JSON 对象*。 有关更多信息，请参阅[MSSQL 插件](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md)的自述文件。 [comment]: # ({/c4292e4e-57c1330b}) [comment]: # ({ed983ed6-b73763b6}) ##### mssql.ping {#mssql-ping}
Ping 数据库。 测试连接是否已正确配置。
返回值：*1* - 存活，*0* - 不存活。 更多信息请参见 [MSSQL plugin](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md) 的 readme。 [comment]: # ({/ed983ed6-b73763b6}) [comment]: # ({b29515d5-6dcbc5f2}) ##### mssql.quorum.get {#mssql-quorum} 返回仲裁信息。 返回值：*JSON 对象*。 有关更多信息，请参阅[MSSQL 插件](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md)的自述文件。 [comment]: # ({/b29515d5-6dcbc5f2}) [comment]: # ({389acfa0-deb94054}) ##### mssql.quorum.member.get {#mssql-quorum-member} 返回仲裁成员。 返回值：*JSON 对象*。 有关更多信息，请参阅[MSSQL 插件](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md)的自述文件。 [comment]: # ({/389acfa0-deb94054}) [comment]: # ({cdf515f8-33120c2e}) ##### mssql.replica.get {#mssql-replica} 返回副本。 返回值：*JSON 对象*。 有关更多信息，请参阅[MSSQL 插件](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md)的自述文件。 [comment]: # ({/cdf515f8-33120c2e}) [comment]: # ({68d3576b-c4cbbde9}) ##### mssql.version {#mssql-version} 返回 MSSQL 版本。 返回值：*字符串*。 有关更多信息，请参阅[MSSQL 插件](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md)的自述文件。 [comment]: # ({/68d3576b-c4cbbde9}) [comment]: # ({10629927-mysql}) ##### mysql.custom.query[connString,,,queryName,] {#mysql.custom.query}
返回自定义查询的结果。
返回值：*JSON 对象*。 参数： - **connString** - URI 或会话名称；
- **user, password** - MySQL 登录凭据；
- **queryName** - 自定义查询的名称，必须与不带扩展名的 SQL 文件名匹配；
- **args** - 传递给查询的一个或多个以逗号分隔的参数。 更多信息请参见 [MySQL plugin](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/mysql/README.md) 的 readme 中的 *Custom queries* 部分。 [comment]: # ({/10629927-mysql}) [comment]: # ({a13b93a2-87221485}) ##### mysql.db.discovery[connString,,] {#mysql.db.discovery}
返回 MySQL 数据库列表。 用于[低级别发现](/manual/discovery/low_level_discovery)。
返回值："show databases" SQL 查询的结果，采用 LLD JSON 格式。 参数： - **connString** - URI 或会话名称；
- **user, password** - MySQL 登录凭据。
[comment]: # ({/a13b93a2-87221485}) [comment]: # ({7e0d7805-661ad031}) ##### mysql.db.size[connString,,,] {#mysql.db.size} 数据库大小（字节）。 返回值：针对特定数据库的"select coalesce(sum(data_length + index_length),0) as size from information_schema.tables where table_schema=?" SQL查询的结果，以字节为单位。 参数： - **connString** - URI 或会话名称；
- **user, password** - MySQL 登录凭据；
- **database name** - 数据库名称。 [comment]: # ({/7e0d7805-661ad031}) [comment]: # ({a3ee5128-c135cdf1}) ##### mysql.get_status_variables[connString,,] {#mysql.get.status.variables} 全局状态变量的值。 返回值：以 JSON 格式呈现的"show global status" SQL 查询的结果。 参数： - **connString** - URI 或会话名称；
- **user, password** - MySQL 登录凭据。
[comment]: # ({/a3ee5128-c135cdf1}) [comment]: # ({a67f6196-353c20ea}) ##### mysql.ping[connString,,] {#mysql.ping} 测试连接是否存活。 返回值：*1* - 连接存活；*0* - 连接中断（如果出现任何错误，包括 AUTH 和配置问题）。 参数： - **connString** - URI 或会话名称；
- **user, password** - MySQL 登录凭据。
[comment]: # ({/a67f6196-353c20ea}) [comment]: # ({c3d8cc27-baf67c1f}) ##### mysql.replication.discovery[connString,,] {#mysql.replication.discovery}
返回 MySQL 复制列表。 用于[低级别发现](/manual/discovery/low_level_discovery)。
返回值：`SHOW SLAVE STATUS` 或 `SHOW REPLICA STATUS` SQL 查询的结果，采用 LLD JSON 格式。 参数： - **connString** - URI 或会话名称；
- **user, password** - MySQL 登录凭据。
[comment]: # ({/c3d8cc27-baf67c1f}) [comment]: # ({0573bd0e-90f6ce4d}) ##### mysql.replication.get_slave_status[connString,,,] {#mysql.replication.get.slave.status}
复制状态。
返回值：`SHOW SLAVE STATUS` 或 `SHOW REPLICA STATUS` SQL 查询的结果，采用 JSON 格式。 参数： - **connString** - URI 或会话名称；
- **user, password** - MySQL 登录凭据；
- **master host** - 复制主机的主机名。 如果未找到，则返回错误。 如果未指定此参数，则返回所有主机。
[comment]: # ({/0573bd0e-90f6ce4d}) [comment]: # ({9a93a3c2-f55a22aa}) ##### mysql.version[connString,,] {#mysql.version} MySQL 版本。 返回值：*字符串*（包含 MySQL 实例的版本号）。 参数： - **connString** - URI 或会话名称；
- **user, password** - MySQL 登录凭据。
[comment]: # ({/9a93a3c2-f55a22aa}) [comment]: # ({55820a04-0afa530f}) ##### net.dns.get[,name,,,,,""] {#net.dns.get} 执行 DNS 查询并返回详细的 DNS 记录信息。
此监控项是 [`net.dns.record`](/manual/config/items/itemtypes/zabbix_agent#net.dns.record) Zabbix agent 监控项的扩展版本，支持更多记录类型和可自定义的标志。
返回值：*JSON object* 参数： - **ip** - DNS 服务器的 IP 地址（留空则使用默认 DNS 服务器）； - **name** - 要查询的 DNS 名称； - **type** - 要查询的记录类型（默认是 *SOA*）； - **timeout** - 请求超时时间，单位为秒（默认是 1 秒）； - **count** - 请求重试次数（默认是 2）； - **protocol** - 用于执行 DNS 查询的协议：*udp*（默认）或 *tcp*； - **flags** - 一个或多个以逗号分隔的参数，用于传递给查询。 注释： - `type` 的可选值为：*A*, *NS*, *MD*, *MF*, *CNAME*, *SOA*, *MB*, *MG*, *MR*, *NULL*, *PTR*, *HINFO*, *MINFO*, *MX*, *TXT*, *RP*, *AFSDB*, *X25*, *ISDN*, *RT*, *NSAPPTR*, *SIG*, *KEY*, *PX*, *GPOS*, *AAAA*, *LOC*, *NXT*, *EID*, *NIMLOC*, *SRV*, *ATMA*, *NAPTR*, *KX*, *CERT*, *DNAME*, *OPT*, *APL*, *DS*, *SSHFP*, *IPSECKEY*, *RRSIG*, *NSEC*, *DNSKEY*, *DHCID*, *NSEC3*, *NSEC3PARAM*, *TLSA*, *SMIMEA*, *HIP*, *NINFO*, *RKEY*, *TALINK*, *CDS*, *CDNSKEY*, *OPENPGPKEY*, *CSYNC*, *ZONEMD*, *SVCB*, *HTTPS*, *SPF*, *UINFO*, *UID*, *GID*, *UNSPEC*, *NID*, *L32*, *L64*, *LP*, *EUI48*, *EUI64*, *URI*, *CAA*, *AVC*, *AMTRELAY*。 请注意，值必须全部使用大写；不支持小写或大小写混合的值。 - 对于反向 DNS 查询（当 `type` 设置为 *PTR* 时），您可以同时以反向和非反向格式提供 DNS 名称（请参见下方示例）。 请注意，当请求 PTR 记录时，DNS 名称实际上是一个 IP 地址。 - `flags` 的可选值为：*cdflag* 或 *nocdflag*（默认）、*rdflag*（默认）或 *nordflag*、*dnssec* 或 *nodnssec*（默认）、*nsid* 或 *nonsid*（默认）、*edns0*（默认）或 *noedns0*、*aaflag* 或 *noaaflag*（默认）、*adflag* 或 *noadflag*（默认）。 `flags` 中的 *dnssec* 和 *nsid* 不能与 *noedns0* 一起使用，因为它们都需要 *edns0*。 请注意，值必须全部使用小写；不支持大写或大小写混合的值。 - 不支持国际化域名，请改用 IDNA 编码后的名称。 - 输出为一个对象，其中包含基于所提供参数的 DNS 记录信息（请参见[更多详情](/manual/appendix/items/return_values_net_dns_get)）。 示例： ```bash net.dns.get[192.0.2.1,example.com,DNSKEY,3,3,tcp,"cdflag,rdflag,nsid"] net.dns.get[,198.51.100.1,PTR,,,,"cdflag,rdflag,nsid"] net.dns.get[,1.100.51.198.in-addr.arpa,PTR,,,,"cdflag,rdflag,nsid"] net.dns.get[,2a00:1450:400f:800::200e,PTR,,,,"cdflag,rdflag,nsid"] net.dns.get[,e.0.0.2.0.0.0.0.0.0.0.0.0.0.0.0.0.0.8.0.f.0.0.4.0.5.4.1.0.0.a.2.ip6.arpa,PTR,,,,"cdflag,rdflag,nsid"] ``` [comment]: # ({/55820a04-0afa530f}) [comment]: # ({f24b03ed-40f692b9}) ##### nvml.device.count {#nvml.device.count}
GPU 设备的数量。
返回值：*整数*。 更多信息请参见 [NVIDIA GPU plugin](https://git.zabbix.com/projects/AP/repos/nvidia-gpu/browse/README.md) 的 readme。 [comment]: # ({/f24b03ed-40f692b9}) [comment]: # ({2e141d53-d5e2912c}) ##### nvml.device.decoder.utilization[] {#nvml.device.decoder.utilization}
GPU 设备解码器利用率，以百分比表示。
返回值：*Integer*。 参数： - **deviceUUID** - GPU 设备 UUID。 更多信息请参见 [NVIDIA GPU plugin](https://git.zabbix.com/projects/AP/repos/nvidia-gpu/browse/README.md) 的 readme。 [comment]: # ({/2e141d53-d5e2912c}) [comment]: # ({d5a0c7dd-8a64cddd}) ##### nvml.device.ecc.mode[] {#nvml.device.ecc.mode}
GPU 设备 ECC 模式信息（当前、待定）。
返回值：*JSON*。 参数： - **deviceUUID** - GPU 设备 UUID。 更多信息请参见 [NVIDIA GPU plugin](https://git.zabbix.com/projects/AP/repos/nvidia-gpu/browse/README.md) 的 readme。 [comment]: # ({/d5a0c7dd-8a64cddd}) [comment]: # ({7f9d813f-6f7efb45}) ##### nvml.device.encoder.stats.get[] {#nvml.device.encoder.stats.get}
GPU 设备编码器统计信息。
返回值：*JSON*。 参数： - **deviceUUID** - GPU 设备 UUID。 更多信息请参见 [NVIDIA GPU plugin](https://git.zabbix.com/projects/AP/repos/nvidia-gpu/browse/README.md) 的 readme。 [comment]: # ({/7f9d813f-6f7efb45}) [comment]: # ({e9a9f3ef-1ba27c5b}) ##### nvml.device.encoder.utilization[] {#nvml.device.encoder.utilization}
GPU 设备编码器利用率，以百分比表示。
返回值：*Integer*。 参数： - **deviceUUID** - GPU 设备 UUID。 更多信息请参见 [NVIDIA GPU plugin](https://git.zabbix.com/projects/AP/repos/nvidia-gpu/browse/README.md) 的 readme。 [comment]: # ({/e9a9f3ef-1ba27c5b}) [comment]: # ({dbfde7df-35c67b3d}) ##### nvml.device.energy.consumption[] {#nvml.device.energy.consumption}
自驱动程序上次重新加载以来，GPU 设备的总能耗，单位为毫焦耳（mJ）。
返回值：*整数*。 参数： - **deviceUUID** - GPU 设备 UUID。 更多信息请参见 [NVIDIA GPU plugin](https://git.zabbix.com/projects/AP/repos/nvidia-gpu/browse/README.md) 的 readme。 [comment]: # ({/dbfde7df-35c67b3d}) [comment]: # ({214b7a76-2a82aff7}) ##### nvml.device.errors.memory[] {#nvml.device.errors.memory}
GPU 设备 ECC 内存错误信息（已纠正、未纠正）。
返回值：*JSON*。 参数： - **deviceUUID** - GPU 设备 UUID。 更多信息请参见 [NVIDIA GPU plugin](https://git.zabbix.com/projects/AP/repos/nvidia-gpu/browse/README.md) 的 readme。 [comment]: # ({/214b7a76-2a82aff7}) [comment]: # ({884aca04-120ede98}) ##### nvml.device.errors.register[] {#nvml.device.errors.register}
GPU 设备 ECC 寄存器错误信息（已纠正、未纠正）。
返回值：*JSON*。 参数： - **deviceUUID** - GPU 设备 UUID。 更多信息请参见 [NVIDIA GPU plugin](https://git.zabbix.com/projects/AP/repos/nvidia-gpu/browse/README.md) 的 readme。 [comment]: # ({/884aca04-120ede98}) [comment]: # ({2e60ccea-6d4e9c63}) ##### nvml.device.fan.speed.avg[] {#nvml.device.fan.speed.avg}
GPU 设备平均风扇转速，以最大转速的百分比表示。
返回值：*整数*。 参数： - **deviceUUID** - GPU 设备 UUID。 更多信息请参见 [NVIDIA GPU plugin](https://git.zabbix.com/projects/AP/repos/nvidia-gpu/browse/README.md) 的 readme。 [comment]: # ({/2e60ccea-6d4e9c63}) [comment]: # ({88899cae-41c85aa3}) ##### nvml.device.get {#nvml.device.get}
发现的 GPU 及其 UUID 和名称。
返回值：*JSON*。 更多信息请参见 [NVIDIA GPU plugin](https://git.zabbix.com/projects/AP/repos/nvidia-gpu/browse/README.md) 的 readme。 [comment]: # ({/88899cae-41c85aa3}) [comment]: # ({d16d64f1-2dc80dfe}) ##### nvml.device.graphics.frequency[] {#nvml.device.graphics.frequency}
GPU 设备图形时钟频率，单位为 MHz。
返回值：*整数*。 参数： - **deviceUUID** - GPU 设备 UUID。 更多信息请参见 [NVIDIA GPU plugin](https://git.zabbix.com/projects/AP/repos/nvidia-gpu/browse/README.md) 的 readme。 [comment]: # ({/d16d64f1-2dc80dfe}) [comment]: # ({ecf6e640-7678aa5b}) ##### nvml.device.memory.fb.get[] {#nvml.device.memory.fb.get}
GPU 设备帧缓冲区内存统计信息（总量、保留、空闲、已使用）。
返回值：*JSON*。 参数： - **deviceUUID** - GPU 设备 UUID。 更多信息请参见 [NVIDIA GPU plugin](https://git.zabbix.com/projects/AP/repos/nvidia-gpu/browse/README.md) 自述文件。 [comment]: # ({/ecf6e640-7678aa5b}) [comment]: # ({e510a010-dfd277cb}) ##### nvml.device.memory.bar1.get[] {#nvml.device.memory.bar1.get}
GPU 设备 BAR1 内存统计信息（总量、空闲、已使用）。
返回值：*JSON*。 参数： - **deviceUUID** - GPU 设备 UUID。 更多信息请参见 [NVIDIA GPU plugin](https://git.zabbix.com/projects/AP/repos/nvidia-gpu/browse/README.md) 的 readme。 [comment]: # ({/e510a010-dfd277cb}) [comment]: # ({b23d8f7e-8129b4cd}) ##### nvml.device.memory.frequency[] {#nvml.device.memory.frequency}
GPU 设备显存时钟频率，单位为 MHz。
返回值：*整数*。 参数： - **deviceUUID** - GPU 设备 UUID。 更多信息请参见 [NVIDIA GPU plugin](https://git.zabbix.com/projects/AP/repos/nvidia-gpu/browse/README.md) 的 readme。 [comment]: # ({/b23d8f7e-8129b4cd}) [comment]: # ({be79b15e-7481e512}) ##### nvml.device.pci.utilization[] {#nvml.device.pci.utilization}
GPU 设备 PCI 利用率（发送/接收吞吐量，单位为 KBps）。
返回值：*JSON*。 参数： - **deviceUUID** - GPU 设备 UUID。 更多信息请参见 [NVIDIA GPU plugin](https://git.zabbix.com/projects/AP/repos/nvidia-gpu/browse/README.md) 的 readme。 [comment]: # ({/be79b15e-7481e512}) [comment]: # ({38dbecea-a121c018}) ##### nvml.device.performance.state[] {#nvml.device.performance.state}
GPU 设备性能状态。
返回值：*整数*。 参数： - **deviceUUID** - GPU 设备 UUID。 更多信息请参见 [NVIDIA GPU plugin](https://git.zabbix.com/projects/AP/repos/nvidia-gpu/browse/README.md) 的 readme。 [comment]: # ({/38dbecea-a121c018}) [comment]: # ({657b555b-4efdea9a}) ##### nvml.device.power.limit[] {#nvml.device.power.limit}
GPU 设备功率限制，单位为毫瓦。
返回值：*整数*。 参数： - **deviceUUID** - GPU 设备 UUID。 更多信息请参见 [NVIDIA GPU plugin](https://git.zabbix.com/projects/AP/repos/nvidia-gpu/browse/README.md) 的 readme。 [comment]: # ({/657b555b-4efdea9a}) [comment]: # ({2282c8cc-4d35097d}) ##### nvml.device.power.usage[] {#nvml.device.power.usage}
GPU 设备当前功耗，单位为毫瓦。
返回值：*Integer*。 参数： - **deviceUUID** - GPU 设备 UUID。 更多信息请参见 [NVIDIA GPU plugin](https://git.zabbix.com/projects/AP/repos/nvidia-gpu/browse/README.md) 的 readme。 [comment]: # ({/2282c8cc-4d35097d}) [comment]: # ({39f12cea-ebda41bb}) ##### nvml.device.serial[] {#nvml.device.serial}
GPU 设备序列号。
返回值：*String*。 参数： - **deviceUUID** - GPU 设备 UUID。 更多信息请参见 [NVIDIA GPU plugin](https://git.zabbix.com/projects/AP/repos/nvidia-gpu/browse/README.md) 的 readme。 [comment]: # ({/39f12cea-ebda41bb}) [comment]: # ({2c3208d8-a8d8521e}) ##### nvml.device.sm.frequency[] {#nvml.device.sm.frequency}
GPU 设备流式多处理器时钟频率，单位为 MHz。
返回值：*Integer*。 参数： - **deviceUUID** - GPU 设备 UUID。 更多信息请参见 [NVIDIA GPU plugin](https://git.zabbix.com/projects/AP/repos/nvidia-gpu/browse/README.md) 的 readme。 [comment]: # ({/2c3208d8-a8d8521e}) [comment]: # ({01b520d1-c92d3df2}) ##### nvml.device.temperature[] {#nvml.device.temperature}
GPU 设备温度，单位为摄氏度。
返回值：*Integer*。 参数： - **deviceUUID** - GPU 设备 UUID。 更多信息请参见 [NVIDIA GPU plugin](https://git.zabbix.com/projects/AP/repos/nvidia-gpu/browse/README.md) 的 readme。 [comment]: # ({/01b520d1-c92d3df2}) [comment]: # ({388b877d-62de991d}) ##### nvml.device.utilization[] {#nvml.device.utilization}
GPU 设备利用率统计信息（GPU/内存利用率，以百分比表示）。
返回值：*JSON*。 参数： - **deviceUUID** - GPU 设备 UUID。 更多信息请参见 [NVIDIA GPU plugin](https://git.zabbix.com/projects/AP/repos/nvidia-gpu/browse/README.md) 的 readme。 [comment]: # ({/388b877d-62de991d}) [comment]: # ({7a2f98eb-4c2edd00}) ##### nvml.device.video.frequency[] {#nvml.device.video.frequency}
GPU 设备视频时钟频率，单位为 MHz。
返回值：*整数*。 参数： - **deviceUUID** - GPU 设备 UUID。 更多信息请参见 [NVIDIA GPU plugin](https://git.zabbix.com/projects/AP/repos/nvidia-gpu/browse/README.md) 的 readme。 [comment]: # ({/7a2f98eb-4c2edd00}) [comment]: # ({f7a800a0-e2275873}) ##### nvml.system.driver.version {#nvml.system.driver.version}
NVIDIA 驱动程序版本。
返回值：*String*。 更多信息请参见 [NVIDIA GPU plugin](https://git.zabbix.com/projects/AP/repos/nvidia-gpu/browse/README.md) 的 readme。 [comment]: # ({/f7a800a0-e2275873}) [comment]: # ({98e7c317-deed64b3}) ##### nvml.version {#nvml.version}
NVML 库版本。
返回值：*String*。 更多信息请参见 [NVIDIA GPU plugin](https://git.zabbix.com/projects/AP/repos/nvidia-gpu/browse/README.md) 的 readme。 [comment]: # ({/98e7c317-deed64b3}) [comment]: # ({aeed8ddf-9773f5ca}) ##### oracle.diskgroups.stats[connString,,,,] {#oracle.diskgroups.stats}
返回 Automatic Storage Management (ASM) 磁盘组统计信息。
返回值：*JSON object*。 参数： - **connString** - 可以是：
- URI - 如果未找到具有给定名称的会话，且 `Plugins.Oracle.ResolveTNS` 设置为 false。 如果它包含 schema（例如 "tcp://"）、端口（例如 1521）或两者都包含，则不会考虑 ResolveTNS 选项，并且无论如何都会将其视为 URI；
- 会话名称 - 如果在插件配置文件中找到了该名称；
- TNS 键 - 如果 ResolveTNS 选项设置为 true，且上述条件均不适用；
- TNS 值 - 如果它以左括号 "(" 开头（忽略前导空格）。 在这种情况下，不会考虑 ResolveTNS 选项。
- **user** - Oracle 用户名，支持按 `user as sysdba` 格式追加以下登录选项之一：`as sysdba`、`as sysoper`、`as sysasm`、`as sysbackup`、`as sysdg`、`as syskm` 或 `as sysrac`（登录选项不区分大小写，末尾不得包含空格）。
- **password** - Oracle 密码；
- **service** - Oracle 服务名称；
- **diskgroup** - 要查询的 ASM 磁盘组名称。 [comment]: # ({/aeed8ddf-9773f5ca}) [comment]: # ({2285c948-ecd5f683}) ##### oracle.diskgroups.discovery[connString,,,] {#oracle.diskgroups.discovery}
返回 ASM 磁盘组列表。 用于[低级别发现](/manual/discovery/low_level_discovery)。
返回值：*JSON object*。 参数： - **connString** - 可以是：
- URI - 如果未找到具有给定名称的会话，且 `Plugins.Oracle.ResolveTNS` 设置为 false。 如果它包含 schema（例如 "tcp://"）、端口（例如 1521）或两者都包含，则不会考虑 ResolveTNS 选项，并且无论如何都会将其视为 URI；
- 会话名称 - 如果在插件配置文件中找到了该名称；
- TNS 键 - 如果 ResolveTNS 选项设置为 true，且上述条件均不适用；
- TNS 值 - 如果它以左括号 "(" 开头（忽略前导空格）。 在这种情况下，不会考虑 ResolveTNS 选项。
- **user** - Oracle 用户名，支持以 `user as sysdba` 格式附加以下登录选项之一：`as sysdba`、`as sysoper`、`as sysasm`、`as sysbackup`、`as sysdg`、`as syskm` 或 `as sysrac`（登录选项不区分大小写，末尾不得包含空格）。
- **password** - Oracle 密码；
- **service** - Oracle 服务名称。
[comment]: # ({/2285c948-ecd5f683}) [comment]: # ({aa297ed1-dcf5ffe2}) ##### oracle.archive.info[connString,,,,] {#oracle.archive.info}
归档日志统计信息。
返回值：*JSON object*。 参数： - **connString** - 可以是：
- URI - 如果未找到具有给定名称的会话，且 `Plugins.Oracle.ResolveTNS` 设置为 false。 如果其包含 schema（例如 "tcp://"）、端口（例如 1521）或两者都包含，则不会考虑 ResolveTNS 选项，并且无论如何都会将其视为 URI；
- 会话名称 - 如果在插件配置文件中找到了该名称；
- TNS 键 - 如果 ResolveTNS 选项设置为 true，且上述条件均不适用；
- TNS 值 - 如果它以左括号 "(" 开头（忽略前导空格）。 在这种情况下，不会考虑 ResolveTNS 选项。
- **user** - Oracle 用户名，支持以 `user as sysdba` 格式附加以下任一登录选项：`as sysdba`、`as sysoper`、`as sysasm`、`as sysbackup`、`as sysdg`、`as syskm` 或 `as sysrac`（登录选项不区分大小写，末尾不得包含空格）。
- **password** - Oracle 密码；
- **service** - Oracle 服务名称；
- **destination** - 要查询的目标名称。 [comment]: # ({/aa297ed1-dcf5ffe2}) [comment]: # ({491a2fee-a1afc726}) ##### oracle.cdb.info[connString,,,,] {#oracle.cdb.info}
容器数据库（CDB）信息。
返回值：*JSON object*。 参数： - **connString** - 可以是：
- URI - 如果未找到具有给定名称的会话，且 `Plugins.Oracle.ResolveTNS` 设置为 false。 如果其包含 schema（例如 "tcp://"）、端口（例如 1521）或两者都包含，则不会考虑 ResolveTNS 选项，并且无论如何都会将其视为 URI；
- 会话名称 - 如果在插件配置文件中找到了该名称；
- TNS 键 - 如果 ResolveTNS 选项设置为 true，且上述条件均不适用；
- TNS 值 - 如果其以左括号 "(" 开头（忽略前导空格）。 在这种情况下，不会考虑 ResolveTNS 选项。
- **user** - Oracle 用户名，支持以 `user as sysdba` 格式附加以下登录选项之一：`as sysdba`、`as sysoper`、`as sysasm`、`as sysbackup`、`as sysdg`、`as syskm` 或 `as sysrac`（登录选项不区分大小写，末尾不得包含空格）。
- **password** - Oracle 密码；
- **service** - Oracle 服务名称；
- **database** - 要查询的数据库名称。 [comment]: # ({/491a2fee-a1afc726}) [comment]: # ({85592244-83723c39}) ##### oracle.custom.query[connString,,,,queryName,] {#oracle.custom.query}
自定义查询的结果。
返回值：*JSON object*。 参数： - **connString** - 可以是：
- URI - 如果未找到具有给定名称的会话，且 `Plugins.Oracle.ResolveTNS` 设置为 false。 如果它包含 schema（例如 "tcp://"）、端口（例如 1521）或两者都包含，则不会考虑 ResolveTNS 选项，并且无论如何都会将其视为 URI；
- 会话名称 - 如果在插件配置文件中找到了此名称；
- TNS 键 - 如果 ResolveTNS 选项设置为 true，且上述条件均不适用；
- TNS 值 - 如果它以左括号 "(" 开头（忽略前导空格）。 在这种情况下，不会考虑 ResolveTNS 选项。
- **user** - Oracle 用户名，支持按 `user as sysdba` 格式追加以下登录选项之一：`as sysdba`、`as sysoper`、`as sysasm`、`as sysbackup`、`as sysdg`、`as syskm` 或 `as sysrac`（登录选项不区分大小写，末尾不得包含空格）。
- **password** - Oracle 密码；
- **service** - Oracle 服务名称；
- **queryName** - 自定义查询的名称，必须与不带扩展名的 SQL 文件名匹配；
- **args** - 传递给查询的一个或多个以逗号分隔的参数。 注释： - 返回的数据会自动转换为 JSON。 - 避免让查询直接返回 JSON，因为当插件再次尝试将其转换为 JSON 时，它会被破坏。 [comment]: # ({/85592244-83723c39}) [comment]: # ({2554cf65-ef413040}) ##### oracle.datafiles.stats[connString,,,] {#oracle.datafiles.stats}
返回数据文件统计信息。
返回值：*JSON object*。 参数： - **connString** - 可以是：
- URI - 如果未找到具有给定名称的会话，且 `Plugins.Oracle.ResolveTNS` 设置为 false。 如果其包含 schema（例如 "tcp://"）、端口（例如 1521）或两者都包含，则不会考虑 ResolveTNS 选项，并且无论如何都会将其视为 URI；
- 会话名称 - 如果在插件配置文件中找到了该名称；
- TNS 键 - 如果 ResolveTNS 选项设置为 true，且上述条件均不适用；
- TNS 值 - 如果其以左括号 "(" 开头（忽略前导空格）。 在这种情况下，不会考虑 ResolveTNS 选项。
- **user** - Oracle 用户名，支持以 `user as sysdba` 格式附加以下登录选项之一：`as sysdba`、`as sysoper`、`as sysasm`、`as sysbackup`、`as sysdg`、`as syskm` 或 `as sysrac`（登录选项不区分大小写，且末尾不得包含空格）。
- **password** - Oracle 密码；
- **service** - Oracle 服务名称。 [comment]: # ({/2554cf65-ef413040}) [comment]: # ({e6a1679c-3aee96da}) ##### oracle.db.discovery[connString,,,] {#oracle.db.discovery}
返回数据库列表。 用于[低级别发现](/manual/discovery/low_level_discovery)。
返回值：*JSON 对象*。 参数： - **connString** - 可以是：
- URI - 如果未找到具有给定名称的会话，且 `Plugins.Oracle.ResolveTNS` 设置为 false。 如果它包含 schema（例如 "tcp://"）、端口（例如 1521）或两者都包含，则不会考虑 ResolveTNS 选项，并且无论如何都会将其视为 URI；
- 会话名称 - 如果在插件配置文件中找到了该名称；
- TNS 键 - 如果 ResolveTNS 选项设置为 true，且上述条件均不适用；
- TNS 值 - 如果它以左括号 "(" 开头（忽略前导空格）。 在这种情况下，不会考虑 ResolveTNS 选项。
- **user** - Oracle 用户名，支持以 `user as sysdba` 格式附加以下登录选项之一：`as sysdba`、`as sysoper`、`as sysasm`、`as sysbackup`、`as sysdg`、`as syskm` 或 `as sysrac`（登录选项不区分大小写，末尾不得包含空格）。
- **password** - Oracle 密码；
- **service** - Oracle 服务名称。
[comment]: # ({/e6a1679c-3aee96da}) [comment]: # ({d3ca6819-d1925e26}) ##### oracle.fra.stats[connString,,,] {#oracle.fra.stats}
返回快速恢复区（FRA）统计信息。
返回值：*JSON object*。 参数： - **connString** - 可以是：
- URI - 如果未找到具有给定名称的会话，且 `Plugins.Oracle.ResolveTNS` 设置为 false。 如果其包含 schema（例如 "tcp://"）、端口（例如 1521）或两者都包含，则不会考虑 ResolveTNS 选项，并且仍将其视为 URI；
- 会话名称 - 如果在插件配置文件中找到了该名称；
- TNS 键 - 如果 ResolveTNS 选项设置为 true，且上述条件均不适用；
- TNS 值 - 如果其以左括号 "(" 开头（忽略前导空格）。 在这种情况下，不会考虑 ResolveTNS 选项。
- **user** - Oracle 用户名，支持以 `user as sysdba` 格式附加以下任一登录选项：`as sysdba`、`as sysoper`、`as sysasm`、`as sysbackup`、`as sysdg`、`as syskm` 或 `as sysrac`（登录选项不区分大小写，末尾不得包含空格）。
- **password** - Oracle 密码；
- **service** - Oracle 服务名称。
[comment]: # ({/d3ca6819-d1925e26}) [comment]: # ({190cde67-d0b09033}) ##### oracle.instance.info[connString,,,] {#oracle.instance.info}
实例统计信息。
返回值：*JSON object*。 参数： - **connString** - 可以是：
- URI - 如果未找到具有给定名称的会话，且 `Plugins.Oracle.ResolveTNS` 设置为 false。 如果其包含 schema（例如 "tcp://"）、端口（例如 1521）或两者，则不会考虑 ResolveTNS 选项，并且无论如何都会将其视为 URI；
- 会话名称 - 如果在插件配置文件中找到了该名称；
- TNS 键 - 如果 ResolveTNS 选项设置为 true，且上述条件均不适用；
- TNS 值 - 如果其以左括号 "(" 开头（忽略前导空格）。 在这种情况下，不会考虑 ResolveTNS 选项。
- **user** - Oracle 用户名，支持按 `user as sysdba` 格式追加以下登录选项之一：`as sysdba`、`as sysoper`、`as sysasm`、`as sysbackup`、`as sysdg`、`as syskm` 或 `as sysrac`（登录选项不区分大小写，末尾不得包含空格）。
- **password** - Oracle 密码；
- **service** - Oracle 服务名称。
[comment]: # ({/190cde67-d0b09033}) [comment]: # ({ad1bc87d-e6cb70e2}) ##### oracle.pdb.info[connString,,,,] {#oracle.pdb.info}
可插拔数据库（PDB）信息。
返回值：*JSON object*。 参数： - **connString** - 可以是：
- URI - 如果未找到具有给定名称的会话，且 `Plugins.Oracle.ResolveTNS` 设置为 false。 如果它包含 schema（例如 "tcp://"）、端口（例如 1521）或两者都包含，则不会考虑 ResolveTNS 选项，并且无论如何都会将其视为 URI；
- 会话名称 - 如果在插件配置文件中找到了该名称；
- TNS 键 - 如果 ResolveTNS 选项设置为 true，且上述条件均不适用；
- TNS 值 - 如果它以左括号 "(" 开头（忽略前导空格）。 在这种情况下，不会考虑 ResolveTNS 选项。
- **user** - Oracle 用户名，支持按 `user as sysdba` 格式追加以下任一登录选项：`as sysdba`、`as sysoper`、`as sysasm`、`as sysbackup`、`as sysdg`、`as syskm` 或 `as sysrac`（登录选项不区分大小写，末尾不得包含空格）。
- **password** - Oracle 密码；
- **service** - Oracle 服务名；
- **database** - 要查询的数据库名称。 [comment]: # ({/ad1bc87d-e6cb70e2}) [comment]: # ({8be9c788-7cabfeb8}) ##### oracle.pdb.discovery[connString,,,] {#oracle.pdb.discovery}
返回 PDB 列表。 用于[低级别发现](/manual/discovery/low_level_discovery)。
返回值：*JSON object*。 参数： - **connString** - 可以是：
- URI - 如果未找到具有给定名称的会话，且 `Plugins.Oracle.ResolveTNS` 设置为 false。 如果它包含 schema（例如 "tcp://"）、端口（例如 1521）或两者都包含，则不会考虑 ResolveTNS 选项，并且无论如何都会将其视为 URI；
- 会话名称 - 如果在插件配置文件中找到了该名称；
- TNS 键 - 如果 ResolveTNS 选项设置为 true，且上述条件均不适用；
- TNS 值 - 如果它以左括号 "(" 开头（忽略前导空格）。 在这种情况下，不会考虑 ResolveTNS 选项。
- **user** - Oracle 用户名，支持以 `user as sysdba` 格式追加以下任一登录选项：`as sysdba`、`as sysoper`、`as sysasm`、`as sysbackup`、`as sysdg`、`as syskm` 或 `as sysrac`（登录选项不区分大小写，末尾不得包含空格）。
- **password** - Oracle 密码；
- **service** - Oracle 服务名称。
[comment]: # ({/8be9c788-7cabfeb8}) [comment]: # ({35c5b152-2ca3eeaf}) ##### oracle.pga.stats[connString,,,] {#oracle.pga.stats}
返回 Program Global Area (PGA) 统计信息。
返回值：*JSON object*。 参数： - **connString** - 可以是：
- URI - 如果未找到具有给定名称的会话，且 `Plugins.Oracle.ResolveTNS` 设置为 false。 如果它包含 schema（例如 "tcp://"）、端口（例如 1521）或两者都包含，则不会考虑 ResolveTNS 选项，并且无论如何都会将其视为 URI；
- 会话名称 - 如果在插件配置文件中找到了该名称；
- TNS 键 - 如果 ResolveTNS 选项设置为 true，且上述条件均不适用；
- TNS 值 - 如果它以左括号 "(" 开头（忽略前导空格）。 在这种情况下，不会考虑 ResolveTNS 选项。
- **user** - Oracle 用户名，支持以 `user as sysdba` 格式追加以下任一登录选项：`as sysdba`、`as sysoper`、`as sysasm`、`as sysbackup`、`as sysdg`、`as syskm` 或 `as sysrac`（登录选项不区分大小写，末尾不得包含空格）。
- **password** - Oracle 密码；
- **service** - Oracle 服务名称。
[comment]: # ({/35c5b152-2ca3eeaf}) [comment]: # ({4aa7f461-e13b9288}) ##### oracle.ping[connString,,,] {#oracle.ping}
测试是否可以建立到 Oracle 的连接。
返回值：*1* - 连接成功；*0* - 连接中断（如果出现任何错误，包括 AUTH 和配置问题）。 参数： - **connString** - 可以是：
- URI - 如果未找到具有给定名称的会话，且 `Plugins.Oracle.ResolveTNS` 设置为 false。 如果它包含 schema（例如 "tcp://"）、端口（例如 1521）或两者都包含，则不会考虑 ResolveTNS 选项，并且无论如何都会将其视为 URI；
- 会话名称 - 如果在插件配置文件中找到了该名称；
- TNS 键 - 如果 ResolveTNS 选项设置为 true，且上述条件均不适用；
- TNS 值 - 如果它以左括号 "(" 开头（忽略前导空格）。 在这种情况下，不会考虑 ResolveTNS 选项。
- **user** - Oracle 用户名，支持以 `user as sysdba` 格式追加以下登录选项之一：`as sysdba`、`as sysoper`、`as sysasm`、`as sysbackup`、`as sysdg`、`as syskm` 或 `as sysrac`（登录选项不区分大小写，末尾不得包含空格）。
- **password** - Oracle 密码；
- **service** - Oracle 服务名称。
示例： ```default oracle.ping[tcp://127.0.0.1:1521,ZABBIX_MON,zabbix,xe] oracle.ping[localhost,ZABBIX_MON,zabbix,xe] oracle.ping[zbx_tns_example,ZABBIX_MON,zabbix,xe] oracle.ping["(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=localhost)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=xe)))",ZABBIX_MON,zabbix] ``` [comment]: # ({/4aa7f461-e13b9288}) [comment]: # ({55affb60-77cd7d3d}) ##### oracle.proc.stats[connString,,,] {#oracle.proc.stats}
返回进程统计信息。
返回值：*JSON 对象*。 参数： - **connString** - 可以是：
- URI - 如果未找到具有给定名称的会话，且 `Plugins.Oracle.ResolveTNS` 设置为 false。 如果其包含 schema（例如 `"tcp://"`）、端口（例如 `1521`）或两者，则不会考虑 ResolveTNS 选项，并且无论如何都会将其视为 URI；
- 会话名称 - 如果在插件配置文件中找到了该名称；
- TNS 键 - 如果 ResolveTNS 选项设置为 true，且上述条件均不适用；
- TNS 值 - 如果它以左括号 `"("` 开头（忽略前导空格）。 在这种情况下，不会考虑 ResolveTNS 选项。
- **user** - Oracle 用户名，支持按 `user as sysdba` 格式追加以下登录选项之一：`as sysdba`、`as sysoper`、`as sysasm`、`as sysbackup`、`as sysdg`、`as syskm` 或 `as sysrac`（登录选项不区分大小写，末尾不得包含空格）。
- **password** - Oracle 密码；
- **service** - Oracle 服务名称。
[comment]: # ({/55affb60-77cd7d3d}) [comment]: # ({bb195874-f219cf27}) ##### oracle.redolog.info[connString,,,] {#oracle.redolog.info}
控制文件中的日志文件信息。
返回值：*JSON object*。 参数： - **connString** - 可以是：
- URI - 如果未找到具有给定名称的会话，且 `Plugins.Oracle.ResolveTNS` 设置为 false。 如果它包含 schema（例如 "tcp://"）、端口（例如 1521）或两者都包含，则不会考虑 ResolveTNS 选项，并且无论如何都会将其视为 URI；
- 会话名称 - 如果在插件配置文件中找到了此名称；
- TNS 键 - 如果 ResolveTNS 选项设置为 true，且上述条件均不适用；
- TNS 值 - 如果它以左括号 "(" 开头（忽略前导空格）。 在这种情况下，不会考虑 ResolveTNS 选项。
- **user** - Oracle 用户名，支持按 `user as sysdba` 格式附加以下登录选项之一：`as sysdba`、`as sysoper`、`as sysasm`、`as sysbackup`、`as sysdg`、`as syskm` 或 `as sysrac`（登录选项不区分大小写，且末尾不得包含空格）。
- **password** - Oracle 密码；
- **service** - Oracle 服务名称。
[comment]: # ({/bb195874-f219cf27}) [comment]: # ({0c4971c0-2008672b}) ##### oracle.sga.stats[connString,,,] {#oracle.sga.stats}
返回系统全局区（SGA）统计信息。
返回值：*JSON 对象*。 参数： - **connString** - 可以是：
- URI - 如果未找到具有给定名称的会话，且 `Plugins.Oracle.ResolveTNS` 设置为 false。 如果其包含 schema（例如 "tcp://"）、端口（例如 1521）或两者都包含，则不会考虑 ResolveTNS 选项，并且无论如何都会将其视为 URI；
- 会话名称 - 如果在插件配置文件中找到了该名称；
- TNS 键 - 如果 ResolveTNS 选项设置为 true，且上述条件均不适用；
- TNS 值 - 如果其以左括号 "(" 开头（忽略前导空格）。 在这种情况下，不会考虑 ResolveTNS 选项。
- **user** - Oracle 用户名，支持以 `user as sysdba` 格式附加以下登录选项之一：`as sysdba`、`as sysoper`、`as sysasm`、`as sysbackup`、`as sysdg`、`as syskm` 或 `as sysrac`（登录选项不区分大小写，末尾不得包含空格）。
- **password** - Oracle 密码；
- **service** - Oracle 服务名称。
[comment]: # ({/0c4971c0-2008672b}) [comment]: # ({655cdf7e-2a343448}) ##### oracle.sessions.stats[connString,,,,] {#oracle.sessions.stats}
返回会话统计信息。
返回值：*JSON object*。 参数： - **connString** - 可以是：
- URI - 如果未找到具有给定名称的会话，且 `Plugins.Oracle.ResolveTNS` 设置为 false。 如果其包含 schema（例如 "tcp://"）、端口（例如 1521）或两者都包含，则不会考虑 ResolveTNS 选项，并且无论如何都会将其视为 URI；
- 会话名称 - 如果在插件配置文件中找到了该名称；
- TNS 键 - 如果 ResolveTNS 选项设置为 true，且上述条件均不适用；
- TNS 值 - 如果其以左括号 "(" 开头（忽略前导空格）。 在这种情况下，不会考虑 ResolveTNS 选项。
- **user** - Oracle 用户名，支持按 `user as sysdba` 格式追加以下登录选项之一：`as sysdba`、`as sysoper`、`as sysasm`、`as sysbackup`、`as sysdg`、`as syskm` 或 `as sysrac`（登录选项不区分大小写，末尾不得包含空格）。
- **password** - Oracle 密码；
- **service** - Oracle 服务名；
- **lockMaxTime** - 将会话计为长时间锁定时允许的最大会话锁定持续时间，单位为秒。 默认值：600 秒。 [comment]: # ({/655cdf7e-2a343448}) [comment]: # ({0f4dfe90-585ccbd4}) ##### oracle.sys.metrics[connString,,,,] {#oracle.sys.metrics}
返回一组系统指标值。
返回值：*JSON object*。 参数： - **connString** - 可以是：
- URI - 如果未找到具有给定名称的会话，且 `Plugins.Oracle.ResolveTNS` 设置为 false。 如果它包含 schema（例如 "tcp://"）、端口（例如 1521）或两者都包含，则不会考虑 ResolveTNS 选项，并且无论如何都会将其视为 URI；
- 会话名称 - 如果在插件配置文件中找到了此名称；
- TNS 键 - 如果 ResolveTNS 选项设置为 true，且上述条件均不适用；
- TNS 值 - 如果它以左括号 "(" 开头（忽略前导空格）。 在这种情况下，不会考虑 ResolveTNS 选项。
- **user** - Oracle 用户名，支持按 `user as sysdba` 格式附加以下登录选项之一：`as sysdba`、`as sysoper`、`as sysasm`、`as sysbackup`、`as sysdg`、`as syskm` 或 `as sysrac`（登录选项不区分大小写，末尾不得包含空格）。
- **password** - Oracle 密码；
- **service** - Oracle 服务名称；
- **duration** - 系统指标值的采集间隔（以秒为单位）。 可能的值：*60* — 长周期（默认），*15* — 短周期。 [comment]: # ({/0f4dfe90-585ccbd4}) [comment]: # ({82ac1eea-4ad20624}) ##### oracle.sys.params[connString,,,] {#oracle.sys.params}
返回一组系统参数值。
返回值：*JSON object*。 参数： - **connString** - 可以是：
- URI - 如果未找到具有给定名称的会话，且 `Plugins.Oracle.ResolveTNS` 设置为 false。 如果它包含 schema（例如 "tcp://"）、端口（例如 1521）或两者都包含，则不会考虑 ResolveTNS 选项，并且无论如何都会将其视为 URI；
- 会话名称 - 如果在插件配置文件中找到了该名称；
- TNS 键 - 如果 ResolveTNS 选项设置为 true，且上述条件均不适用；
- TNS 值 - 如果它以左括号 "(" 开头（忽略前导空格）。 在这种情况下，不会考虑 ResolveTNS 选项。
- **user** - Oracle 用户名，支持按 `user as sysdba` 格式追加以下登录选项之一：`as sysdba`、`as sysoper`、`as sysasm`、`as sysbackup`、`as sysdg`、`as syskm` 或 `as sysrac`（登录选项不区分大小写，且末尾不得包含空格）。
- **password** - Oracle 密码；
- **service** - Oracle 服务名称。
[comment]: # ({/82ac1eea-4ad20624}) [comment]: # ({92dac2b9-fd9b5b8e}) ##### oracle.ts.stats[connString,,,,,,] {#oracle.ts.stats}
返回表空间统计信息。
返回值：*JSON object*。 参数： - **connString** - 可以是：
- URI - 如果未找到具有给定名称的会话，且 `Plugins.Oracle.ResolveTNS` 设置为 false。 如果它包含 schema（例如 "tcp://"）、端口（例如 1521）或两者都包含，则不会考虑 ResolveTNS 选项，并且无论如何都会将其视为 URI；
- 会话名称 - 如果在插件配置文件中找到了该名称；
- TNS 键 - 如果 ResolveTNS 选项设置为 true，且上述条件均不适用；
- TNS 值 - 如果它以左括号 "(" 开头（忽略前导空格）。 在这种情况下，不会考虑 ResolveTNS 选项。
- **user** - Oracle 用户名，支持按 `user as sysdba` 格式追加以下登录选项之一：`as sysdba`、`as sysoper`、`as sysasm`、`as sysbackup`、`as sysdg`、`as syskm` 或 `as sysrac`（登录选项不区分大小写，末尾不得包含空格）。
- **password** - Oracle 密码；
- **service** - Oracle 服务名；
- **tablespace** - 要查询的表空间名称。 默认值（如果留空且设置了 `type`）： - "TEMP"（如果 `type` 设置为 "TEMPORARY"）； - "USERS"（如果 `type` 设置为 "PERMANENT"）。 - **type** - 要查询的表空间类型。 默认值（如果设置了 `tablespace`）："PERMANENT"。 - **conname** - 需要其信息的容器名称。 如果省略 `tablespace`、`type` 或 `conname`，则该监控项将返回所有匹配容器（包括 PDB 和 CDB）的表空间统计信息。 [comment]: # ({/92dac2b9-fd9b5b8e}) [comment]: # ({ef8f809e-836285d4}) ##### oracle.ts.discovery[connString,,,] {#oracle.ts.discovery}
返回表空间列表。 用于[低级别发现](/manual/discovery/low_level_discovery)。
返回值：*JSON object*。 参数： - **connString** - 可以是：
- URI - 如果未找到具有给定名称的会话，且 `Plugins.Oracle.ResolveTNS` 设置为 false。 如果它包含 schema（例如 "tcp://"）、端口（例如 1521）或两者都包含，则不会考虑 ResolveTNS 选项，并且无论如何都会将其视为 URI；
- 会话名称 - 如果在插件配置文件中找到了该名称；
- TNS 键 - 如果 ResolveTNS 选项设置为 true，且上述条件均不适用；
- TNS 值 - 如果它以左括号 "(" 开头（忽略前导空格）。 在这种情况下，不会考虑 ResolveTNS 选项。
- **user** - Oracle 用户名，支持以 `user as sysdba` 格式附加以下登录选项之一：`as sysdba`、`as sysoper`、`as sysasm`、`as sysbackup`、`as sysdg`、`as syskm` 或 `as sysrac`（登录选项不区分大小写，且末尾不得包含空格）。
- **password** - Oracle 密码；
- **service** - Oracle 服务名称。 [comment]: # ({/ef8f809e-836285d4}) [comment]: # ({1bfab674-213a30fa}) ##### oracle.user.info[connString,,,,] {#oracle.user.info}
返回 Oracle 用户信息。
返回值：*JSON object*。 参数： - **connString** - 可以是：
- URI - 如果未找到具有给定名称的会话，且 `Plugins.Oracle.ResolveTNS` 设置为 false。 如果它包含 schema（例如 "tcp://"）、端口（例如 1521）或两者都包含，则不会考虑 ResolveTNS 选项，并且无论如何都会将其视为 URI；
- 会话名称 - 如果在插件配置文件中找到了该名称；
- TNS 键 - 如果 ResolveTNS 选项设置为 true，且上述条件均不适用；
- TNS 值 - 如果它以左括号 "(" 开头（忽略前导空格）。 在这种情况下，不会考虑 ResolveTNS 选项。
- **user** - Oracle 用户名，支持以 `user as sysdba` 格式追加以下任一登录选项：`as sysdba`、`as sysoper`、`as sysasm`、`as sysbackup`、`as sysdg`、`as syskm` 或 `as sysrac`（登录选项不区分大小写，末尾不得包含空格）。
- **password** - Oracle 密码；
- **service** - Oracle 服务名；
- **username** - 需要获取其信息的用户名。 不支持小写用户名。 默认值：当前用户。 [comment]: # ({/1bfab674-213a30fa}) [comment]: # ({ed708005-6727a9fe}) ##### oracle.version[connString,,,] {#oracle.version}
返回数据库服务器版本。
返回值：*String*。 参数： - **connString** - 可以是：
- URI - 如果未找到具有给定名称的会话，且 `Plugins.Oracle.ResolveTNS` 设置为 false。 如果它包含 schema（例如 "tcp://"）、端口（例如 1521）或两者都包含，则不会考虑 ResolveTNS 选项，并且无论如何都会将其视为 URI；
- 会话名称 - 如果在插件配置文件中找到了此名称；
- TNS 键 - 如果 ResolveTNS 选项设置为 true，且上述条件均不适用；
- TNS 值 - 如果它以左括号 "(" 开头（忽略前导空格）。 在这种情况下，不考虑 ResolveTNS 选项。
- **user** - Oracle 用户名，支持按 `user as sysdba` 格式附加以下登录选项之一：`as sysdba`、`as sysoper`、`as sysasm`、`as sysbackup`、`as sysdg`、`as syskm` 或 `as sysrac`（登录选项不区分大小写，且末尾不得包含空格）。
- **password** - Oracle 密码；
- **service** - Oracle 服务名称。 [comment]: # ({/ed708005-6727a9fe}) [comment]: # ({f12c3aec-681f20c2}) ##### pgsql.autovacuum.count[uri,,,] {#pgsql.autovacuum.count}
autovacuum worker 的数量。
返回值：*Integer*。 参数： - **uri** - URI 或会话名称；
- **username, password** - PostgreSQL 凭据；
- **database name** - 数据库名称（如果省略，则使用 postgresql.conf 中 [Plugins.PostgreSQL.Default.Database](/manual/concepts/agent2/agent2_params_plugin/postgresql_plugin#parameters) 的值）。
[comment]: # ({/f12c3aec-681f20c2}) [comment]: # ({6b1280d9-d00cb61c}) ##### pgsql.archive[uri,,,] {#pgsql.archive}
归档文件的信息。
返回值：*JSON 对象*。 参数： - **uri** - URI 或会话名称；
- **username, password** - PostgreSQL 凭据；
- **database name** - 数据库名称（如果省略，则使用 postgresql.conf 中 [Plugins.PostgreSQL.Default.Database](/manual/concepts/agent2/agent2_params_plugin/postgresql_plugin#parameters) 的值）。
[comment]: # ({/6b1280d9-d00cb61c}) [comment]: # ({3cf2574a-00011d59}) ##### pgsql.bgwriter[uri,,,] {#pgsql.bgwriter}
数据库集群的检查点总数，按检查点类型细分。
返回值：*JSON 对象*。 参数： - **uri** - URI 或会话名称；
- **username, password** - PostgreSQL 凭据；
- **database name** - 数据库名称（如果省略，则使用 postgresql.conf 中 [Plugins.PostgreSQL.Default.Database](/manual/concepts/agent2/agent2_params_plugin/postgresql_plugin#parameters) 的值）。
[comment]: # ({/3cf2574a-00011d59}) [comment]: # ({dd95ca7a-00ab276d}) ##### pgsql.cache.hit[uri,,,] {#pgsql.cache.hit}
PostgreSQL 缓冲区缓存命中率。
返回值：*Float*。 参数： - **uri** - URI 或会话名称；
- **username, password** - PostgreSQL 凭据；
- **database name** - 数据库名称（如果省略，则使用 postgresql.conf 中 [Plugins.PostgreSQL.Default.Database](/manual/concepts/agent2/agent2_params_plugin/postgresql_plugin#parameters) 的值）。
[comment]: # ({/dd95ca7a-00ab276d}) [comment]: # ({b81b1268-32909ece}) ##### pgsql.connections[uri,,,] {#pgsql.connections}
按类型返回连接。
返回值：*JSON 对象*。 参数： - **uri** - URI 或会话名称；
- **username, password** - PostgreSQL 凭据；
- **database name** - 数据库名称（如果省略，则使用 postgresql.conf 中 [Plugins.PostgreSQL.Default.Database](/manual/concepts/agent2/agent2_params_plugin/postgresql_plugin#parameters) 的值）。
[comment]: # ({/b81b1268-32909ece}) [comment]: # ({54ecaf29-21431ffe}) ##### pgsql.custom.query[uri,,,queryName,] {#pgsql.custom.query}
返回自定义查询的结果。
返回值：*JSON 对象*。 参数： - **uri** - URI 或会话名称；
- **username, password** - PostgreSQL 凭据；
- **queryName** - 自定义查询的名称，必须与 SQL 文件名（无扩展名）匹配；
- **args** - 一个或多个逗号分隔的参数，用于传递给查询。
[comment]: # ({/54ecaf29-21431ffe}) [comment]: # ({84334798-11f6be08}) ##### pgsql.db.age[uri,,,] {#pgsql.db.age}
数据库中最老 FrozenXID 的年龄。
返回值：*Integer*。 参数： - **uri** - URI 或会话名称；
- **username, password** - PostgreSQL 凭据；
- **database name** - 数据库名称（如果省略，则使用 postgresql.conf 中 [Plugins.PostgreSQL.Default.Database](/manual/concepts/agent2/agent2_params_plugin/postgresql_plugin#parameters) 的值）。
[comment]: # ({/84334798-11f6be08}) [comment]: # ({aaab7dc5-ae9c9740}) ##### pgsql.db.bloating_tables[uri,,,] {#pgsql.db.bloating.tables}
每个数据库中的膨胀表数量。
返回值：*Integer*。 参数： - **uri** - URI 或会话名称；
- **username, password** - PostgreSQL 凭据；
- **database name** - 数据库名称（如果省略，则使用 postgresql.conf 中 [Plugins.PostgreSQL.Default.Database](/manual/concepts/agent2/agent2_params_plugin/postgresql_plugin#parameters) 的值）。
[comment]: # ({/aaab7dc5-ae9c9740}) [comment]: # ({316cff76-bead66f0}) ##### pgsql.db.discovery[uri,,,] {#pgsql.db.discovery}
PostgreSQL 数据库列表。 用于[低级别发现](/manual/discovery/low_level_discovery)。
返回值：*JSON object*。 参数： - **uri** - URI 或会话名称；
- **username, password** - PostgreSQL 凭据；
- **database name** - 数据库名称（如果省略，则使用 postgresql.conf 中 [Plugins.PostgreSQL.Default.Database](/manual/concepts/agent2/agent2_params_plugin/postgresql_plugin#parameters) 的值）。
[comment]: # ({/316cff76-bead66f0}) [comment]: # ({44659cf5-a209d73f}) ##### pgsql.db.size[uri,,,] {#pgsql.db.size}
数据库大小，单位为字节。
返回值：*Integer*。 参数： - **uri** - URI 或会话名称；
- **username, password** - PostgreSQL 凭据；
- **database name** - 数据库名称（如果省略，则使用 postgresql.conf 中 [Plugins.PostgreSQL.Default.Database](/manual/concepts/agent2/agent2_params_plugin/postgresql_plugin#parameters) 的值）。
[comment]: # ({/44659cf5-a209d73f}) [comment]: # ({f4a522e2-2a2e3c05}) ##### pgsql.dbstat[uri,,,] {#pgsql.dbstat}
收集每个数据库的统计信息。 用于[低级别发现](/manual/discovery/low_level_discovery)。
返回值：*JSON 对象*。 参数： - **uri** - URI 或会话名称；
- **username, password** - PostgreSQL 凭据；
- **database name** - 数据库名称（如果省略，则使用 postgresql.conf 中 [Plugins.PostgreSQL.Default.Database](/manual/concepts/agent2/agent2_params_plugin/postgresql_plugin#parameters) 的值）。
[comment]: # ({/f4a522e2-2a2e3c05}) [comment]: # ({ee880561-96f0fa06}) ##### pgsql.dbstat.sum[uri,,,] {#pgsql.dbstat.sum}
集群中所有数据库的汇总数据。
返回值：*JSON object*。 参数： - **uri** - URI 或会话名称；
- **username, password** - PostgreSQL 凭据；
- **database name** - 数据库名称（如果省略，则使用 postgresql.conf 中 [Plugins.PostgreSQL.Default.Database](/manual/concepts/agent2/agent2_params_plugin/postgresql_plugin#parameters) 的值）。
[comment]: # ({/ee880561-96f0fa06}) [comment]: # ({3d7798f9-14ca0aec}) ##### pgsql.locks[uri,,,] {#pgsql.locks}
关于每个数据库已授予锁的信息。 用于[低级别发现](/manual/discovery/low_level_discovery)。
返回值：*JSON 对象*。 参数： - **uri** - URI 或会话名称；
- **username, password** - PostgreSQL 凭据；
- **database name** - 数据库名称（如果省略，则使用 postgresql.conf 中 [Plugins.PostgreSQL.Default.Database](/manual/concepts/agent2/agent2_params_plugin/postgresql_plugin#parameters) 的值）。
[comment]: # ({/3d7798f9-14ca0aec}) [comment]: # ({761c40de-f37282e1}) ##### pgsql.oldest.xid[uri,,,] {#pgsql.oldest.xid}
最老 XID 的年龄。
返回值：*Integer*。 参数： - **uri** - URI 或会话名称；
- **username, password** - PostgreSQL 凭据；
- **database name** - 数据库名称（如果省略，则使用 postgresql.conf 中 [Plugins.PostgreSQL.Default.Database](/manual/concepts/agent2/agent2_params_plugin/postgresql_plugin#parameters) 的值）。
[comment]: # ({/761c40de-f37282e1}) [comment]: # ({7868c98a-a61feaf8}) ##### pgsql.ping[uri,,,] {#pgsql.ping}
测试连接是否存活。
返回值：*1* - 连接存活；*0* - 连接已断开（如果出现任何错误，包括 AUTH 和配置问题）。 参数： - **uri** - URI 或会话名称；
- **username, password** - PostgreSQL 凭据；
- **database name** - 数据库名称（如果省略，则使用 postgresql.conf 中 [Plugins.PostgreSQL.Default.Database](/manual/concepts/agent2/agent2_params_plugin/postgresql_plugin#parameters) 的值）。
[comment]: # ({/7868c98a-a61feaf8}) [comment]: # ({5ea36772-1240f49d}) ##### pgsql.queries[uri,,,,time period] {#pgsql.queries}
按执行时间查询指标。
返回值：*JSON object*。 参数： - **uri** - URI 或会话名称；
- **username, password** - PostgreSQL 凭据；
- **database name** - 数据库名称（如果省略，则使用 postgresql.conf 中 [Plugins.PostgreSQL.Default.Database](/manual/concepts/agent2/agent2_params_plugin/postgresql_plugin#parameters) 的值）；
- **time period** - 慢查询计数的执行时间限制（必须为正整数）。 [comment]: # ({/5ea36772-1240f49d}) [comment]: # ({47358084-7da2d7a1}) ##### pgsql.replication.count[uri,,] {#pgsql.replication.count}
备库服务器的数量。
返回值：*整数*。 参数： - **uri** - URI 或会话名称；
- **username, password** - PostgreSQL 凭据。
[comment]: # ({/47358084-7da2d7a1}) [comment]: # ({10745ed9-46c214a7}) ##### pgsql.replication.process[uri,,] {#pgsql.replication.process}
每个发送进程的刷新延迟、写入延迟和重放延迟。
返回值：*JSON 对象*。 参数： - **uri** - URI 或会话名称；
- **username, password** - PostgreSQL 凭据。
[comment]: # ({/10745ed9-46c214a7}) [comment]: # ({0218eeb9-4e97798b}) ##### pgsql.replication.process.discovery[uri,,] {#pgsql.replication.process.discovery}
复制进程名称发现。
返回值：*JSON 对象*。 参数： - **uri** - URI 或会话名称；
- **username, password** - PostgreSQL 凭据。
[comment]: # ({/0218eeb9-4e97798b}) [comment]: # ({03869f1d-2db43ebf}) ##### pgsql.replication.recovery_role[uri,,] {#pgsql.replication.recovery.role}
恢复状态。
返回值：*0* - 主节点模式；*1* - 正在进行恢复（备库模式）。 参数： - **uri** - URI 或会话名称；
- **username, password** - PostgreSQL 凭据。
[comment]: # ({/03869f1d-2db43ebf}) [comment]: # ({fa4ca4ae-0b42de61}) ##### pgsql.replication.status[uri,,] {#pgsql.replication.status}
复制状态。
返回值：*0* - 流复制已停止；*1* - 流复制正常工作；*2* - 主节点模式。 参数： - **uri** - URI 或会话名称；
- **username, password** - PostgreSQL 凭据。
[comment]: # ({/fa4ca4ae-0b42de61}) [comment]: # ({733430cc-dce31b13}) ##### pgsql.replication_lag.b[uri,,] {#pgsql.replication.lag.b}
复制延迟（以字节为单位）。
返回值：*整数*。 参数： - **uri** - URI 或会话名称；
- **username, password** - PostgreSQL 凭据。
[comment]: # ({/733430cc-dce31b13}) [comment]: # ({39a7c467-911ce6f3}) ##### pgsql.replication_lag.sec[uri,,] {#pgsql.replication.lag.sec}
复制延迟（以秒为单位）。
返回值：*整数*。 参数： - **uri** - URI 或会话名称；
- **username, password** - PostgreSQL 凭据。
[comment]: # ({/39a7c467-911ce6f3}) [comment]: # ({1521ad06-a81f90e6}) ##### pgsql.uptime[uri,,,] {#pgsql.uptime}
PostgreSQL 的运行时间，单位为毫秒。
返回值：*Float*。 参数： - **uri** - URI 或会话名称；
- **username, password** - PostgreSQL 凭据；
- **database name** - 数据库名称（如果省略，则使用 postgresql.conf 中 [Plugins.PostgreSQL.Default.Database](/manual/concepts/agent2/agent2_params_plugin/postgresql_plugin#parameters) 的值）。
[comment]: # ({/1521ad06-a81f90e6}) [comment]: # ({c156c2d5-35ce2a14}) ##### pgsql.version[uri,,,] {#pgsql.version}
返回 PostgreSQL 版本。
返回值：*String*。 参数： - **uri** - URI 或会话名称；
- **username, password** - PostgreSQL 凭据；
- **database name** - 数据库名称（如果省略，则使用 postgresql.conf 中 [Plugins.PostgreSQL.Default.Database](/manual/concepts/agent2/agent2_params_plugin/postgresql_plugin#parameters) 的值）。
[comment]: # ({/c156c2d5-35ce2a14}) [comment]: # ({797b5e95-3a4ac3ad}) ##### pgsql.wal.stat[uri,,,] {#pgsql.wal.stat}
WAL 统计信息。
返回值：*JSON object*。 参数： - **uri** - URI 或会话名称；
- **username, password** - PostgreSQL 凭据；
- **database name** - 数据库名称（如果省略，则使用 postgresql.conf 中 [Plugins.PostgreSQL.Default.Database](/manual/concepts/agent2/agent2_params_plugin/postgresql_plugin#parameters) 的值）。
[comment]: # ({/797b5e95-3a4ac3ad}) [comment]: # ({0b05f7ca-fb03aca5}) ##### redis.config[connString,,] {#redis.config}
获取与模式匹配的 Redis 实例配置参数。
返回值：*JSON* - 如果使用了 glob 风格模式；单个值 - 如果模式中不包含任何通配符字符。 参数： - **connString** - URI 或会话名称；
- **password** - Redis 密码；
- **pattern** - glob 风格模式（默认为 *\**）。 注释： - 安全警告：`redis.config` 会运行 Redis 的 `CONFIG GET` 命令，并且可能返回敏感配置参数（例如 `requirepass`、`masterauth`、与 TLS 相关的设置以及其他密钥信息）。 使用默认模式（`*`）或宽泛模式，可能会将这些密钥信息暴露给任何有权在 Zabbix 中查看监控项值的用户。 [comment]: # ({/0b05f7ca-fb03aca5}) [comment]: # ({2332f252-8c5408f6}) ##### redis.info[connString,,
] {#redis.info}
获取 INFO 命令的输出。
返回值：*JSON* - 输出序列化为 JSON 格式。 参数： - **connString** - URI 或会话名称；
- **password** - Redis 密码；
- **section** - 信息的部分（默认为 *default*）。详细参考 [INFO 命令](https://redis.io/commands/info)。
[comment]: # ({/2332f252-8c5408f6}) [comment]: # ({8a82f58e-7952fb43}) ##### redis.ping[connString,] {#redis.ping}
测试连接是否存活。
返回值：*1* - 连接存活；*0* - 连接中断（如果出现任何错误，包括认证和配置问题）。 参数： - **connString** - URI 或会话名称；
- **password** - Redis 密码。
[comment]: # ({/8a82f58e-7952fb43}) [comment]: # ({68b1ad5c-e6d86f50}) ##### redis.slowlog.count[connString,] {#redis.slowlog.count}
自 Redis 启动以来的慢日志条目数量。
返回值：*整数*。 参数： - **connString** - URI 或会话名称；
- **password** - Redis 密码。
[comment]: # ({/68b1ad5c-e6d86f50}) [comment]: # ({4b7fbb87-74faa2be}) ##### smart.attribute.discovery {#smart.attribute.discovery}
返回 S.M.A.R.T. 设备属性列表。
返回值：*JSON object*。 注释： - 返回以下宏及其值：{\#NAME}、{\#DISKTYPE}、{\#ID}、{\#ATTRNAME}、{\#THRESH}； - 支持 HDD、SSD 和 NVME 驱动器类型。 驱动器可以单独使用，也可以组合在 RAID 中。 在 RAID 情况下，{\#NAME} 将带有附加信息，例如：{"{\#NAME}": "/dev/sda cciss,2"}。 [comment]: # ({/4b7fbb87-74faa2be}) [comment]: # ({5c20bb46-c0ca5d9d}) ##### smart.disk.discovery[] {#smart.disk.discovery}
返回 S.M.A.R.T. 设备列表。
返回值：*JSON object*。 参数： - **type** - 指定扫描磁盘时使用的值。 可能的值：*id*、*name*（默认）。 *id* 在 Windows 上不受支持，如果选择将返回错误 说明： - 将返回以下宏及其值：{\#NAME}、{\#DISKTYPE}、{\#MODEL}、{\#SN}、{\#PATH}、{\#ATTRIBUTES}、{\#RAIDTYPE}； - 支持 HDD、SSD 和 NVME 驱动器类型。 如果驱动器不属于 RAID，则 {\#RAIDTYPE} 为空。 在 RAID 情况下，{\#NAME} 将带有附加内容，例如：{"{\#NAME}": "/dev/sda cciss,2"}。 [comment]: # ({/5c20bb46-c0ca5d9d}) [comment]: # ({8efc1201-85fda450}) ##### smart.disk.get[,] {#smart.disk.get}
返回 S.M.A.R.T. 设备的所有可用属性。
返回值：*JSON object*。 参数： - **path** - 磁盘路径，{\#PATH} 宏可用作其值；
- **raid_type** - RAID 类型，{\#RAID} 宏可用作其值 说明： - 支持 HDD、SSD 和 NVME 驱动器类型。 驱动器可以单独存在，也可以组合为 RAID；
- 数据包括 smartctl 版本和调用参数，以及附加字段：
*disk\_name* - 保存 RAID 发现所需附加信息的名称，例如：{"disk\_name": "/dev/sda cciss,2"}
*disk\_type* - 保存磁盘类型 HDD、SSD 或 NVME，例如：{"disk\_type": "ssd"}；
- 如果未指定参数，监控项将返回所有磁盘的信息。 [comment]: # ({/8efc1201-85fda450}) [comment]: # ({57eccce8-a2e1203a}) ##### systemd.unit.get[unit name,] {#systemd.unit.get}
返回一个systemd单元的所有属性。
返回值：*JSON对象*。 参数： - **unit name** - 单元名称（您可以在监控项原型中使用{\#UNIT.NAME}宏来发现名称）；
- **interface** - 单元接口类型，可能的取值：*Unit*（默认）、*Service*、*Socket*、*Device*、*Mount*、*Automount*、*Swap*、*Target*、*Path*。 注释： - 此项仅在Linux平台上支持； - 对于Unit接口，LoadState、ActiveState和UnitFileState以文本和整数形式返回：`"ActiveState":{"state":1,"text":"active"}`。 [comment]: # ({/57eccce8-a2e1203a}) [comment]: # ({4e7e754c-04d19e13}) ##### systemd.unit.info[unit name,,] {#systemd.unit.info}
systemd unit 信息。
返回值：*String*。 参数： - **unit name** - unit 名称（您可能希望在监控项原型中使用 {\#UNIT.NAME} 宏来发现名称）；
- **property** - unit 属性（例如：ActiveState（默认）、LoadState、Description）； - **interface** - unit 接口类型（例如：Unit（默认）、Socket、Service）。 注释： - 此监控项仅在 Linux 平台上受支持； - 此监控项允许从特定类型的接口中检索特定属性，如 [dbus API](https://www.freedesktop.org/wiki/Software/systemd/dbus/) 中所述。 示例： ```default systemd.unit.info["{#UNIT.NAME}"] #收集已发现 systemd unit 的活动状态（active、reloading、inactive、failed、activating、deactivating）信息 systemd.unit.info["{#UNIT.NAME}",LoadState] #收集已发现 systemd unit 的加载状态信息 systemd.unit.info[mysqld.service,Id] #检索服务技术名称（mysqld.service） systemd.unit.info[mysqld.service,Description] #检索服务描述（MySQL Server） systemd.unit.info[mysqld.service,ActiveEnterTimestamp] #检索服务上次进入活动状态的时间（1562565036283903） systemd.unit.info[dbus.socket,NConnections,Socket] #收集此 socket unit 的连接数 ``` [comment]: # ({/4e7e754c-04d19e13}) [comment]: # ({7b51879a-28908462}) ##### systemd.unit.discovery[] {#systemd.unit.discovery}
systemd 单元及其详细信息列表。 用于[低级别发现](/manual/discovery/low_level_discovery/examples/systemd)。
返回值：*JSON object*。 参数： - **type** - 可能的值：*all*、*automount*、*device*、*mount*、*path*、*service*（默认）、*socket*、*swap*、*target*。 此监控项仅在 Linux 平台上受支持。 [comment]: # ({/7b51879a-28908462}) [comment]: # ({c7b82260-9a731445}) ##### web.certificate.get[hostname,,
] {#web.certificate.get}
验证证书并返回证书详细信息。
返回值：*JSON 对象*。 参数： - **hostname** - 可以是 IP 或 DNS。
可以包含 URL 方案（仅支持 *https*）、路径（将被忽略）和端口。
如果第一和第二个参数中都提供了端口，则它们的值必须一致。
如果指定了 address（第 3 个参数），则 hostname 仅用于 SNI 和主机名验证；
- **port** - 端口号（HTTPS 的默认值为 443）；
- **address** - 可以是 IP 或 DNS。 如果指定，将用于建立连接，而 hostname（第 1 个参数）将用于 SNI 和主机验证。 如果第 1 个参数是 IP 且第 3 个参数是 DNS，则第 1 个参数将用于建立连接，第 3 个参数将用于 SNI 和主机验证。 注释： - 如果主机配置中指定的目标不存在、不可用，或者 TLS 握手因除证书无效之外的任何错误而失败，则此监控项将变为不支持；
- 当前不支持 AIA（Authority Information Access）X.509 扩展、CRL 和 OCSP（包括 OCSP stapling），以及证书透明度（Certificate Transparency）； - JSON 响应字段： - *x509*：包含 X.509 证书的详细信息。 - *version*：X.509 版本（例如 ``3``）。 - *serial_number*：证书的序列号。 - *signature_algorithm*：用于签署证书的算法（例如 ``SHA256-RSA``）。 - *issuer*：证书的颁发者。 - *not_before*：证书有效期的开始日期。 - *not_after*：证书的到期日期。 - *subject*：证书的主题。 - *public_key_algorithm*：用于公钥的算法（例如 ``RSA``）。 - *alternative_names*：主题备用名称（如果存在），否则为 ``null``。 - result：包含验证结果。 - *value*：验证状态（请参见下方可能的值）。 - *message*：详细验证消息（例如 ``"certificate verified successfully"``）。 - *sha1_fingerprint*：证书的 SHA-1 指纹。 - *sha256_fingerprint*：证书的 SHA-256 指纹。 - ``$.result.value`` 字段表示证书验证结果。 可能的值包括： - *valid* - 证书有效且受信任。 - *valid-but-self-signed* - 证书有效但为自签名，这意味着其主题与颁发者匹配。 - *invalid* - 证书无效，原因可能包括已过期、主机名不正确或签名机构未知。 示例： ```bash web.certificate.get[example.com,443] ``` JSON 响应： ```json { "x509": { "version": 3, "serial_number": "0ad893bafa68b0b7fb7a404f06ecaf9a", "signature_algorithm": "ECDSA-SHA384", "issuer": "CN=DigiCert Global G3 TLS ECC SHA384 2020 CA1,O=DigiCert Inc,C=US", "not_before": { "value": "Jan 15 00:00:00 2025 GMT", "timestamp": 1736899200 }, "not_after": { "value": "Jan 15 23:59:59 2026 GMT", "timestamp": 1768521599 }, "subject": "CN=*.example.com,O=Internet Corporation for Assigned Names and Numbers,L=Los Angeles,ST=California,C=US", "public_key_algorithm": "ECDSA", "alternative_names": [ "*.example.com", "example.com" ] }, "result": { "value": "valid", "message": "certificate verified successfully" }, "sha1_fingerprint": "310db7af4b2bc9040c8344701aca08d0c69381e3", "sha256_fingerprint": "455943cf819425761d1f950263ebf54755d8d684c25535943976f488bc79d23b" } ``` [comment]: # ({/c7b82260-9a731445})