[comment]: # attributes: notoc [comment]: # translation:outdated [comment]: # ({7a29bf66-871f8735}) # 1 Zabbix agent 2 [comment]: # ({/7a29bf66-871f8735}) [comment]: # ({8688c711-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| |[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| |[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+| |[memcached.ping](#memcached.ping)|测试连接是否存活。|Memcached| |[memcached.stats](#memcached.stats)|获取STATS命令的输出。|^| |[mongodb.collection.stats](#mongodb.collection.stats)|返回给定集合的各种存储统计信息。|MongoDB| |[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)|返回巨大块的计数。|^| |[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)|订阅提供的代理的特定主题或主题（带有通配符）并等待发布。|MQTT| |[mssql.availability.group.get](#mssql-availability-groups)|返回可用性组。|MSSQL| |[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| |[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记录信息。|网络| |[oracle.diskgroups.stats](#oracle-diskgroups-stats)|返回自动存储管理（ASM）磁盘组统计信息。|Oracle| |[oracle.diskgroups.discovery](#oracle-diskgroups-discovery)|返回ASM磁盘组列表。|^| |[oracle.archive.info](#oracle-archive-info)|归档日志统计信息。|^| |[oracle.cdb.info](#oracle-cdb-info)|容器数据库（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)|返回快速恢复区域（FRA）统计信息。|^| |[oracle.instance.info](#oracle-instance-info)|实例统计信息。|^| |[oracle.pdb.info](#oracle-pdb-info)|可插入数据库（PDBs）信息。|^| |[oracle.pdb.discovery](#oracle-pdb-discovery)|返回PDB列表。|^| |[oracle.pga.stats](#oracle-pga-stats)|返回程序全局区域（PGA）统计信息。|^| |[oracle.ping](#oracle-ping)|测试是否可以建立到Oracle的连接。|^| |[oracle.proc.stats](#oracle-proc-stats)|返回进程统计信息。|^| |[oracle.redolog.info](#oracle-redolog-info)|从控制文件中返回的日志文件信息。|^| |[oracle.sga.stats](#oracle-sga-stats)|返回系统全局区域（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)|自动清理工具工作者的数量。|PostgreSQL| |[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-bloatingtables)|每个数据库的膨胀表的数量。|^| |[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)|每个发送器进程的刷新延迟、写入延迟和重放延迟。|^| |[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| |[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.| |[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| |[systemd.unit.info](#systemd-unit-info)|Systemd单元信息。|^| |[systemd.unit.discovery](#systemd-unit-discovery)|systemd单元及其详细信息列表。|^| |[web.certificate.get](#web-certificate-get)|验证证书并返回证书详细信息。|Web certificates| 另请参阅： - [内置插件](/manual/extensions/plugins#built-in) - [可加载插件](/manual/extensions/plugins#loadable) [comment]: # ({/8688c711-3728d5da}) [comment]: # ({dc120678-3077d649}) ### 监控项键值详情 没有尖括号的参数是必填的。带有尖括号 **<** **>** 的参数是可选的。 [comment]: # ({/dc120678-3077d649}) [comment]: # ({5db49140-e443ac84}) ##### ceph.df.details[connString,,] {#ceph.df.details} 集群的数据使用情况和在各个池之间的分布。 返回值：JSON 对象。 参数： - connString：URI 或会话名称； - user, password：Ceph 登录凭据。 [comment]: # ({/5db49140-e443ac84}) [comment]: # ({29a131ed-8b08b33c}) ##### ceph.osd.stats[connString,,] {#ceph.osd.stats} 汇总和每个 OSD 的统计信息。 返回值：*JSON 对象*。 参数： - **connString** - URI 或会话名称； - **user, password** - Ceph 登录凭据。 [comment]: # ({/29a131ed-8b08b33c}) [comment]: # ({f6c06e28-07bfdcb6}) ##### ceph.osd.discovery[connString,,] {#ceph.osd.discovery} 已发现 OSD 的列表。用于[低级别发现](/manual/discovery/low_level_discovery)。 返回值：*JSON 对象*。 参数： - **connString** - URI 或会话名称； - **user, password** - Ceph 登录凭据。 [comment]: # ({/f6c06e28-07bfdcb6}) [comment]: # ({cf2f228b-236454b9}) ##### ceph.osd.dump[connString,,] {#ceph.osd.dump} OSD 的使用阈值和状态。 返回值：*JSON 对象*。 参数： - **connString** - URI 或会话名称； - **user, password** - Ceph 登录凭据。 [comment]: # ({/cf2f228b-236454b9}) [comment]: # ({aabd73bc-04750a8f}) ##### ceph.ping[connString,,] {#ceph.ping} 测试是否可以建立到 Ceph 的连接。 返回值：*0* - 连接断开（如果出现任何错误，包括 AUTH 和配置问题）；*1* - 连接成功。 参数： - **connString** - URI 或会话名称； - **user, password** - Ceph 登录凭据。 [comment]: # ({/aabd73bc-04750a8f}) [comment]: # ({8614caac-5930838a}) ##### ceph.pool.discovery[connString,,] {#ceph.pool.discovery} 已发现池的列表。用于[低级别发现](/manual/discovery/low_level_discovery)。 返回值：*JSON 对象*。 参数： - **connString** - URI 或会话名称；
- **user, password** - Ceph 登录凭据。
[comment]: # ({/8614caac-5930838a}) [comment]: # ({4a92a695-d2e29bd4}) ##### ceph.status[connString,,] {#ceph.status} 集群的总体状态。 返回值：*JSON 对象*。 参数： - **connString** - URI 或会话名称； - **user, password** - Ceph 登录凭据。 [comment]: # ({/4a92a695-d2e29bd4}) [comment]: # ({0c7c0596-0f9ad2d9}) ##### docker.container_info[,] {#docker.container.info} 容器的低级信息。 返回值：序列化为 JSON 的 [ContainerInspect](https://docs.docker.com/engine/api/v1.28/#operation/ContainerInspect) API 调用的输出。 参数： - **ID** - 容器的 ID 或名称； - **info** - 返回信息的量。支持的值：*short*（默认）或 *full*。 Agent 2 用户（'zabbix'）必须被添加到 'docker' [组](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} 容器列表。 返回值：序列化为 JSON 的 [ContainerList](https://docs.docker.com/engine/api/v1.28/#operation/ContainerList) API 调用的输出。 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 对象*。 参数： - **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} 返回镜像列表。 返回值：序列化为 JSON 的 [ImageList](https://docs.docker.com/engine/api/v1.28/#operation/ImageList) API 调用的输出。 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' [group](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} 系统信息。 返回值：序列化为 JSON 的 [SystemInfo](https://docs.docker.com/engine/api/v1.28/#operation/SystemInfo) API 调用的输出。 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' [group](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]: # ({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]: # ({eb4c0b74-20da93d0}) ##### mongodb.connpool.stats[connString,,] {#mongodb.connpool.stats} 返回有关当前数据库实例向分片集群或副本集中其他成员的打开传出连接的信息。 返回值：*JSON 对象*。 参数： - **connString** - URI 或会话名称； - **user, password** - MongoDB 登录凭据； - **database** - 数据库名称（默认为 admin）； - **collection** - 集合名称。 [comment]: # ({/eb4c0b74-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]: # ({b367870a-d1bb976a}) ##### mqtt.get[,topic,,] {#mqtt.get} 订阅提供的代理的特定主题或主题（带通配符）并等待发布。 返回值：取决于主题内容。如果使用通配符，则返回主题内容为 JSON。 参数： - **broker url** - MQTT 代理 URL，格式为 `protocol://host:port`，不包括查询参数（支持的协议：`tcp`、`ssl`、`ws`）。如果未指定值，代理将使用 `tcp://localhost:1883`。如果省略了协议或端口，则使用默认协议（`tcp`）或端口（`1883`）；
- **topic** - MQTT 主题（必填）。支持通配符（+、\#）；
- **user, password** - 认证凭据（如果需要）。
注释： - 监控项必须配置为[主动检查](/manual/appendix/items/activepassive#active_checks)（'Zabbix agent (active)' 监控项类型）； - 可以通过将它们保存到默认位置（例如 Ubuntu 的 `/etc/ssl/certs/` 目录）来使用 TLS 加密证书。对于 TLS，请使用 `tls://` 方案。 [comment]: # ({/b367870a-d1bb976a}) [comment]: # ({dc6632a3-6c398c8e}) ##### mssql.availability.group.get[URI,,] {#mssql-availability-groups} 返回可用性组。 返回值：*JSON 对象*。 参数： - **URI** - MSSQL 服务器 URI（唯一支持的模式是 *sqlserver://*）。嵌入式凭据将被忽略； - **user, password** - 发送到受保护的 MSSQL 服务器的用户名、密码。 有关更多信息，请参阅[MSSQL 插件](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md)的自述文件。 [comment]: # ({/dc6632a3-6c398c8e}) [comment]: # ({5bf8f906-cd610587}) ##### mssql.custom.query[URI,,,queryName,] {#mssql-custom-query} 返回自定义查询的结果。 返回值：*JSON 对象*。 参数： - **URI** - MSSQL 服务器 URI（唯一支持的模式是 *sqlserver://*）。嵌入式凭据将被忽略； - **user, password** - 发送到受保护的 MSSQL 服务器的用户名、密码； - **queryName** - 配置在 `Plugins.MSSQL.CustomQueriesDir` 中的自定义查询的名称，不包括 .sql 扩展名； - **args** - 一个或多个逗号分隔的参数，传递给查询。 有关更多信息，请参阅[MSSQL 插件](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md)的自述文件。 [comment]: # ({/5bf8f906-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]: # ({2346a4dc-b73763b6}) ##### mssql.ping {#mssql-ping} 对数据库进行 ping。测试连接是否正确配置。 返回值：*1* - 存活，*0* - 不存活。 有关更多信息，请参阅[MSSQL 插件](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md)的自述文件。 [comment]: # ({/2346a4dc-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]: # ({3c727f2c-mysql}) ##### mysql.custom.query[connString,,,queryName,] {#mysql.custom.query} 返回自定义查询的结果。 返回值：*JSON 对象*。 参数： - **connString** - URI 或会话名称；
- **user, password** - MySQL 登录凭据；
- **queryName** - 自定义查询的名称，必须与没有扩展名的 SQL 文件名匹配；
- **args** - 一个或多个逗号分隔的参数，传递给查询。 [comment]: # ({/3c727f2c-mysql}) [comment]: # ({a13b93a2-87221485}) ##### mysql.db.discovery[connString,,] {#mysql.db.discovery} 返回 MySQL 数据库的列表。用于[低级发现](/manual/discovery/low_level_discovery)。 返回值：以LLD JSON格式呈现的"show databases" SQL查询的结果。 参数： - **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]: # ({467b10b3-baf67c1f}) ##### mysql.replication.discovery[connString,,] {#mysql.replication.discovery} 返回 MySQL 复制的列表。用于[低级发现](/manual/discovery/low_level_discovery)。 返回值：以LLD JSON格式呈现的"show slave status" SQL查询的结果。 参数： - **connString** - URI 或会话名称；
- **user, password** - MySQL 登录凭据。
[comment]: # ({/467b10b3-baf67c1f}) [comment]: # ({ae70e65d-90f6ce4d}) ##### mysql.replication.get_slave_status[connString,,,] {#mysql.replication.get.slave.status} 复制状态。 返回值：以 JSON 格式呈现的"show slave status" SQL 查询的结果。 参数： - **connString** - URI 或会话名称；
- **user, password** - MySQL 登录凭据；
- **master host** - 复制主机名称。如果找不到，则返回错误。如果未指定此参数，则返回所有主机。
[comment]: # ({/ae70e65d-90f6ce4d}) [comment]: # ({9a93a3c2-f55a22aa}) ##### mysql.version[connString,,] {#mysql.version} MySQL 版本。 返回值：*字符串*（包含 MySQL 实例的版本号）。 参数： - **connString** - URI 或会话名称；
- **user, password** - MySQL 登录凭据。
[comment]: # ({/9a93a3c2-f55a22aa}) [comment]: # ({f3d859e0-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对象* 参数： - **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)）。 示例： net.dns.get[192.0.2.0,zabbix.com,DNSKEY,3,3,tcp,"cdflag,rdflag,nsid"] net.dns[,198.51.100.1,PTR,,,,"cdflag,rdflag,nsid"] net.dns[,1.100.51.198.in-addr.arpa,PTR,,,,"cdflag,rdflag,nsid"] net.dns[,2a00:1450:400f:800::200e,PTR,,,,"cdflag,rdflag,nsid"] net.dns[,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]: # ({/f3d859e0-0afa530f}) [comment]: # ({new-40f692b9}) ##### nvml.device.count {#nvml.device.count}
The number of GPU devices.
Return value: *Integer*. For more information see the [NVIDIA GPU plugin](https://git.zabbix.com/projects/AP/repos/nvidia-gpu/browse/README.md) readme. [comment]: # ({/new-40f692b9}) [comment]: # ({new-d5e2912c}) ##### nvml.device.decoder.utilization[] {#nvml.device.decoder.utilization}
GPU device decoder utilization as a percentage.
Return value: *Integer*. Parameter: - **deviceUUID** - GPU device UUID. For more information see the [NVIDIA GPU plugin](https://git.zabbix.com/projects/AP/repos/nvidia-gpu/browse/README.md) readme. [comment]: # ({/new-d5e2912c}) [comment]: # ({new-8a64cddd}) ##### nvml.device.ecc.mode[] {#nvml.device.ecc.mode}
GPU device ECC mode information (current, pending).
Return value: *JSON*. Parameter: - **deviceUUID** - GPU device UUID. For more information see the [NVIDIA GPU plugin](https://git.zabbix.com/projects/AP/repos/nvidia-gpu/browse/README.md) readme. [comment]: # ({/new-8a64cddd}) [comment]: # ({new-6f7efb45}) ##### nvml.device.encoder.stats.get[] {#nvml.device.encoder.stats.get}
GPU device encoder statistics.
Return value: *JSON*. Parameter: - **deviceUUID** - GPU device UUID. For more information see the [NVIDIA GPU plugin](https://git.zabbix.com/projects/AP/repos/nvidia-gpu/browse/README.md) readme. [comment]: # ({/new-6f7efb45}) [comment]: # ({new-1ba27c5b}) ##### nvml.device.encoder.utilization[] {#nvml.device.encoder.utilization}
GPU device encoder utilization as a percentage.
Return value: *Integer*. Parameter: - **deviceUUID** - GPU device UUID. For more information see the [NVIDIA GPU plugin](https://git.zabbix.com/projects/AP/repos/nvidia-gpu/browse/README.md) readme. [comment]: # ({/new-1ba27c5b}) [comment]: # ({new-35c67b3d}) ##### nvml.device.energy.consumption[] {#nvml.device.energy.consumption}
GPU device total energy consumption in millijoules (mJ) since the driver was last reloaded.
Return value: *Integer*. Parameter: - **deviceUUID** - GPU device UUID. For more information see the [NVIDIA GPU plugin](https://git.zabbix.com/projects/AP/repos/nvidia-gpu/browse/README.md) readme. [comment]: # ({/new-35c67b3d}) [comment]: # ({new-2a82aff7}) ##### nvml.device.errors.memory[] {#nvml.device.errors.memory}
GPU device ECC memory error information (corrected, uncorrected).
Return value: *JSON*. Parameter: - **deviceUUID** - GPU device UUID. For more information see the [NVIDIA GPU plugin](https://git.zabbix.com/projects/AP/repos/nvidia-gpu/browse/README.md) readme. [comment]: # ({/new-2a82aff7}) [comment]: # ({new-120ede98}) ##### nvml.device.errors.register[] {#nvml.device.errors.register}
GPU device ECC register error information (corrected, uncorrected).
Return value: *JSON*. Parameter: - **deviceUUID** - GPU device UUID. For more information see the [NVIDIA GPU plugin](https://git.zabbix.com/projects/AP/repos/nvidia-gpu/browse/README.md) readme. [comment]: # ({/new-120ede98}) [comment]: # ({new-6d4e9c63}) ##### nvml.device.fan.speed.avg[] {#nvml.device.fan.speed.avg}
GPU device average fan speed as a percentage of maximum speed.
Return value: *Integer*. Parameter: - **deviceUUID** - GPU device UUID. For more information see the [NVIDIA GPU plugin](https://git.zabbix.com/projects/AP/repos/nvidia-gpu/browse/README.md) readme. [comment]: # ({/new-6d4e9c63}) [comment]: # ({new-41c85aa3}) ##### nvml.device.get {#nvml.device.get}
Discovered GPUs with UUID and name.
Return value: *JSON*. For more information see the [NVIDIA GPU plugin](https://git.zabbix.com/projects/AP/repos/nvidia-gpu/browse/README.md) readme. [comment]: # ({/new-41c85aa3}) [comment]: # ({new-2dc80dfe}) ##### nvml.device.graphics.frequency[] {#nvml.device.graphics.frequency}
GPU device graphics clock speed in MHz.
Return value: *Integer*. Parameter: - **deviceUUID** - GPU device UUID. For more information see the [NVIDIA GPU plugin](https://git.zabbix.com/projects/AP/repos/nvidia-gpu/browse/README.md) readme. [comment]: # ({/new-2dc80dfe}) [comment]: # ({new-7678aa5b}) ##### nvml.device.memory.fb.get[] {#nvml.device.memory.fb.get}
GPU device framebuffer memory statistics (total, reserved, free, used).
Return value: *JSON*. Parameter: - **deviceUUID** - GPU device UUID. For more information see the [NVIDIA GPU plugin](https://git.zabbix.com/projects/AP/repos/nvidia-gpu/browse/README.md) readme. [comment]: # ({/new-7678aa5b}) [comment]: # ({new-dfd277cb}) ##### nvml.device.memory.bar1.get[] {#nvml.device.memory.bar1.get}
GPU device BAR1 memory statistics (total, free, used).
Return value: *JSON*. Parameter: - **deviceUUID** - GPU device UUID. For more information see the [NVIDIA GPU plugin](https://git.zabbix.com/projects/AP/repos/nvidia-gpu/browse/README.md) readme. [comment]: # ({/new-dfd277cb}) [comment]: # ({new-8129b4cd}) ##### nvml.device.memory.frequency[] {#nvml.device.memory.frequency}
GPU device memory clock speed in MHz.
Return value: *Integer*. Parameter: - **deviceUUID** - GPU device UUID. For more information see the [NVIDIA GPU plugin](https://git.zabbix.com/projects/AP/repos/nvidia-gpu/browse/README.md) readme. [comment]: # ({/new-8129b4cd}) [comment]: # ({new-7481e512}) ##### nvml.device.pci.utilization[] {#nvml.device.pci.utilization}
GPU device PCI utilization (transmit/receive throughput in KBps).
Return value: *JSON*. Parameter: - **deviceUUID** - GPU device UUID. For more information see the [NVIDIA GPU plugin](https://git.zabbix.com/projects/AP/repos/nvidia-gpu/browse/README.md) readme. [comment]: # ({/new-7481e512}) [comment]: # ({new-a121c018}) ##### nvml.device.performance.state[] {#nvml.device.performance.state}
GPU device performance state.
Return value: *Integer*. Parameter: - **deviceUUID** - GPU device UUID. For more information see the [NVIDIA GPU plugin](https://git.zabbix.com/projects/AP/repos/nvidia-gpu/browse/README.md) readme. [comment]: # ({/new-a121c018}) [comment]: # ({new-4efdea9a}) ##### nvml.device.power.limit[] {#nvml.device.power.limit}
GPU device power limit in milliwatts.
Return value: *Integer*. Parameter: - **deviceUUID** - GPU device UUID. For more information see the [NVIDIA GPU plugin](https://git.zabbix.com/projects/AP/repos/nvidia-gpu/browse/README.md) readme. [comment]: # ({/new-4efdea9a}) [comment]: # ({new-4d35097d}) ##### nvml.device.power.usage[] {#nvml.device.power.usage}
GPU device current power usage in milliwatts.
Return value: *Integer*. Parameter: - **deviceUUID** - GPU device UUID. For more information see the [NVIDIA GPU plugin](https://git.zabbix.com/projects/AP/repos/nvidia-gpu/browse/README.md) readme. [comment]: # ({/new-4d35097d}) [comment]: # ({new-ebda41bb}) ##### nvml.device.serial[] {#nvml.device.serial}
GPU device serial number.
Return value: *String*. Parameter: - **deviceUUID** - GPU device UUID. For more information see the [NVIDIA GPU plugin](https://git.zabbix.com/projects/AP/repos/nvidia-gpu/browse/README.md) readme. [comment]: # ({/new-ebda41bb}) [comment]: # ({new-a8d8521e}) ##### nvml.device.sm.frequency[] {#nvml.device.sm.frequency}
GPU device streaming multiprocessor clock speed in MHz.
Return value: *Integer*. Parameter: - **deviceUUID** - GPU device UUID. For more information see the [NVIDIA GPU plugin](https://git.zabbix.com/projects/AP/repos/nvidia-gpu/browse/README.md) readme. [comment]: # ({/new-a8d8521e}) [comment]: # ({new-c92d3df2}) ##### nvml.device.temperature[] {#nvml.device.temperature}
GPU device temperature in Celsius.
Return value: *Integer*. Parameter: - **deviceUUID** - GPU device UUID. For more information see the [NVIDIA GPU plugin](https://git.zabbix.com/projects/AP/repos/nvidia-gpu/browse/README.md) readme. [comment]: # ({/new-c92d3df2}) [comment]: # ({new-62de991d}) ##### nvml.device.utilization[] {#nvml.device.utilization}
GPU device utilization statistics (GPU/memory utilization as a percentage).
Return value: *JSON*. Parameter: - **deviceUUID** - GPU device UUID. For more information see the [NVIDIA GPU plugin](https://git.zabbix.com/projects/AP/repos/nvidia-gpu/browse/README.md) readme. [comment]: # ({/new-62de991d}) [comment]: # ({new-4c2edd00}) ##### nvml.device.video.frequency[] {#nvml.device.video.frequency}
GPU device video clock speed in MHz.
Return value: *Integer*. Parameter: - **deviceUUID** - GPU device UUID. For more information see the [NVIDIA GPU plugin](https://git.zabbix.com/projects/AP/repos/nvidia-gpu/browse/README.md) readme. [comment]: # ({/new-4c2edd00}) [comment]: # ({new-e2275873}) ##### nvml.system.driver.version {#nvml.system.driver.version}
The NVIDIA driver version.
Return value: *String*. For more information see the [NVIDIA GPU plugin](https://git.zabbix.com/projects/AP/repos/nvidia-gpu/browse/README.md) readme. [comment]: # ({/new-e2275873}) [comment]: # ({new-deed64b3}) ##### nvml.version {#nvml.version}
The NVML library version.
Return value: *String*. For more information see the [NVIDIA GPU plugin](https://git.zabbix.com/projects/AP/repos/nvidia-gpu/browse/README.md) readme. [comment]: # ({/new-deed64b3}) [comment]: # ({2eed4786-9773f5ca}) ##### oracle.diskgroups.stats[connString,,,,] {#oracle.diskgroups.stats} 返回自动存储管理（ASM）磁盘组统计信息。
返回值：*JSON 对象*。 参数： - **connString** - URI 或会话名称； - **user** - Oracle 用户名，支持以 `user as sysdba` 格式附加登录选项 `as sysdba`、`as sysoper` 或 `as sysasm` 中的一个（登录选项不区分大小写，不能包含尾随空格）； - **password** - Oracle 密码； - **service** - Oracle 服务名称； - **diskgroup** - 要查询的 ASM 磁盘组的名称。 [comment]: # ({/2eed4786-9773f5ca}) [comment]: # ({5b17d1fc-ecd5f683}) ##### oracle.diskgroups.discovery[connString,,,] {#oracle.diskgroups.discovery} 返回 ASM 磁盘组的列表。用于[低级发现](/manual/discovery/low_level_discovery)。
返回值：*JSON 对象*。 参数： - **connString** - URI 或会话名称； - **user** - Oracle 用户名，支持以 `user as sysdba` 格式附加登录选项 `as sysdba`、`as sysoper` 或 `as sysasm` 中的一个（登录选项不区分大小写，不能包含尾随空格）； - **password** - Oracle 密码； - **service** - Oracle 服务名称。 [comment]: # ({/5b17d1fc-ecd5f683}) [comment]: # ({aecf5481-dcf5ffe2}) ##### oracle.archive.info[connString,,,,] {#oracle.archive.info} 归档日志统计信息。
返回值：*JSON 对象*。 参数： - **connString** - URI 或会话名称； - **user** - Oracle 用户名，支持以 `user as sysdba` 格式附加登录选项 `as sysdba`、`as sysoper` 或 `as sysasm` 中的一个（登录选项不区分大小写，不能包含尾随空格）； - **password** - Oracle 密码； - **service** - Oracle 服务名称； - **destination** - 要查询的目的地的名称。 [comment]: # ({/aecf5481-dcf5ffe2}) [comment]: # ({edbd4654-a1afc726}) ##### oracle.cdb.info[connString,,,,] {#oracle.cdb.info} 容器数据库（CDBs）信息。
返回值：*JSON 对象*。 参数： - **connString** - URI 或会话名称； - **user** - Oracle 用户名，支持以 `user as sysdba` 格式附加登录选项 `as sysdba`、`as sysoper` 或 `as sysasm` 中的一个（登录选项不区分大小写，不能包含尾随空格）； - **password** - Oracle 密码； - **service** - Oracle 服务名称； - **destination** - 要查询的数据库的名称。 [comment]: # ({/edbd4654-a1afc726}) [comment]: # ({5be776c1-83723c39}) ##### oracle.custom.query[connString,,,,queryName,] {#oracle.custom.query} 自定义查询的结果。
返回值：*JSON 对象*。 参数： - **connString** - URI 或会话名称； - **user** - Oracle 用户名，支持以 `user as sysdba` 格式附加登录选项 `as sysdba`、`as sysoper` 或 `as sysasm` 中的一个（登录选项不区分大小写，不能包含尾随空格）； - **password** - Oracle 密码； - **service** - Oracle 服务名称； - **queryName** - 自定义查询的名称，必须与没有扩展名的 SQL 文件名匹配； - **args** - 要传递给查询的一个或多个逗号分隔的参数。 [comment]: # ({/5be776c1-83723c39}) [comment]: # ({4d16b985-ef413040}) ##### oracle.datafiles.stats[connString,,,] {#oracle.datafiles.stats} 返回数据文件统计信息。
返回值：*JSON 对象*。 参数： - **connString** - URI 或会话名称； - **user** - Oracle 用户名，支持以 `user as sysdba` 格式附加登录选项 `as sysdba`、`as sysoper` 或 `as sysasm` 中的一个（登录选项不区分大小写，不能包含尾随空格）； - **password** - Oracle 密码； - **service** - Oracle 服务名称； - **diskgroup** - 要查询的 ASM 磁盘组的名称。 [comment]: # ({/4d16b985-ef413040}) [comment]: # ({0350f886-3aee96da}) ##### oracle.db.discovery[connString,,,] {#oracle.db.discovery} 返回数据库列表。用于[低级发现](/manual/discovery/low_level_discovery)。
返回值：*JSON 对象*。 参数： - **connString** - URI 或会话名称； - **user** - Oracle 用户名，支持以 `user as sysdba` 格式附加登录选项 `as sysdba`、`as sysoper` 或 `as sysasm` 中的一个（登录选项不区分大小写，不能包含尾随空格）； - **password** - Oracle 密码； - **service** - Oracle 服务名称。 [comment]: # ({/0350f886-3aee96da}) [comment]: # ({84323cd5-d1925e26}) ##### oracle.fra.stats[connString,,,] {#oracle.fra.stats} 返回快速恢复区（FRA）统计信息。
返回值：*JSON 对象*。 参数： - **connString** - URI 或会话名称； - **user** - Oracle 用户名，支持以 `user as sysdba` 格式附加登录选项 `as sysdba`、`as sysoper` 或 `as sysasm` 中的一个（登录选项不区分大小写，不能包含尾随空格）； - **password** - Oracle 密码； - **service** - Oracle 服务名称。 [comment]: # ({/84323cd5-d1925e26}) [comment]: # ({8c78d713-d0b09033}) ##### oracle.instance.info[connString,,,] {#oracle.instance.info} 实例统计信息。
返回值：*JSON 对象*。 参数： - **connString** - URI 或会话名称； - **user** - Oracle 用户名，支持以 `user as sysdba` 格式附加登录选项 `as sysdba`、`as sysoper` 或 `as sysasm` 中的一个（登录选项不区分大小写，不能包含尾随空格）； - **password** - Oracle 密码； - **service** - Oracle 服务名称。 [comment]: # ({/8c78d713-d0b09033}) [comment]: # ({75643382-e6cb70e2}) ##### oracle.pdb.info[connString,,,,] {#oracle.pdb.info} 可插入数据库（PDBs）信息。
返回值：*JSON 对象*。 参数： - **connString** - URI 或会话名称； - **user** - Oracle 用户名，支持以 `user as sysdba` 格式附加登录选项 `as sysdba`、`as sysoper` 或 `as sysasm` 中的一个（登录选项不区分大小写，不能包含尾随空格）； - **password** - Oracle 密码； - **service** - Oracle 服务名称； - **destination** - 要查询的数据库的名称。 [comment]: # ({/75643382-e6cb70e2}) [comment]: # ({753ca921-7cabfeb8}) ##### oracle.pdb.discovery[connString,,,] {#oracle.pdb.discovery} 返回PDB（可插入数据库）列表。用于[低级发现](/manual/discovery/low_level_discovery)。
返回值：*JSON 对象*。 参数： - **connString** - URI 或会话名称； - **user** - Oracle 用户名，支持以 `user as sysdba` 格式附加登录选项 `as sysdba`、`as sysoper` 或 `as sysasm` 中的一个（登录选项不区分大小写，不能包含尾随空格）； - **password** - Oracle 密码； - **service** - Oracle 服务名称。 [comment]: # ({/753ca921-7cabfeb8}) [comment]: # ({417a61c5-2ca3eeaf}) ##### oracle.pga.stats[connString,,,] {#oracle.pga.stats} 返回程序全局区域（PGA）统计信息。
返回值：*JSON 对象*。 参数： - **connString** - URI 或会话名称； - **user** - Oracle 用户名，支持以 `user as sysdba` 格式附加登录选项 `as sysdba`、`as sysoper` 或 `as sysasm` 中的一个（登录选项不区分大小写，不能包含尾随空格）； - **password** - Oracle 密码； - **service** - Oracle 服务名称。 [comment]: # ({/417a61c5-2ca3eeaf}) [comment]: # ({068bbd34-e13b9288}) ##### oracle.ping[connString,,,] {#oracle.ping} 测试是否可以建立到 Oracle 的连接。
返回值：*1* - 连接成功；*0* - 连接中断（如果出现任何错误，包括 AUTH 和配置问题）。 参数： - **connString** - URI 或会话名称； - **user** - Oracle 用户名，支持以 `user as sysdba` 格式附加登录选项 `as sysdba`、`as sysoper` 或 `as sysasm` 中的一个（登录选项不区分大小写，不能包含尾随空格）； - **password** - Oracle 密码； - **service** - Oracle 服务名称。 [comment]: # ({/068bbd34-e13b9288}) [comment]: # ({e79d8c9d-77cd7d3d}) ##### oracle.proc.stats[connString,,,] {#oracle.proc.stats} 返回进程统计信息。
返回值：*JSON 对象*。 参数： - **connString** - URI 或会话名称； - **user** - Oracle 用户名，支持以 `user as sysdba` 格式附加登录选项 `as sysdba`、`as sysoper` 或 `as sysasm` 中的一个（登录选项不区分大小写，不能包含尾随空格）； - **password** - Oracle 密码； - **service** - Oracle 服务名称。 [comment]: # ({/e79d8c9d-77cd7d3d}) [comment]: # ({73a83170-f219cf27}) ##### oracle.redolog.info[connString,,,] {#oracle.redolog.info} 来自控制文件的日志文件信息。
返回值：*JSON 对象*。 参数： - **connString** - URI 或会话名称； - **user** - Oracle 用户名，支持以 `user as sysdba` 格式附加登录选项 `as sysdba`、`as sysoper` 或 `as sysasm` 中的一个（登录选项不区分大小写，不能包含尾随空格）； - **password** - Oracle 密码； - **service** - Oracle 服务名称。 [comment]: # ({/73a83170-f219cf27}) [comment]: # ({12e02fe8-2008672b}) ##### oracle.sga.stats[connString,,,] {#oracle.sga.stats} 返回系统全局区域（SGA）统计信息。
返回值：*JSON 对象*。 参数： - **connString** - URI 或会话名称； - **user** - Oracle 用户名，支持以 `user as sysdba` 格式附加登录选项 `as sysdba`、`as sysoper` 或 `as sysasm` 中的一个（登录选项不区分大小写，不能包含尾随空格）； - **password** - Oracle 密码； - **service** - Oracle 服务名称。 [comment]: # ({/12e02fe8-2008672b}) [comment]: # ({8ce2bf5d-2a343448}) ##### oracle.sessions.stats[connString,,,,] {#oracle.sessions.stats} 返回会话统计信息。
返回值：*JSON 对象*。 参数： - **connString** - URI 或会话名称； - **user** - Oracle 用户名，支持以 `user as sysdba` 格式附加登录选项 `as sysdba`、`as sysoper` 或 `as sysasm` 中的一个（登录选项不区分大小写，不能包含尾随空格）； - **password** - Oracle 密码； - **service** - Oracle 服务名称； - **lockMaxTime** - 最长会话锁定持续时间，以秒计算，将会话视为长时间锁定。默认值：600 秒。 [comment]: # ({/8ce2bf5d-2a343448}) [comment]: # ({f63e4615-585ccbd4}) ##### oracle.sys.metrics[connString,,,,] {#oracle.sys.metrics}
返回一组系统指标值。
返回值：*JSON 对象*。 参数： - **connString** - URI 或会话名称；
- **user** - Oracle 用户名，支持附加以下一种登录选项 `as sysdba`、`as sysoper` 或 `as sysasm`，格式为 `user as sysdba`（登录选项不区分大小写，不应包含尾随空格）；
- **password** - Oracle 密码；
- **service** - Oracle 服务名称；
- **duration** - 捕获系统指标值的时间间隔（以秒为单位）。可能的值：*60* — 长时间间隔（默认），*15* — 短时间间隔。 [comment]: # ({/f63e4615-585ccbd4}) [comment]: # ({92854c35-4ad20624}) ##### oracle.sys.params[connString,,,] {#oracle.sys.params}
返回一组系统参数值。
返回值：*JSON 对象*。 参数： - **connString** - URI 或会话名称；
- **user** - Oracle 用户名，支持附加以下一种登录选项 `as sysdba`、`as sysoper` 或 `as sysasm`，格式为 `user as sysdba`（登录选项不区分大小写，不应包含尾随空格）；
- **password** - Oracle 密码；
- **service** - Oracle 服务名称。
[comment]: # ({/92854c35-4ad20624}) [comment]: # ({600ecf4b-fd9b5b8e}) ##### oracle.ts.stats[connString,,,,,,] {#oracle.ts.stats}
返回表空间统计信息。
返回值：*JSON 对象*。 参数： - **connString** - URI 或会话名称；
- **user** - Oracle 用户名，支持附加以下一种登录选项 `as sysdba`、`as sysoper` 或 `as sysasm`，格式为 `user as sysdba`（登录选项不区分大小写，不应包含尾随空格）；
- **password** - Oracle 密码；
- **service** - Oracle 服务名称；
- **tablespace** - 要查询的表空间名称。默认值（如果留空且设置了 `type`）：
- "TEMP"（如果 `type` 设置为 "TEMPORARY"）；
- "USERS"（如果 `type` 设置为 "PERMANENT"）。 - **type** - 要查询的表空间类型。默认值（如果设置了 `tablespace`）："PERMANENT"。 - **conname** - 需要查询信息的容器名称。 如果省略 `tablespace`、`type` 或 `conname`，则此项将返回所有匹配容器（包括 PDB 和 CDB）的表空间统计信息。 [comment]: # ({/600ecf4b-fd9b5b8e}) [comment]: # ({41fff4e1-836285d4}) ##### oracle.ts.discovery[connString,,,] {#oracle.ts.discovery}
返回表空间列表。用于[低级发现](/manual/discovery/low_level_discovery)。
返回值：*JSON 对象*。 参数： - **connString** - URI 或会话名称；
- **user** - Oracle 用户名，支持附加以下一种登录选项 `as sysdba`、`as sysoper` 或 `as sysasm`，格式为 `user as sysdba`（登录选项不区分大小写，不应包含尾随空格）；
- **password** - Oracle 密码；
- **service** - Oracle 服务名称。
[comment]: # ({/41fff4e1-836285d4}) [comment]: # ({dee8a122-213a30fa}) ##### oracle.user.info[connString,,,,] {#oracle.user.info}
返回 Oracle 用户信息。
返回值：*JSON 对象*。 参数： - **connString** - URI 或会话名称；
- **user** - Oracle 用户名，支持附加以下一种登录选项 `as sysdba`、`as sysoper` 或 `as sysasm`，格式为 `user as sysdba`（登录选项不区分大小写，不应包含尾随空格）；
- **password** - Oracle 密码；
- **service** - Oracle 服务名称；
- **username** - 需要查询信息的用户名。不支持小写用户名。默认值：当前用户。 [comment]: # ({/dee8a122-213a30fa}) [comment]: # ({0abae183-6727a9fe}) ##### oracle.version[connString,,,] {#oracle.version}
返回数据库服务器版本。
返回值：*字符串*。 参数： - **connString** - URI 或会话名称；
- **user** - Oracle 用户名，支持附加以下一种登录选项 `as sysdba`、`as sysoper` 或 `as sysasm`，格式为 `user as sysdba`（登录选项不区分大小写，不应包含尾随空格）；
- **password** - Oracle 密码；
- **service** - Oracle 服务名称。
[comment]: # ({/0abae183-6727a9fe}) [comment]: # ({3606c222-681f20c2}) ##### pgsql.autovacuum.count[uri,,,] {#pgsql.autovacuum.count}
自动清理工作者的数量。
返回值：*整数*。 参数： - **uri** - URI 或会话名称；
- **username, password** - PostgreSQL 凭据；
- **database name** - 数据库名称。
[comment]: # ({/3606c222-681f20c2}) [comment]: # ({f026e656-d00cb61c}) ##### pgsql.archive[uri,,,] {#pgsql.archive}
归档文件的信息。
返回值：*JSON 对象*。 参数： - **uri** - URI 或会话名称；
- **username, password** - PostgreSQL 凭据；
- **database name** - 数据库名称。
[comment]: # ({/f026e656-d00cb61c}) [comment]: # ({b83c524f-00011d59}) ##### pgsql.bgwriter[uri,,,] {#pgsql.bgwriter}
数据库集群按检查点类型分类的检查点总数。
返回值：*JSON 对象*。 参数： - **uri** - URI 或会话名称；
- **username, password** - PostgreSQL 凭据；
- **database name** - 数据库名称。
[comment]: # ({/b83c524f-00011d59}) [comment]: # ({2b9f1955-00ab276d}) ##### pgsql.cache.hit[uri,,,] {#pgsql.cache.hit}
PostgreSQL 缓冲区命中率。
返回值：*浮点数*。 参数： - **uri** - URI 或会话名称；
- **username, password** - PostgreSQL 凭据；
- **database name** - 数据库名称。
[comment]: # ({/2b9f1955-00ab276d}) [comment]: # ({a0929c3d-32909ece}) ##### pgsql.connections[uri,,,] {#pgsql.connections}
按类型返回连接数。
返回值：*JSON 对象*。 参数： - **uri** - URI 或会话名称；
- **username, password** - PostgreSQL 凭据；
- **database name** - 数据库名称。
[comment]: # ({/a0929c3d-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]: # ({55557d93-11f6be08}) ##### pgsql.db.age[uri,,,] {#pgsql.db.age}
数据库中最老的 FrozenXID 的年龄。
返回值：*整数*。 参数： - **uri** - URI 或会话名称；
- **username, password** - PostgreSQL 凭据；
- **database name** - 数据库名称。
[comment]: # ({/55557d93-11f6be08}) [comment]: # ({e2d41203-ae9c9740}) ##### pgsql.db.bloating_tables[uri,,,] {#pgsql.db.bloating.tables}
每个数据库中膨胀表的数量。
返回值：*整数*。 参数： - **uri** - URI 或会话名称；
- **username, password** - PostgreSQL 凭据；
- **database name** - 数据库名称。
[comment]: # ({/e2d41203-ae9c9740}) [comment]: # ({bb8a6f03-bead66f0}) ##### pgsql.db.discovery[uri,,,] {#pgsql.db.discovery}
PostgreSQL 数据库列表。用于[低级发现](/manual/discovery/low_level_discovery)。
返回值：*JSON 对象*。 参数： - **uri** - URI 或会话名称；
- **username, password** - PostgreSQL 凭据；
- **database name** - 数据库名称。
[comment]: # ({/bb8a6f03-bead66f0}) [comment]: # ({3325bbee-a209d73f}) ##### pgsql.db.size[uri,,,] {#pgsql.db.size}
数据库的大小，以字节为单位。
返回值：*整数*。 参数： - **uri** - URI 或会话名称；
- **username, password** - PostgreSQL 凭据；
- **database name** - 数据库名称。
[comment]: # ({/3325bbee-a209d73f}) [comment]: # ({2093947b-2a2e3c05}) ##### pgsql.dbstat[uri,,,] {#pgsql.dbstat}
收集每个数据库的统计信息。用于[低级发现](/manual/discovery/low_level_discovery)。
返回值：*JSON 对象*。 参数： - **uri** - URI 或会话名称；
- **username, password** - PostgreSQL 凭据；
- **database name** - 数据库名称。
[comment]: # ({/2093947b-2a2e3c05}) [comment]: # ({2f3a53f1-96f0fa06}) ##### pgsql.dbstat.sum[uri,,,] {#pgsql.dbstat.sum}
集群中所有数据库的汇总数据。
返回值：*JSON 对象*。 参数： - **uri** - URI 或会话名称；
- **username, password** - PostgreSQL 凭据；
- **database name** - 数据库名称。
[comment]: # ({/2f3a53f1-96f0fa06}) [comment]: # ({27f407f7-14ca0aec}) ##### pgsql.locks[uri,,,] {#pgsql.locks}
每个数据库中已授予的锁信息。用于[低级发现](/manual/discovery/low_level_discovery)。
返回值：*JSON 对象*。 参数： - **uri** - URI 或会话名称；
- **username, password** - PostgreSQL 凭据；
- **database name** - 数据库名称。
[comment]: # ({/27f407f7-14ca0aec}) [comment]: # ({e29d5ddf-f37282e1}) ##### pgsql.oldest.xid[uri,,,] {#pgsql.oldest.xid}
最老 XID 的年龄。
返回值：*整数*。 参数： - **uri** - URI 或会话名称；
- **username, password** - PostgreSQL 凭据；
- **database name** - 数据库名称。
[comment]: # ({/e29d5ddf-f37282e1}) [comment]: # ({26d9b81d-a61feaf8}) ##### pgsql.ping[uri,,,] {#pgsql.ping}
测试连接是否存活。
返回值：*1* - 连接存活；*0* - 连接中断（如果出现任何错误，包括认证和配置问题）。 参数： - **uri** - URI 或会话名称；
- **username, password** - PostgreSQL 凭据；
- **database name** - 数据库名称。
[comment]: # ({/26d9b81d-a61feaf8}) [comment]: # ({6b97ac4b-1240f49d}) ##### pgsql.queries[uri,,,,