[comment]: # attributes: notoc [comment]: # ({7a29bf66-871f8735}) # 1 Zabbixエージェント2 [comment]: # ({/7a29bf66-871f8735}) [comment]: # ({31b266f5-3728d5da}) Zabbix エージェント 2 は、[Unix](/manual/config/items/itemtypes/zabbix_agent) および [Windows](/manual/config/items/itemtypes/zabbix_agent/win_keys) の Zabbix エージェントでサポートされるすべてのアイテムキーをサポートします。 このページでは、Zabbix エージェント 2 でのみ使用できる追加のアイテムキーについて、属するプラグインごとに分類して説明します。 アイテムキーは、パラメータや追加情報を省略した形で一覧表示されています。 アイテムキーをクリックすると、詳細を確認できます。 |Item key|Description|Plugin| |--|-------|-| |[ceph.df.details](#ceph.df.details)|クラスタのデータ使用量とプール間の分布。|[Ceph](/manual/concepts/agent2/loadable_plugins)
(loadable)| |[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)
(loadable)| |[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)
(loadable)| |[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)|指定されたブローカーの特定のトピック、またはワイルドカード付きの複数トピックを購読し、公開を待機します。|[MQTT](/manual/concepts/agent2/builtin_plugins)| |[mssql.availability.group.get](#mssql-availability-groups)|可用性グループを返します。|[MSSQL](/manual/concepts/agent2/loadable_plugins)
(loadable)| |[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)
(loadable)| |[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)|UUID と名前を含む検出済み GPU。|^| |[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 Database (CDB) の情報。|^| |[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 Database (PDB) の情報。|^| |[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 ワーカーの数。|[PostgreSQL](/manual/concepts/agent2/loadable_plugins)
(loadable)| |[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)|データベースごとの bloating table の数。|^| |[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 の起動以降の slow log エントリ数。|^| |[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オブジェクト*。 パラメータ: - **connString** - URIまたはセッション名;
- **user, apikey** - Cephに接続するためのユーザー名とAPIキー。
[comment]: # ({/cb224c09-e443ac84}) [comment]: # ({35504811-8b08b33c}) ##### ceph.osd.stats[connString,,] {#ceph.osd.stats}
集約およびOSDごとの統計情報。
戻り値: *JSONオブジェクト*。 パラメータ: - **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* - 接続が切断されています (認証や設定の問題を含むエラーが発生した場合); *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オブジェクト*。 パラメータ: - **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' [グループ](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}
コンテナのリソース使用状況の統計情報です。
戻り値: [ContainerStats](https://docs.docker.com/engine/api/v1.28/#operation/ContainerStats) API呼び出しの出力とCPU使用率のパーセンテージをJSONとしてシリアライズしたもの。 パラメータ: - **ID** - コンテナのIDまたは名前 Agent 2のユーザー('zabbix')は、十分な権限を得るために'docker' [グループ](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' [グループ](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' [グループ](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}
現在のデータ使用量に関する情報。
戻り値: [SystemDataUsage](https://docs.docker.com/engine/api/v1.28/#operation/SystemDataUsage) API呼び出しの出力をJSONとしてシリアル化したもの。 十分な権限を得るために、Agent 2のユーザー（'zabbix'）を'docker' [グループ](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' [グループ](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' [グループ](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オブジェクト*。 パラメーター: - **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}
クラスタ内に存在する検出されたシャードのリストを返します。
戻り値: *JSONオブジェクト*。 パラメータ: - **connString** - URIまたはセッション名;
- **user, password** - MongoDBのログイン認証情報。
[comment]: # ({/1ffbe870-989959f8}) [comment]: # ({3b5f81c6-28a9c65c}) ##### mongodb.version[connString,,] {#mongodb.version}
データベースサーバーのバージョンを返します。
戻り値: *String*。 パラメータ: - **connString** - URIまたはセッション名;
- **user, password** - MongoDBのログイン認証情報。
[comment]: # ({/3b5f81c6-28a9c65c}) [comment]: # ({0cfb5384-d1bb976a}) ##### mqtt.get[,topic,,] {#mqtt.get}
指定されたブローカーの特定のトピック、またはトピック群（ワイルドカード使用）を購読し、パブリケーションを待機します。
戻り値: トピックの内容に応じます。 ワイルドカードを使用した場合、トピックの内容をJSONとして返します。 パラメータ: - **broker url** - `protocol://host:port` 形式のMQTTブローカーURLです。クエリパラメータは含めません（サポートされるプロトコル: `tcp`、`ssl`、`ws`）。 値が指定されていない場合、エージェントは `tcp://localhost:1883` を使用します。 プロトコルまたはポートが省略された場合、デフォルトのプロトコル（`tcp`）またはポート（`1883`）が使用されます。
- **topic** - MQTTトピック（必須）。 ワイルドカード（+、\#）をサポートします。
- **user, password** - 認証情報です（必要な場合）。
コメント: - アイテムは [active check](/manual/appendix/items/activepassive#active-checks)（「Zabbixエージェント（アクティブ）」アイテムタイプ）として設定する必要があります。 - TLS暗号化証明書は、デフォルトの場所に保存することで使用できます（例: Ubuntuでは `/etc/ssl/certs/` ディレクトリ）。 TLSには `tls://` スキームを使用してください。 [comment]: # ({/0cfb5384-d1bb976a}) [comment]: # ({1ebfd6dc-6c398c8e}) ##### mssql.availability.group.get[URI,,] {#mssql-availability-groups}
可用性グループを返します。
戻り値: *JSONオブジェクト*。 パラメータ: - **URI** - MSSQLサーバーのURI（サポートされているスキーマは`sqlserver://`のみ）。 埋め込み認証情報は無視されます。 URIの一部としてインスタンス名を指定することができます。例: `sqlserver://localhost/InstanceName`（ポートなし）。 ポートが指定されている場合、インスタンス名は無視されます;
- **user, password** - 保護されたMSSQLサーバーに送信するユーザー名、パスワード。
詳細については、[MSSQLプラグイン](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オブジェクト*。 パラメータ: - **URI** - MSSQLサーバーのURI（サポートされているスキーマは`sqlserver://`のみ）。 埋め込まれた認証情報は無視されます。 URIの一部としてインスタンス名を指定することができます。例: `sqlserver://localhost/InstanceName`（ポートなし）。 ポートが指定されている場合、インスタンス名は無視されます;
- **user, password** - 保護されたMSSQLサーバーに送信するユーザー名、パスワード;
- **queryName** - `.sql`拡張子なしで`Plugins.MSSQL.CustomQueriesDir`に設定されたカスタムクエリの名前;
- **args** - クエリに渡す1つまたは複数のカンマ区切りの引数。 詳細は[MSSQLプラグイン](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)のreadmeを参照してください。 [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)のreadmeを参照してください。 [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)のreadmeを参照してください。 [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) の readme を参照してください。 [comment]: # ({/119e0c81-e113d3b4}) [comment]: # ({fac5053e-fe193722}) ##### mssql.mirroring.get {#mssql-mirroring}
ミラーリング情報を返します。
戻り値: *JSONオブジェクト*。 詳細は [MSSQLプラグイン](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md) のreadmeを参照してください。 [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) の readme を参照してください。 [comment]: # ({/d379eab8-0473c1ed}) [comment]: # ({c4292e4e-57c1330b}) ##### mssql.perfcounter.get {#mssql-perfcounter}
パフォーマンスカウンターを返します。
戻り値: *JSONオブジェクト*。 詳細は [MSSQLプラグイン](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md) のreadmeを参照してください。 [comment]: # ({/c4292e4e-57c1330b}) [comment]: # ({ed983ed6-b73763b6}) ##### mssql.ping {#mssql-ping}
データベースにpingを送信します。 接続が正しく設定されているかテストします。
戻り値: *1* - 生存, *0* - 非生存。 詳細については、[MSSQLプラグイン](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)のreadmeを参照してください。 [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)のreadmeを参照してください。 [comment]: # ({/389acfa0-deb94054}) [comment]: # ({cdf515f8-33120c2e}) ##### mssql.replica.get {#mssql-replica}
レプリカを返します。
戻り値：*JSONオブジェクト*。 詳細については、[MSSQLプラグイン](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md)のreadmeを参照してください。 [comment]: # ({/cdf515f8-33120c2e}) [comment]: # ({68d3576b-c4cbbde9}) ##### mssql.version {#mssql-version}
MSSQLのバージョンを返します。
戻り値: *文字列*。 詳細については、[MSSQLプラグイン](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md)のreadmeを参照してください。 [comment]: # ({/68d3576b-c4cbbde9}) [comment]: # ({10629927-mysql}) ##### mysql.custom.query[connString,,,queryName,] {#mysql.custom.query}
カスタムクエリの結果を返します。
戻り値: *JSONオブジェクト*。 パラメータ: - **connString** - URIまたはセッション名;
- **user, password** - MySQLのログイン認証情報;
- **queryName** - カスタムクエリの名前。SQLファイル名(拡張子なし)と一致する必要があります;
- **args** - クエリに渡す1つまたは複数のカンマ区切りの引数。 詳細は[MySQLプラグイン](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)で使用されます。
戻り値: 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}
グローバルステータス変数の値。
戻り値: "show global status" SQLクエリの結果をJSON形式で返します。 パラメータ: - **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のバージョン。
戻り値: *String* (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 エージェントアイテムの拡張版で、より多くのレコードタイプとカスタマイズ可能なフラグをサポートします。
戻り値: *JSON object* パラメーター: - **ip** - DNSサーバーのIPアドレス（空欄の場合はデフォルトのDNSサーバーを使用します）; - **name** - クエリ対象のDNS名; - **type** - クエリするレコードタイプ（デフォルトは *SOA*）; - **timeout** - リクエストのタイムアウト（秒単位、デフォルトは1秒）; - **count** - リクエストの試行回数（デフォルトは2回）; - **protocol** - DNSクエリの実行に使用するプロトコル: *udp*（デフォルト）または *tcp*; - **flags** - クエリに渡す、カンマ区切りの1つ以上の引数。 コメント: - `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* は、どちらも *edns0* を必要とするため、*noedns0* と組み合わせて使用することはできません。 値は小文字のみで指定する必要があります。大文字または大文字小文字混在の値はサポートされていません。 - 国際化ドメイン名はサポートされていません。代わりに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プラグイン](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デバイスのデコーダー使用率(%)。
戻り値: *整数*。 パラメータ: - **deviceUUID** - GPUデバイスのUUID。 詳細は[NVIDIA GPUプラグイン](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プラグイン](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プラグイン](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デバイスエンコーダの使用率(%)。
戻り値: *整数*。 パラメータ: - **deviceUUID** - GPUデバイスのUUID。 詳細は[NVIDIA GPUプラグイン](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}
ドライバが最後にリロードされてからの、ミリジュール(mJ)単位でのGPUデバイスの総エネルギー消費量。
戻り値: *整数*。 パラメータ: - **deviceUUID** - GPUデバイスのUUID。 詳細については、[NVIDIA GPUプラグイン](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プラグイン](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プラグイン](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プラグイン](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}
UUIDと名前で検出されたGPU。
戻り値：*JSON*。 詳細については、[NVIDIA GPUプラグイン](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プラグイン](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デバイスのフレームバッファメモリ統計情報 (total, reserved, free, used)。
戻り値: *JSON*。 パラメータ: - **deviceUUID** - GPUデバイスのUUID。 詳細は[NVIDIA GPUプラグイン](https://git.zabbix.com/projects/AP/repos/nvidia-gpu/browse/README.md)のreadmeを参照してください。 [comment]: # ({/ecf6e640-7678aa5b}) [comment]: # ({e510a010-dfd277cb}) ##### nvml.device.memory.bar1.get[] {#nvml.device.memory.bar1.get}
GPUデバイスのBAR1メモリ統計情報 (total, free, used)。
戻り値: *JSON*。 パラメータ: - **deviceUUID** - GPUデバイスのUUID。 詳細は[NVIDIA GPUプラグイン](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プラグイン](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プラグイン](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プラグイン](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プラグイン](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デバイスの現在の消費電力(ミリワット単位)。
戻り値: *整数*。 パラメータ: - **deviceUUID** - GPUデバイスのUUID。 詳細は[NVIDIA GPUプラグイン](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デバイスのシリアル番号。
戻り値：*文字列*。 パラメータ: - **deviceUUID** - GPUデバイスのUUID。 詳細については、[NVIDIA GPUプラグイン](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単位)。
戻り値: *整数*。 パラメータ: - **deviceUUID** - GPUデバイスのUUID。 詳細は[NVIDIA GPUプラグイン](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デバイスの温度(摂氏)。
戻り値: *整数*。 パラメータ: - **deviceUUID** - GPUデバイスのUUID。 詳細は[NVIDIA GPUプラグイン](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プラグイン](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プラグイン](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ドライバーのバージョン。
戻り値: *文字列*。 詳細については、[NVIDIA GPUプラグイン](https://git.zabbix.com/projects/AP/repos/nvidia-gpu/browse/README.md)のreadmeを参照してください。 [comment]: # ({/f7a800a0-e2275873}) [comment]: # ({98e7c317-deed64b3}) ##### nvml.version {#nvml.version}
NVMLライブラリのバージョン。
戻り値: *文字列*。 詳細については、[NVIDIA GPUプラグイン](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 に設定されている場合。
スキーマ（例: "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 に設定されている場合。 スキーマ（例: "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 に設定されている場合。 スキーマ（例: "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 に設定されている場合。 スキーマ（例: "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 に設定されている場合。 スキーマ（例: "tcp://"）、ポート（例: 1521）、またはその両方を含む場合、ResolveTNS オプションは考慮されず、いずれにしても URI として扱われます。
- セッション名 - その名前がプラグイン設定ファイル内で見つかった場合。
- TNSキー - ResolveTNS オプションが true に設定されており、かつ上記のいずれの条件にも該当しない場合。
- TNS値 - 開き括弧 "(" で始まる場合（先頭の空白は無視されます）。 この場合、ResolveTNS オプションは考慮されません。
- **user** - Oracleのユーザー名。ログインオプション `as sysdba`、`as sysoper`、`as sysasm`、`as sysbackup`、`as sysdg`、`as syskm`、`as sysrac` のいずれかを `user as sysdba` の形式で末尾に追加できます（ログインオプションは大文字・小文字を区別せず、末尾に空白を含めてはいけません）。
- **password** - Oracleのパスワード。
- **service** - Oracleのサービス名。
- **queryName** - カスタムクエリの名前。拡張子を除いたSQLファイル名と一致する必要があります。
- **args** - クエリに渡す、カンマ区切りの1つまたは複数の引数。 コメント: - 返されたデータは自動的にJSONに変換されます。 - クエリから直接JSONを返すことは避けてください。プラグインが再度JSONに変換しようとする際に破損するためです。 [comment]: # ({/85592244-83723c39}) [comment]: # ({2554cf65-ef413040}) ##### oracle.datafiles.stats[connString,,,] {#oracle.datafiles.stats}
データファイルの統計情報を返します。
戻り値: *JSON object*。 パラメータ: - **connString** - 以下のいずれかを指定できます:
- URI - 指定された名前のセッションが見つからず、`Plugins.Oracle.ResolveTNS` が false に設定されている場合。
これにスキーマ（例: "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 object*。 パラメータ: - **connString** - 次のいずれかを指定できます:
- URI - 指定された名前のセッションが見つからず、`Plugins.Oracle.ResolveTNS` が false に設定されている場合。 スキーマ（例: "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}
Fast Recovery Area（FRA）の統計情報を返します。
戻り値: *JSON object*。 パラメータ: - **connString** - 以下のいずれかを指定できます:
- URI - 指定された名前のセッションが見つからず、`Plugins.Oracle.ResolveTNS` が false に設定されている場合。 スキーマ（例: "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 に設定されている場合。 スキーマ（例: "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 に設定されている場合。 スキーマ（例: "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 に設定されている場合。 スキーマ（例: "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 に設定されている場合。 スキーマ（例: "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 に設定されている場合。 スキーマ（例: "tcp://"）、ポート（例: 1521）、またはその両方が含まれている場合、ResolveTNS オプションは考慮されず、いずれにしてもURIとして扱われます;
- セッション名 - プラグイン設定ファイル内にその名前が見つかった場合;
- TNSキー - ResolveTNS オプションが true に設定されており、かつ上記のいずれの条件にも該当しない場合;
- TNS値 - 開き括弧 "(" で始まる場合（先頭の空白は無視されます）。 この場合、ResolveTNS オプションは考慮されません。
- **user** - Oracleユーザー名。ログインオプション `as sysdba`、`as sysoper`、`as sysasm`、`as sysbackup`、`as sysdg`、`as syskm`、または `as sysrac` のいずれかを `user as sysdba` の形式で末尾に追加できます（ログインオプションは大文字小文字を区別せず、末尾にスペースを含めてはいけません）。
- **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 object*。 パラメータ: - **connString** - 次のいずれかを指定できます:
- URI - 指定された名前のセッションが見つからず、`Plugins.Oracle.ResolveTNS` が false に設定されている場合。 スキーマ（例: "tcp://"）、ポート（例: 1521）、またはその両方を含む場合、ResolveTNS オプションは考慮されず、いずれにしても URI として扱われます。
- セッション名 - その名前がプラグイン設定ファイル内で見つかった場合。
- TNSキー - ResolveTNS オプションが true に設定されており、かつ上記のいずれの条件にも該当しない場合。
- TNS値 - 開き括弧 "(" で始まる場合（先頭の空白は無視されます）。 この場合、ResolveTNS オプションは考慮されません。
- **user** - Oracleユーザー名。ログインオプション `as sysdba`、`as sysoper`、`as sysasm`、`as sysbackup`、`as sysdg`、`as syskm`、`as sysrac` のいずれかを `user as sysdba` の形式で末尾に追加できます（ログインオプションは大文字小文字を区別せず、末尾に空白を含めてはいけません）。
- **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 に設定されている場合。 スキーマ（例: "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 object*。 パラメータ: - **connString** - 次のいずれかを指定できます:
- URI - 指定された名前のセッションが見つからず、`Plugins.Oracle.ResolveTNS` が false に設定されている場合。 スキーマ（例: "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 に設定されている場合。 スキーマ（例: "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 に設定されている場合。 スキーマ（例: "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 に設定されている場合。 スキーマ（例: "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 に設定されている場合。 スキーマ（例: "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 に設定されている場合。 スキーマ（例: "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 に設定されている場合。 スキーマ（例: "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 に設定されている場合。 スキーマ（例: "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 ワーカーの数。
戻り値: *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 object*。 パラメーター: - **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 object*。 パラメーター: - **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 object*。 パラメーター: - **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** - クエリに渡す1つまたは複数のカンマ区切りの引数。 [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 object*。 パラメーター: - **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}
データベースごとの付与済みロックに関する情報です。 [low-level discovery](/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]: # ({/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* - グロブスタイルのパターンが使用された場合; パターンにワイルドカード文字が含まれていない場合は単一の値。 パラメータ: - **connString** - URIまたはセッション名;
- **password** - Redisのパスワード;
- **pattern** - グロブスタイルのパターン(デフォルトは*\*)。 コメント: - セキュリティ警告: `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** - 情報の[セクション](https://redis.io/commands/info)（デフォルトは*default*）。
[comment]: # ({/2332f252-8c5408f6}) [comment]: # ({8a82f58e-7952fb43}) ##### redis.ping[connString,] {#redis.ping}
接続が生きているかどうかをテストします。
戻り値: *1* - 接続が生きている; *0* - 接続が切れている (AUTHや設定の問題を含むエラーが発生した場合)。 パラメータ: - **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オブジェクト*。 コメント: - 次のマクロとその値が返されます: {\#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オブジェクト*。 パラメータ: - **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オブジェクト*。 パラメータ: - **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 name** - ユニット名（アイテムプロトタイプで{\#UNIT.NAME}マクロを使用して名前を検出することができます）;
- **property** - ユニットプロパティ（例：ActiveState（デフォルト）、LoadState、Description）; - **interface** - ユニットインターフェースタイプ（例：Unit（デフォルト）、Socket、Service）。 コメント: - このアイテムはLinuxプラットフォームでのみサポートされています; - このアイテムは、[dbus API](https://www.freedesktop.org/wiki/Software/systemd/dbus/)で説明されているように、特定のインターフェースタイプから特定のプロパティを取得できます。 例: ```default systemd.unit.info["{#UNIT.NAME}"] #検出されたsystemdユニットのアクティブ状態（active、reloading、inactive、failed、activating、deactivating）情報を収集 systemd.unit.info["{#UNIT.NAME}",LoadState] #検出されたsystemdユニットのロード状態情報を収集 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] #このソケットユニットからの接続数を収集 ``` [comment]: # ({/4e7e754c-04d19e13}) [comment]: # ({7b51879a-28908462}) ##### systemd.unit.discovery[] {#systemd.unit.discovery}
systemdユニットとその詳細のリスト。 [ローレベルディスカバリ](/manual/discovery/low_level_discovery/examples/systemd)で使用されます。
戻り値: *JSONオブジェクト*。 パラメータ: - **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 object*。 パラメータ: - **hostname** - IPまたはDNSのいずれかを指定できます。
URLスキーム（*https* のみ）、パス（無視されます）、およびポートを含めることができます。
第1パラメータと第2パラメータの両方でポートが指定されている場合、それらの値は一致している必要があります。
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})