This is a translation of the original English documentation page. Help us make it better.

1 Zabbixエージェント2

Zabbixエージェント2は、UnixおよびWindows上のZabbixエージェントでサポートされているすべてのアイテムキーをサポートします。 このページでは、Zabbixエージェント2でのみ使用できる追加のアイテムキーについて、所属するプラグインごとにグループ化して詳細を説明します。

アイテムキーはパラメータや追加情報なしでリストされます。 アイテムキーをクリックすると、詳細が表示されます。

アイテムキー 説明 プラグイン
ceph.df.details The cluster's data usage and distribution among pools. Ceph
ceph.osd.stats Aggregated and per OSD statistics.
ceph.osd.discovery The list of discovered OSDs.
ceph.osd.dump The usage thresholds and statuses of OSDs.
ceph.ping Tests whether a connection to Ceph can be established.
ceph.pool.discovery The list of discovered pools.
ceph.status The overall cluster's status.
docker.container_info Low-level information about a container. Docker
docker.container_stats The container resource usage statistics.
docker.containers Returns the list of containers.
docker.containers.discovery Returns the list of containers. Used for low-level discovery.
docker.data.usage Information about the current data usage.
docker.images Returns the list of images.
docker.images.discovery Returns the list of images. Used for low-level discovery.
docker.info The system information.
docker.ping Test if the Docker daemon is alive or not.
ember.get Returns the result of the required device. Ember+
memcached.ping Test if a connection is alive or not. Memcached
memcached.stats Gets the output of the STATS command.
mongodb.collection.stats Returns a variety of storage statistics for a given collection. MongoDB
mongodb.collections.discovery Returns a list of discovered collections.
mongodb.collections.usage Returns the usage statistics for collections.
mongodb.connpool.stats Returns information regarding the open outgoing connections from the current database instance to other members of the sharded cluster or replica set.
mongodb.db.stats Returns the statistics reflecting a given database system state.
mongodb.db.discovery Returns a list of discovered databases.
mongodb.jumbo_chunks.count Returns the count of jumbo chunks.
mongodb.oplog.stats Returns the status of the replica set, using data polled from the oplog.
mongodb.ping Test if a connection is alive or not.
mongodb.rs.config Returns the current configuration of the replica set.
mongodb.rs.status Returns the replica set status from the point of view of the member where the method is run.
mongodb.server.status Returns the database state.
mongodb.sh.discovery Returns the list of discovered shards present in the cluster.
mongodb.version Returns the database server version.
mqtt.get Subscribes to a specific topic or topics (with wildcards) of the provided broker and waits for publications. MQTT
mssql.availability.group.get Returns availability groups. MSSQL
mssql.custom.query Returns the result of a custom query.
mssql.db.get Returns all available MSSQL databases.
mssql.job.status.get Returns the status of jobs.
mssql.last.backup.get Returns the last backup time for all databases.
mssql.local.db.get Returns databases that are participating in an Always On availability group and replica (primary or secondary) and are located on the server that the connection was established to.
mssql.mirroring.get Returns mirroring info.
mssql.nonlocal.db.get Returns databases that are participating in an Always On availability group and replica (primary or secondary) located on other servers (the database is not local to the SQL Server instance that the connection was established to).
mssql.perfcounter.get Returns the performance counters.
mssql.ping Test if a connection is alive or not.
mssql.quorum.get Returns the quorum info.
mssql.quorum.member.get Returns the quorum members.
mssql.replica.get Returns the replicas.
mssql.version Returns the MSSQL version.
mysql.custom.query Returns the result of a custom query. MySQL
mysql.db.discovery Returns the list of MySQL databases.
mysql.db.size The database size in bytes.
mysql.get_status_variables Values of the global status variables.
mysql.ping Test if a connection is alive or not.
mysql.replication.discovery Returns the list of MySQL replications.
mysql.replication.get_slave_status The replication status.
mysql.version The MySQL version.
net.dns.get Performs a DNS query and returns detailed DNS record information. Network
oracle.diskgroups.stats Returns the Automatic Storage Management (ASM) disk groups statistics. Oracle
oracle.diskgroups.discovery Returns the list of ASM disk groups.
oracle.archive.info The archive logs statistics.
oracle.cdb.info The Container Databases (CDBs) information.
oracle.custom.query The result of a custom query.
oracle.datafiles.stats Returns the data files statistics.
oracle.db.discovery Returns the list of databases.
oracle.fra.stats Returns the Fast Recovery Area (FRA) statistics.
oracle.instance.info The instance statistics.
oracle.pdb.info The Pluggable Databases (PDBs) information.
oracle.pdb.discovery Returns the list of PDBs.
oracle.pga.stats Returns the Program Global Area (PGA) statistics.
oracle.ping Test whether a connection to Oracle can be established.
oracle.proc.stats Returns the processes statistics.
oracle.redolog.info The log file information from the control file.
oracle.sga.stats Returns the System Global Area (SGA) statistics.
oracle.sessions.stats Returns the sessions statistics.
oracle.sys.metrics Returns a set of system metric values.
oracle.sys.params Returns a set of system parameter values.
oracle.ts.stats Returns the tablespaces statistics.
oracle.ts.discovery Returns a list of tablespaces.
oracle.user.info Returns Oracle user information.
oracle.version Returns the database server version.
pgsql.autovacuum.count The number of autovacuum workers. PostgreSQL
pgsql.archive The information about archived files.
pgsql.bgwriter The combined number of checkpoints for the database cluster, broken down by checkpoint type.
pgsql.cache.hit The PostgreSQL buffer cache hit rate.
pgsql.connections Returns connections by type.
pgsql.custom.query Returns the result of a custom query.
pgsql.db.age The age of the oldest FrozenXID of the database.
pgsql.db.bloating_tables The number of bloating tables per database.
pgsql.db.discovery The list of PostgreSQL databases.
pgsql.db.size The database size in bytes.
pgsql.dbstat Collects the statistics per database.
pgsql.dbstat.sum The summarized data for all databases in a cluster.
pgsql.locks The information about granted locks per database.
pgsql.oldest.xid The age of the oldest XID.
pgsql.ping Test if a connection is alive or not.
pgsql.queries Query metrics by execution time.
pgsql.replication.count The number of standby servers.
pgsql.replication.process The flush lag, write lag and replay lag per each sender process.
pgsql.replication.process.discovery The replication process name discovery.
pgsql.replication.recovery_role The recovery status.
pgsql.replication.status The status of replication.
pgsql.replication_lag.b The replication lag in bytes.
pgsql.replication_lag.sec The replication lag in seconds.
pgsql.uptime The PostgreSQL uptime in milliseconds.
pgsql.version Returns PostgreSQL version.
pgsql.wal.stat The WAL statistics.
redis.config Gets the configuration parameters of a Redis instance that match the pattern. Redis
redis.info Gets the output of the INFO command.
redis.ping Test if a connection is alive or not.
redis.slowlog.count The number of slow log entries since Redis was started.
smart.attribute.discovery Returns a list of S.M.A.R.T. device attributes. S.M.A.R.T.
smart.disk.discovery Returns a list of S.M.A.R.T. devices.
smart.disk.get Returns all available properties of S.M.A.R.T. devices.
systemd.unit.get Returns all properties of a systemd unit. Systemd
systemd.unit.info Systemd unit information.
systemd.unit.discovery The list of systemd units and their details.
web.certificate.get Validates the certificates and returns certificate details. Web certificates

参照:

アイテムキーの詳細

山括弧のないパラメータは必須です。 山括弧 < > でマークされたパラメータはオプションです。

ceph.df.details[connString,<user>,<apikey>]


クラスタのデータ使用量とプール間の配分
戻り値: JSON オブジェクト

パラメーター:

  • connString - URI またはセッション名
  • user, password - Ceph のログイン認証情報
ceph.osd.stats[connString,<user>,<apikey>]


OSDごとの集計統計情報
戻り値: JSONオブジェクト

パラメーター:

  • connString - URIまたはセッション名
  • user, password - Cephログイン認証情報
ceph.osd.discovery[connString,<user>,<apikey>]


検出されたOSDのリスト。低レベル検出に使用されます。
戻り値: JSONオブジェクト

パラメーター:

  • connString - URIまたはセッション名
  • user, password - Cephログイン認証情報
ceph.osd.dump[connString,<user>,<apikey>]


OSD の使用状況のしきい値とステータス
戻り値: JSON オブジェクト

パラメーター:

  • connString - URI またはセッション名
  • user, password - Ceph のログイン認証情報
ceph.ping[connString,<user>,<apikey>]


Cephへの接続を確立できるかどうかをテストします。
戻り値: 0 - 接続が切断されています(認証や設定の問題などのエラーが表示された場合); 1 - 接続が成功しています。

パラメーター:

  • connString - URIまたはセッション名
  • user, password - Cephのログイン認証情報
ceph.pool.discovery[connString,<user>,<apikey>]


検出されたプールのリスト低レベル検出に使用されます。
戻り値: JSON オブジェクト

パラメーター:

  • connString - URI またはセッション名
  • user, password - Ceph のログイン認証情報
ceph.status[connString,<user>,<apikey>]


クラスタ全体のステータス
戻り値: JSON オブジェクト

パラメーター:

  • connString - URI またはセッション名
  • user, password - Ceph のログイン認証情報
docker.container_info[<ID>,<info>]


コンテナに関する低レベル情報
戻り値: ContainerInspect API 呼び出しの出力を JSON 形式でシリアル化したもの

パラメーター:

  • ID - コンテナの ID または名前
  • info - 返される情報の量。サポートされる値: short (デフォルト) または full

Agent 2 ユーザー ('zabbix') に十分な権限を与えるには、'docker' グループ に追加する必要があります。追加されていない場合、チェックは失敗します。

docker.container_stats[<ID>]


コンテナリソースの使用状況統計
戻り値: ContainerStats API 呼び出しの出力と CPU 使用率 (パーセンテージ) を JSON 形式でシリアル化したもの

パラメーター:

  • ID - コンテナの ID または名前

Agent 2 ユーザー ('zabbix') に十分な権限を与えるには、'docker' グループ に追加する必要があります。そうでない場合、チェックは失敗します。

docker.containers


コンテナのリスト
戻り値: ContainerList API 呼び出しの出力を JSON 形式でシリアル化したもの。

Agent 2 ユーザー ('zabbix') に十分な権限を与えるには、'docker' グループ に追加する必要があります。そうでない場合、チェックは失敗します。

docker.containers.discovery[<options>]


コンテナのリストを返します。低レベル検出に使用されます。
戻り値: JSON オブジェクト

パラメーター:

  • options - すべてのコンテナを検出するか、実行中のコンテナのみを検出するかを指定します。サポートされる値: true - すべてのコンテナを返します。false - 実行中のコンテナのみを返します (デフォルト)

エージェント 2 ユーザー ('zabbix') に十分な権限を与えるには、'docker' グループ に追加する必要があります。そうでない場合、チェックは失敗します。

docker.data.usage


現在のデータ使用量に関する情報
戻り値: SystemDataUsage API 呼び出しの出力を JSON 形式でシリアル化したもの

Agent 2 ユーザー ('zabbix') に十分な権限を与えるには、'docker' グループ に追加する必要があります。そうでない場合、チェックは失敗します。

docker.images


イメージのリストを返します。
戻り値: ImageList API 呼び出しの出力を JSON としてシリアル化したもの

Agent 2 ユーザー ('zabbix') に十分な権限を与えるには、'docker' グループ に追加する必要があります。そうでない場合、チェックは失敗します。

docker.images.discovery


イメージのリストを返します。低レベル検出に使用されます。
戻り値: JSON オブジェクト

十分な権限を得るには、エージェント 2 ユーザー ('zabbix') を 'docker' グループ に追加する必要があります。追加されていない場合、チェックは失敗します。

docker.info


システム情報
戻り値: SystemInfo API 呼び出しの出力を JSON 形式でシリアル化したもの

Agent 2 ユーザー ('zabbix') に十分な権限を与えるには、'docker' グループ に追加する必要があります。そうでない場合、チェックは失敗します。

docker.ping


Dockerデーモンが稼働中かどうかをテストします。
戻り値: 1 - 接続が稼働中、0 - 接続が切断されています。

エージェント2のユーザー('zabbix')を'docker'グループに追加して、十分な権限を付与する必要があります。そうでない場合、チェックは失敗します。

ember.get[<uri>,<path>]


要求されたデバイスの結果を返します。
戻り値: JSON オブジェクト

パラメーター:

  • uri - Ember+ デバイスの URI。デフォルト: 127.0.0.1:9998;
  • path - デバイスの OID パス。デフォルトは空で、ルートコレクションデータを返します。
memcached.ping[connString,<user>,<password>]


接続が確立されているかどうかをテストします。
戻り値: 1 - 接続が確立されています。0 - 接続が切断されています(認証や設定の問題など、何らかのエラーが表示されている場合)

パラメーター:

  • connString - URI またはセッション名
  • user, password - Memcached のログイン認証情報
memcached.stats[connString,<user>,<password>,<type>]


STATSコマンドの出力を取得します。
戻り値: JSON - 出力はJSONとしてシリアル化されます。

パラメーター:

  • connString - URIまたはセッション名
  • user, password - Memcachedのログイン認証情報
  • type - 返される統計情報の種類: itemssizesslabs、またはsettings (デフォルトは空で、一般的な統計情報を返します)
mongodb.collection.stats[connString,<user>,<password>,<database>,collection]


指定されたコレクションのさまざまなストレージ統計情報を返します。
戻り値: JSON オブジェクト

パラメーター:

  • connString - URI またはセッション名
  • user, password - MongoDB ログイン認証情報
  • database - データベース名 (デフォルト: admin)
  • collection - コレクション名
mongodb.collections.discovery[connString,<user>,<password>]


検出されたコレクションのリストを返します。ローレベルディスカバリに使用されます。
戻り値: JSON オブジェクト

パラメーター:

  • connString - URI またはセッション名
  • user, password - MongoDB ログイン認証情報
mongodb.collections.usage[connString,<user>,<password>]


コレクションの使用状況統計を返します。
戻り値: JSON オブジェクト

パラメーター:

  • connString - URI またはセッション名
  • user, password - MongoDB ログイン認証情報
mongodb.connpool.stats[connString,<user>,<password>]


現在のデータベースインスタンスからシャードクラスタまたはレプリカセットの他のメンバーへのオープンな送信接続に関する情報を返します。
戻り値: JSON オブジェクト

パラメーター:

  • connString - URI またはセッション名
  • user, password - MongoDB ログイン認証情報
  • database - データベース名 (デフォルト: admin)
  • collection - コレクション名
mongodb.db.stats[connString,<user>,<password>,<database>]


指定されたデータベースシステムの状態を反映する統計情報を返します。
戻り値: JSON オブジェクト

パラメーター:

  • connString - URI またはセッション名
  • user, password - MongoDB ログイン認証情報
  • database - データベース名 (デフォルト: admin)
mongodb.db.discovery[connString,<user>,<password>]


検出されたデータベースのリストを返します。低レベル検出に使用されます。
戻り値: JSON オブジェクト

パラメーター:

  • connString - URI またはセッション名
  • user, password - MongoDB のログイン認証情報
mongodb.jumbo_chunks.count[connString,<user>,<password>]


ジャンボチャンクの数を返します。
戻り値: JSON オブジェクト

パラメーター:

  • connString - URI またはセッション名
  • user, password - MongoDB ログイン認証情報
mongodb.oplog.stats[connString,<user>,<password>]


oplog からポーリングしたデータを使用して、レプリカセットのステータスを返します。
戻り値: JSON オブジェクト

パラメーター:

  • connString - URI またはセッション名
  • user, password - MongoDB のログイン認証情報
mongodb.ping[connString,<user>,<password>]


接続が確立されているかどうかをテストします。
戻り値: 1 - 接続が確立されています。0 - 接続が切断されています(認証や設定の問題など、何らかのエラーが表示されている場合)

パラメーター:

  • connString - URI またはセッション名
  • user, password - MongoDB のログイン認証情報
mongodb.rs.config[connString,<user>,<password>]


レプリカセットの現在の設定を返します。
戻り値: JSON オブジェクト

パラメーター:

  • connString - URI またはセッション名
  • user, password - MongoDB ログイン認証情報
mongodb.rs.status[connString,<user>,<password>]


メソッドが実行されたメンバーの観点から、レプリカセットのステータスを返します。
戻り値: JSON オブジェクト

パラメーター:

  • connString - URI またはセッション名
  • user, password - MongoDB ログイン認証情報
mongodb.server.status[connString,<user>,<password>]


データベースの状態を返します。
戻り値: JSON オブジェクト

パラメーター:

  • connString - URI またはセッション名
  • user, password - MongoDB ログイン認証情報
mongodb.sh.discovery[connString,<user>,<password>]


クラスター内に存在する検出されたシャードのリストを返します。
戻り値: JSON オブジェクト

パラメーター:

  • connString - URI またはセッション名
  • user, password - MongoDB ログイン認証情報
mongodb.version[connString,<user>,<password>]


データベースサーバーのバージョンを返します。
戻り値: String

パラメーター:

  • connString - URIまたはセッション名
  • user, password - MongoDBログイン認証情報
mqtt.get[<broker url>,topic,<user>,<password>]


指定されたブローカーの特定のトピック(ワイルドカード指定可能)をサブスクライブし、パブリケーションを待機します。
戻り値: トピックの内容によって異なります。ワイルドカードが使用されている場合は、トピックの内容をJSON形式で返します。

パラメーター:

  • broker url - クエリパラメーターを含まない protocol://host:port 形式のMQTTブローカーURL(サポートされるプロトコル: tcpsslws)。値が指定されていない場合、エージェントは tcp://localhost:1883 を使用します。プロトコルまたはポートが省略されている場合、デフォルトのプロトコル(tcp)またはポート(1883)が使用されます。
  • topic - MQTTトピック(必須)。ワイルドカード (+,#) がサポートされています。
  • user, password - 認証情報 (必要な場合)。

コメント:

  • アイテムは アクティブチェック ('Zabbix エージェント (アクティブ)'アイテムタイプ) として設定する必要があります。
  • TLS 暗号化証明書は、デフォルトの場所 (Ubuntu の場合は /etc/ssl/certs/ ディレクトリなど) に保存することで使用できます。TLS の場合は tls:// スキームを使用します。
mssql.availability.group.get[URI,<user>,<password>]


可用性グループを返します。
戻り値: JSON オブジェクト

パラメーター:

  • URI - MSSQL サーバーの URI (サポートされているスキーマは sqlserver:// のみです)。埋め込まれた認証情報は無視されます。Zabbix 7.0.6 からURI の一部としてインスタンス名を指定できます (例: sqlserver://localhost/InstanceName (ポート番号なし))ポート番号が指定されている場合、インスタンス名は無視されます。
  • user, password - 保護された MSSQL サーバーに送信するユーザー名とパスワード

詳細については、MSSQL プラグイン の Readme を参照してください。

mssql.custom.query[URI,<user>,<password>,queryName,<args...>]


カスタムクエリの結果を返します。
戻り値: JSON オブジェクト

パラメーター:

  • URI - MSSQL サーバーの URI (サポートされているスキーマは sqlserver:// のみです)。埋め込まれた資格情報は無視されます。Zabbix 7.0.6 から URI の一部としてインスタンス名を指定できます (例: sqlserver://localhost/InstanceName (ポート番号なし))。ポートが指定されている場合、インスタンス名は無視されます。
  • user, password - 保護されたMSSQLサーバーに送信するユーザー名とパスワード
  • queryName - Plugins.MSSQL.CustomQueriesDirで設定されたカスタムクエリの名前(拡張子.sqlを除く)
  • args - クエリに渡す1つまたは複数のカンマ区切りの引数

詳細については、MSSQLプラグインのReadmeを参照してください。

mssql.db.get


利用可能なすべてのMSSQLデータベースを返します。
戻り値: JSONオブジェクト

詳細については、MSSQLプラグインのReadmeをご覧ください。

mssql.job.status.get


ジョブのステータスを返します。
戻り値: JSON オブジェクト

詳細については、MSSQL プラグイン の Readme を参照してください。

mssql.last.backup.get


すべてのデータベースの最終バックアップ時刻を返します。
戻り値: JSON オブジェクト

詳細については、MSSQL プラグイン の Readme を参照してください。

mssql.local.db.get


Always On 可用性グループとレプリカ(プライマリまたはセカンダリ)に参加しており、接続が確立されたサーバー上にあるデータベースを返します。
戻り値: JSON オブジェクト

詳細については、MSSQL プラグイン の Readme を参照してください。

mssql.mirroring.get


ミラーリング情報を返します。
戻り値: JSON オブジェクト

詳細については、MSSQL プラグイン の Readme を参照してください。

mssql.nonlocal.db.get


Always On 可用性グループに参加しているデータベースと、他のサーバー上にあるレプリカ(プライマリまたはセカンダリ)を返します(データベースは、接続が確立された SQL Server インスタンスのローカルではありません)
戻り値: JSON オブジェクト

詳細については、MSSQL プラグイン の Readme を参照してください。

mssql.perfcounter.get


パフォーマンスカウンターを返します。
戻り値: JSON オブジェクト

詳細については、MSSQL プラグイン の Readme を参照してください。

mssql.ping


データベースにpingを実行します。接続が正しく設定されているかどうかをテストします。
戻り値: 1 - 正常、0 - 正常ではありません。

詳細については、MSSQL プラグイン の Readme を参照してください。

mssql.quorum.get


クォーラム情報を返します。
戻り値: JSON オブジェクト

詳細については、MSSQL プラグイン の Readme を参照してください。

mssql.quorum.member.get


クォーラムメンバーを返します。
戻り値: JSON オブジェクト

詳細については、MSSQL プラグイン の Readme を参照してください。

mssql.replica.get


レプリカを返します。
戻り値: JSON オブジェクト

詳細については、MSSQL プラグイン の Readme を参照してください。

mssql.version


MSSQL のバージョンを返します。
戻り値: 文字列

詳細については、MSSQL プラグイン の Readme を参照してください。

mysql.custom.query[connString,<user>,<password>,queryName,<args...>]


Returns the result of a custom query.
Return value: JSON object.

Parameters:

  • connString - URI or session name;
  • user, password - MySQL login credentials;
  • queryName - name of a custom query, must match SQL file name without an extension.
  • args - one or several comma-separated arguments to pass to a query.

Supported since Zabbix 6.4.6.

mysql.db.discovery[connString,<user>,<password>]


MySQLデータベースのリストを返します。ローレベルディスカバリに使用されます。
戻り値: LLD JSON形式での"show databases" SQLクエリの結果

パラメーター:

  • connString - URIまたはセッション名
  • user, password - MySQLログイン認証情報
mysql.db.size[connString,<user>,<password>,<database name>]


データベースのサイズ(バイト単位)
戻り値: 特定のデータベースに対するSQLクエリ"select coalesce(sum(data_length + index_length),0) as size from information_schema.tables where table_schema=?"の結果(バイト単位)

パラメーター:

  • connString - URIまたはセッション名
  • user, password - MySQLログイン認証情報
  • database name - データベース名
mysql.get_status_variables[connString,<user>,<password>]


グローバルステータス変数の値
戻り値: 「show global status」SQLクエリの結果(JSON形式)

パラメーター:

  • connString - URIまたはセッション名
  • user, password - MySQLログイン認証情報
mysql.ping[connString,<user>,<password>]


接続が確立されているかどうかをテストします。
戻り値: 1 - 接続が確立されています。0 - 接続が切断されています(認証や設定の問題など、何らかのエラーが表示されている場合)

パラメーター:

  • connString - URI またはセッション名
  • user, password - MySQL ログイン認証情報
mysql.replication.discovery[connString,<user>,<password>]


MySQLレプリケーションのリストを返します。ローレベルディスカバリに使用されます。
戻り値: LLD JSON形式での"show slave status" SQLクエリの結果

パラメーター:

  • connString - URIまたはセッション名
  • user, password - MySQLログイン認証情報
mysql.replication.get_slave_status[connString,<user>,<password>,<master host>]


レプリケーションのステータス
戻り値: JSON形式での「show slave status」SQLクエリの結果

パラメーター:

  • connString - URIまたはセッション名
  • user, password - MySQLログイン認証情報
  • master host - レプリケーションマスターホスト名。見つからない場合はエラーが返されます。このパラメーターが指定されていない場合は、すべてのホストが返されます。
mysql.version[connString,<user>,<password>]


MySQLのバージョン
戻り値: String (MySQLインスタンスのバージョン)

パラメーター:

  • connString - URIまたはセッション名
  • user, password - MySQLログイン認証情報
net.dns.get[<ip>,name,<type>,<timeout>,<count>,<protocol>,"<flags>"]

DNSクエリを実行し、詳細なDNSレコード情報を返します。
このアイテムは、net.dns.record Zabbixエージェントアイテムの拡張版で、より多くのレコードタイプとカスタマイズ可能なフラグをサポートしています。
戻り値: JSONオブジェクト

パラメーター:

  • ip - DNSサーバーのIPアドレス(デフォルトのDNSサーバーの場合は空白のままにします)
  • name - クエリ対象のDNS名
  • type - クエリ対象のレコードタイプ(デフォルトはSOA
  • timeout - リクエストのタイムアウト(秒数)(デフォルトは1秒)
  • count - リクエストの試行回数(デフォルトは2)
  • protocol - DNSクエリを実行するために使用されるプロトコル:udp(デフォルト)またはtcp
  • flags - クエリに渡す1つ以上のカンマ区切りの引数

コメント:

  • type に指定できる値は、ANSMDMFCNAMESOAMBMGMRNULLPTRHINFOMINFOMXTXTRPAFSDBX25ISDNRTNSAPPTRSIGKEYPXGPOSAAAALOCNXTEIDNIMLOCSRVATMANAPTRKXCERTDNAMEOPTAPLDSSSHFPIPSECKEYRRSIGNSECDNSKEYDHCIDNSEC3 です。 NSEC3PARAMTLSASMIMEAHIPNINFORKEYTALINKCDSCDNSKEYOPENPGPKEYCSYNCZONEMDSVCBHTTPSSPFUINFOUIDGIDUNSPECNIDL32L64LPEUI48EUI64URICAAAVCAMTRELAY。 値は大文字のみでなければなりません。小文字または大文字と小文字が混在した値はサポートされていません。
  • 逆DNSルックアップ(typePTRに設定されている場合)では、DNS名を逆引き形式と非逆引き形式の両方で指定できます(以下の例を参照) PTRレコードが要求された場合、DNS名は実際にはIPアドレスであることに注意してください。
  • flagsに指定できる値は、cdflagまたはnocdflag(デフォルト)、rdflag(デフォルト)またはnordflagdnssecまたはnodnssec(デフォルト)、nsidまたはnonsid(デフォルト)、edns0(デフォルト)またはnoedns0aaflagまたはnoaaflag(デフォルト)、adflagまたはnoadflag(デフォルト)です。 flags dnssecnsidは、どちらもedns0を必要とするため、noedns0と一緒に使用することはできません。 値は小文字のみでなければなりません。大文字または大文字と小文字が混在した値はサポートされていません。
  • 国際化ドメイン名はサポートされていません。代わりにIDNAエンコードされた名前を使用してください。
  • 出力は、指定されたパラメータに基づいたDNSレコード情報を含むオブジェクトです(詳細を参照してください)

例:

net.dns.get[192.0.2.0,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.0.8.0.f.0.0.4.0.5.4.1.0.0.a.2.ip6.arpa,PTR,,,,"cdflag,rdflag,nsid"]
oracle.diskgroups.stats[connString,<user>,<password>,<service>,<diskgroup>]


自動ストレージ管理(ASM)ディスクグループの統計を返します。
戻り値:JSONオブジェクト

パラメータ:

  • connString - URI またはセッション名
  • user - Oracle ユーザー名。ログインオプションas sysdbaas sysoperas sysasmのいずれかをuser as sysdbaの形式で追加できます(ログインオプションは大文字と小文字が区別されず、末尾にスペースを含めることはできません)。
  • password - Oracle パスワード
  • service - Oracle サービス名
  • diskgroup - クエリする ASM ディスクグループの名前
oracle.diskgroups.discovery[connString,<user>,<password>,<service>]


ASMディスクグループのリストを返します。低レベル検出に使用されます。
戻り値: JSONオブジェクト

パラメーター:

  • connString - URIまたはセッション名
  • user - Oracleユーザー名。ログインオプションas sysdbaas sysoperas sysasmのいずれかをuser as sysdbaの形式で追加できます(ログインオプションは大文字と小文字が区別されず、末尾にスペースを含めることはできません)。
  • password - Oracleパスワード
  • service - Oracleサービス名
oracle.archive.info[connString,<user>,<password>,<service>,<destination>]


アーカイブログの統計情報
戻り値: JSON オブジェクト

パラメーター:

  • connString - URI またはセッション名
  • user - Oracle ユーザー名。ログインオプションとして、as sysdbaas sysoperas sysasm のいずれかを user as sysdba の形式で追加できます(ログインオプションは大文字と小文字が区別されず、末尾にスペースを含めることはできません)。
  • password - Oracle パスワード
  • service - Oracle サービス名
  • destination - クエリの対象となる宛先の名前
oracle.cdb.info[connString,<user>,<password>,<service>,<database>]


コンテナ・データベース(CDB)の情報
戻り値: JSON オブジェクト

パラメーター:

  • connString - URI またはセッション名
  • user - Oracle ユーザー名。ログインオプションas sysdbaas sysoperas sysasmのいずれかをuser as sysdbaの形式で追加できます(ログインオプションは大文字と小文字が区別されず、末尾にスペースを含めることはできません)。
  • password - Oracle パスワード
  • service - Oracle サービス名
  • destination - クエリを実行するデータベースの名前
oracle.custom.query[connString,<user>,<password>,<service>,queryName,<args...>]


カスタムクエリの結果
戻り値: JSON オブジェクト

パラメーター:

  • connString - URI またはセッション名
  • user - Oracle ユーザー名。ログインオプション'as sysdba'、'as sysoper'、'as sysasm'のいずれかを'user as sysdba'の形式で追加できます(ログインオプションは大文字と小文字が区別されず、末尾にスペースを含めることはできません)
  • password - Oracle パスワード
  • service - Oracle サービス名
  • queryName - カスタムクエリの名前。拡張子を除いた SQL ファイル名と一致する必要があります。
  • args - クエリに渡す 1 つまたは複数のカンマ区切りの引数

コメント: - 返されるデータは自動的に JSON に変換されます。 - クエリから直接 JSON を返すことは避けてください。プラグインが再度 JSON に変換しようとする際に、JSON が破損する可能性があります。

oracle.datafiles.stats[connString,<user>,<password>,<service>]


データファイルの統計情報を返します。
戻り値: JSON オブジェクト

パラメーター:

  • connString - URI またはセッション名
  • user - Oracle ユーザー名。ログインオプション'as sysdba'、'as sysoper'、'as sysasm'のいずれかを'user as sysdba'の形式で追加できます(ログインオプションは大文字と小文字が区別されず、末尾にスペースを含めることはできません)。
  • password - Oracle パスワード
  • service - Oracle サービス名
  • diskgroup - クエリする ASM ディスクグループの名前
oracle.db.discovery[connString,<user>,<password>,<service>]


データベースのリストを返します。低レベル検出に使用されます。
戻り値: JSON オブジェクト

パラメーター:

  • connString - URI またはセッション名
  • user - Oracle ユーザー名。ログインオプション'as sysdba'、'as sysoper'、'as sysasm'のいずれかを'user as sysdba'の形式で追加できます(ログインオプションは大文字と小文字が区別されず、末尾にスペースを含めることはできません)。
  • password - Oracle パスワード
  • service - Oracle サービス名
oracle.fra.stats[connString,<user>,<password>,<service>]


高速リカバリ領域(FRA)統計情報を返します。
戻り値: JSON オブジェクト

パラメーター:

  • connString - URI またはセッション名
  • user - Oracle ユーザー名。ログインオプション'as sysdba'、'as sysoper'、'as sysasm'のいずれかを'user as sysdba'の形式で追加できます(ログインオプションは大文字と小文字が区別されず、末尾にスペースを含めることはできません)。
  • password - Oracle パスワード
  • service - Oracle サービス名
oracle.instance.info[connString,<user>,<password>,<service>]


インスタンスの統計情報
戻り値: JSON オブジェクト

パラメーター:

  • connString - URI またはセッション名
  • user - Oracle ユーザー名。ログインオプションas sysdbaas sysoperas sysasmのいずれかをuser as sysdbaの形式で追加できます(ログインオプションは大文字と小文字が区別されず、末尾にスペースを含めることはできません)
  • password - Oracle パスワード
  • service - Oracle サービス名
oracle.pdb.info[connString,<user>,<password>,<service>,<database>]


プラガブル・データベース(PDB)の情報
戻り値: JSON オブジェクト

パラメーター:

  • connString - URI またはセッション名
  • user - Oracle ユーザー名。ログインオプション(as sysdbaas sysoperas sysasm のいずれか)を user as sysdba の形式で追加できます(ログインオプションは大文字と小文字が区別されず、末尾にスペースを含めることはできません)
  • password - Oracle パスワード
  • service - Oracle サービス名
  • destination - クエリを実行するデータベースの名前
oracle.pdb.discovery[connString,<user>,<password>,<service>]


PDBのリストを返します。低レベル検出に使用されます。
戻り値: JSONオブジェクト

パラメーター:

  • connString - URIまたはセッション名
  • user - Oracleユーザー名。ログインオプションas sysdbaas sysoperas sysasmのいずれかをuser as sysdbaの形式で追加できます(ログインオプションは大文字と小文字が区別されず、末尾にスペースを含めることはできません)
  • password - Oracleパスワード
  • service - Oracleサービス名
oracle.pga.stats[connString,<user>,<password>,<service>]


プログラム・グローバル領域(PGA)の統計情報を返します。
戻り値:JSONオブジェクト

パラメーター:

  • connString - URIまたはセッション名
  • user - Oracleユーザー名。ログインオプションas sysdbaas sysoperas sysasmのいずれかをuser as sysdbaの形式で追加できます(ログインオプションは大文字と小文字が区別されず、末尾にスペースを含めることはできません)
  • password - Oracleパスワード
  • service - Oracleサービス名
oracle.ping[connString,<user>,<password>,<service>]


Oracle への接続を確立できるかどうかをテストします。
戻り値: 1 - 接続成功 0 - 接続失敗(AUTH や設定の問題など、何らかのエラーが発生した場合)

パラメーター:

  • connString - URI またはセッション名
  • user - Oracle ユーザー名。ログインオプションとして、as sysdbaas sysoperas sysasm のいずれかを user as sysdba という形式で追加できます(ログインオプションは大文字と小文字が区別されず、末尾にスペースを含めることはできません)
  • password - Oracle パスワード
  • service - Oracle サービス名
oracle.proc.stats[connString,<user>,<password>,<service>]


プロセスの統計情報を返します。
戻り値: JSON オブジェクト

パラメーター:

  • connString - URI またはセッション名
  • user - Oracle ユーザー名。ログインオプションas sysdbaas sysoperas sysasmのいずれかをuser as sysdbaの形式で追加できます(ログインオプションは大文字と小文字が区別されず、末尾にスペースを含めることはできません)
  • password - Oracle パスワード
  • service - Oracle サービス名
oracle.redolog.info[connString,<user>,<password>,<service>]


制御ファイルからのログファイル情報
戻り値: JSON オブジェクト

パラメータ:

  • connString - URI またはセッション名
  • user - Oracle ユーザー名。ログインオプションas sysdbaas sysoperas sysasmのいずれかをuser as sysdbaの形式で追加できます(ログインオプションは大文字と小文字が区別されず、末尾にスペースを含めることはできません)
  • password - Oracle パスワード
  • service - Oracle サービス名
oracle.sga.stats[connString,<user>,<password>,<service>]


システム・グローバル領域(SGA)の統計情報を返します。
戻り値:JSONオブジェクト

パラメーター:

  • connString - URIまたはセッション名
  • user - Oracleユーザー名。ログインオプションas sysdbaas sysoperas sysasmのいずれかをuser as sysdbaの形式で追加できます(ログインオプションは大文字と小文字が区別されず、末尾にスペースを含めることはできません)
  • password - Oracleパスワード
  • service - Oracleサービス名
oracle.sessions.stats[connString,<user>,<password>,<service>,<lockMaxTime>]


セッション統計を返します。
戻り値: JSON オブジェクト

パラメーター:

  • connString - URI またはセッション名
  • user - Oracle ユーザー名。ログインオプションas sysdbaas sysoperas sysasmのいずれかをuser as sysdbaの形式で追加できます(ログインオプションは大文字と小文字が区別されず、末尾にスペースを含めることはできません)
  • password - Oracle パスワード
  • service - Oracle サービス名
  • lockMaxTime - セッションを長時間ロックされたとカウントする最大セッションロック時間(秒)デフォルト: 600 秒
oracle.sys.metrics[connString,<user>,<password>,<service>,<duration>]


システムメトリック値のセットを返します。
戻り値: JSON オブジェクト

パラメーター:

  • connString - URI またはセッション名
  • user - Oracle ユーザー名。ログインオプションas sysdbaas sysoperas sysasmのいずれかをuser as sysdbaの形式で追加できます(ログインオプションは大文字と小文字が区別されず、末尾にスペースを含めることはできません)
  • password - Oracle パスワード
  • service - Oracle サービス名
  • duration - システムメトリック値のキャプチャ間隔(秒単位)可能な値: 60 — 長い期間 (デフォルト)、15 — 短い期間
oracle.sys.params[connString,<user>,<password>,<service>]


システムパラメータ値のセットを返します。
戻り値: JSON オブジェクト

パラメータ:

  • connString - URI またはセッション名
  • user - Oracle ユーザー名。ログインオプションas sysdbaas sysoperas sysasmのいずれかをuser as sysdbaの形式で追加できます(ログインオプションは大文字と小文字が区別されず、末尾にスペースを含めることはできません)
  • password - Oracle パスワード
  • service - Oracle サービス名
oracle.ts.stats[connString,<user>,<password>,<service>,<tablespace>,<type>,<conname>]


表領域の統計情報を返します。
戻り値: JSON オブジェクト

パラメーター:

  • connString - URI またはセッション名。
  • user - Oracle ユーザー名。ログインオプションas sysdbaas sysoperas sysasmのいずれかをuser as sysdbaの形式で追加できます(ログインオプションは大文字と小文字が区別されず、末尾にスペースを含めることはできません)
  • password - Oracle パスワード
  • service - Oracle サービス名
  • tablespace - クエリする表領域の名前。デフォルト(空のままでtypeが設定されている場合):
    - "TEMP"(typeが"TEMPORARY"に設定されている場合);
    - "USERS"(typeが"PERMANENT"に設定されている場合)
  • type - 問い合せる表領域のタイプ。デフォルト(「tablespace」が設定されている場合): "PERMANENT"
  • conname - 情報が必要なコンテナの名前。

tablespacetype、またはconnameが省略されている場合、この項目は一致するすべてのコンテナ(PDBとCDBを含む)の表領域統計を返します。

oracle.ts.discovery[connString,<user>,<password>,<service>]


表領域のリストを返します。低レベル検出に使用されます。
戻り値: JSON オブジェクト

パラメーター:

  • connString - URI またはセッション名
  • user - Oracle ユーザー名。ログインオプションas sysdbaas sysoperas sysasmのいずれかをuser as sysdbaの形式で追加できます(ログインオプションは大文字と小文字が区別されず、末尾にスペースを含めることはできません)
  • password - Oracle パスワード
  • service - Oracle サービス名
oracle.user.info[connString,<user>,<password>,<service>,<username>]


Oracle ユーザー情報を返します。
戻り値: JSON オブジェクト

パラメーター:

  • connString - URI またはセッション名
  • user - Oracle ユーザー名。ログインオプションas sysdbaas sysoperas sysasmのいずれかをuser as sysdbaの形式で追加できます(ログインオプションは大文字と小文字を区別せず、末尾にスペースを含めることはできません)
  • password - Oracle パスワード
  • service - Oracle サービス名
  • username - 情報が必要なユーザー名。小文字のユーザー名はサポートされていません。デフォルト: 現在のユーザー。
oracle.version[connString,<user>,<password>,<service>]


データベース・サーバーのバージョンを返します。
戻り値: String

パラメーター:

  • connString - URIまたはセッション名
  • user - Oracleユーザー名。ログイン・オプションas sysdbaas sysoperas sysasmのいずれかをuser as sysdbaの形式で追加できます(ログイン・オプションは大文字と小文字を区別せず、末尾にスペースを含めることはできません)
  • password - Oracleパスワード
  • service - Oracleサービス名
pgsql.autovacuum.count[uri,<username>,<password>,<database name>]


自動バキュームワーカーの数
戻り値: Integer

パラメーター:

  • uri - URIまたはセッション名
  • username, password - PostgreSQLの認証情報
  • database name - データベース名
pgsql.archive[uri,<username>,<password>,<database name>]


アーカイブされたファイルに関する情報
戻り値: JSON オブジェクト

パラメーター:

  • uri - URI またはセッション名
  • username, password - PostgreSQL の認証情報
  • database name - データベース名
pgsql.bgwriter[uri,<username>,<password>,<database name>]


データベースクラスターのチェックポイントの合計数(チェックポイントの種類別)
戻り値: JSON オブジェクト

パラメーター:

  • uri - URI またはセッション名
  • username, password - PostgreSQL の認証情報
  • database name - データベース名
pgsql.cache.hit[uri,<username>,<password>,<database name>]


PostgreSQLバッファキャッシュのヒット率
戻り値: Float

パラメーター:

  • uri - URIまたはセッション名
  • username, password - PostgreSQLの認証情報
  • database name - データベース名
pgsql.connections[uri,<username>,<password>,<database name>]


接続の種類
戻り値: JSON オブジェクト

パラメーター:

  • uri - URI またはセッション名
  • username, password - PostgreSQL の認証情報
  • database name - データベース名
pgsql.custom.query[uri,<username>,<password>,queryName,<args...>]


カスタムクエリの結果
戻り値: JSON オブジェクト

パラメーター:

  • uri - URI またはセッション名
  • username, password - PostgreSQL の認証情報
  • queryName - カスタムクエリの名前。拡張子を除いた SQL ファイル名と一致する必要があります。
  • args - クエリに渡す 1 つまたは複数のカンマ区切りの引数
pgsql.db.age[uri,<username>,<password>,<database name>]


データベースの最も古いFrozenXIDの経過時間
戻り値: Integer

パラメーター:

  • uri - URIまたはセッション名
  • username, password - PostgreSQLの認証情報
  • database name - データベース名
pgsql.db.bloating_tables[uri,<username>,<password>,<database name>]


データベースあたりの肥大化テーブル数
戻り値: Integer

パラメーター:

  • uri - URIまたはセッション名
  • username, password - PostgreSQLの認証情報
  • database name - データベース名
pgsql.db.discovery[uri,<username>,<password>,<database name>]


PostgreSQL データベースのリスト。ローレベルディスカバリ に使用されます。
戻り値: JSON オブジェクト

パラメーター:

  • uri - URI またはセッション名
  • username, password - PostgreSQL の認証情報
  • database name - データベース名
pgsql.db.size[uri,<username>,<password>,<database name>]


データベースのサイズ(バイト単位)
戻り値: Integer

パラメーター:

  • uri - URI またはセッション名
  • username, password - PostgreSQL の認証情報
  • database name - データベース名
pgsql.dbstat[uri,<username>,<password>,<database name>]


データベースごとの統計情報を収集します。ローレベルディスカバリに使用されます。
戻り値: JSON オブジェクト

パラメーター:

  • uri - URI またはセッション名
  • username, password - PostgreSQL の認証情報
  • database name - データベース名
pgsql.dbstat.sum[uri,<username>,<password>,<database name>]


クラスタ内のすべてのデータベースの要約データ
戻り値: JSON オブジェクト

パラメーター:

  • uri - URI またはセッション名
  • username, password - PostgreSQL の認証情報
  • database name - データベース名
pgsql.locks[uri,<username>,<password>,<database name>]


データベースごとに付与されたロックに関する情報。ローレベルディスカバリに使用されます。
戻り値: JSON オブジェクト

パラメーター:

  • uri - URI またはセッション名
  • username, password - PostgreSQL の認証情報
  • database name - データベース名
pgsql.oldest.xid[uri,<username>,<password>,<database name>]


最も古いXIDの経過時間
戻り値: Integer

パラメーター:

  • uri - URIまたはセッション名
  • username, password - PostgreSQLの認証情報
  • database name - データベース名
pgsql.ping[uri,<username>,<password>,<database name>]


接続が確立されているかどうかをテストします。
戻り値: 1 - 接続が確立されています。0 - 接続が切断されています(認証や設定の問題などのエラーが表示された場合)

パラメーター:

  • uri - URI またはセッション名
  • username, password - PostgreSQL の認証情報
  • database name - データベース名
pgsql.queries[uri,<username>,<password>,<database name>,<time period>]


実行時間に基づいてメトリクスをクエリします。
戻り値: JSON オブジェクト

パラメーター:

  • uri - URI またはセッション名
  • username, password - PostgreSQL の認証情報
  • database name - データベース名
  • timePeriod - スロークエリの数をカウントする実行時間制限(正の整数である必要があります)
pgsql.replication.count[uri,<username>,<password>]


スタンバイサーバーの数
戻り値: Integer

パラメーター:

  • uri - URIまたはセッション名
  • username, password - PostgreSQLの認証情報
pgsql.replication.process[uri,<username>,<password>]


送信プロセスごとのフラッシュ遅延、書き込み遅延、および再生遅延
戻り値: JSON オブジェクト

パラメーター:

  • uri - URI またはセッション名
  • username, password - PostgreSQL の認証情報
pgsql.replication.process.discovery[uri,<username>,<password>]


レプリケーションプロセス名discovery
戻り値: JSONオブジェクト

パラメーター:

  • uri - URIまたはセッション名
  • username, password - PostgreSQLの認証情報
pgsql.replication.recovery_role[uri,<username>,<password>]


リカバリの状態
戻り値: 0 - マスターモード。1 - リカバリ進行中(スタンバイモード)

パラメーター:

  • uri - URI またはセッション名
  • username, password - PostgreSQL の認証情報
pgsql.replication.status[uri,<username>,<password>]


レプリケーションのステータス
戻り値: 0 - ストリーミングが停止中。1 - ストリーミングが稼働中。2 - マスターモード

パラメーター:

  • uri - URI またはセッション名
  • username, password - PostgreSQL の認証情報
pgsql.replication_lag.b[uri,<username>,<password>]


レプリケーション遅延(バイト単位)
戻り値: Integer

パラメーター:

  • uri - URI またはセッション名
  • username, password - PostgreSQL の認証情報
pgsql.replication_lag.sec[uri,<username>,<password>]


レプリケーション遅延(秒)
戻り値: Integer

パラメーター:

  • uri - URI またはセッション名
  • username, password - PostgreSQL の認証情報
pgsql.uptime[uri,<username>,<password>,<database name>]


PostgreSQL の稼働時間(ミリ秒)
戻り値: Float

パラメーター:

  • uri - URI またはセッション名
  • username, password - PostgreSQL の認証情報
  • database name - データベース名
pgsql.version[uri,<username>,<password>,<database name>]


PostgreSQLのバージョン
戻り値: String

パラメーター:

  • uri - URIまたはセッション名
  • username, password - PostgreSQLの認証情報
  • database name - データベース名
pgsql.wal.stat[uri,<username>,<password>,<database name>]


WAL統計情報
戻り値: JSONオブジェクト

パラメーター:

  • uri - URIまたはセッション名
  • username, password - PostgreSQL認証情報
  • database name - データベース名
redis.config[connString,<password>,<pattern>]


パターンに一致するRedisインスタンスの設定パラメータを取得
戻り値: JSON - glob形式のパターンが使用された場合。単一の値 - パターンにワイルドカード文字が含まれていない場合。

パラメータ:

  • connString - URIまたはセッション名
  • password - Redisパスワード
  • pattern - glob形式のパターン(デフォルトは*
redis.info[connString,<password>,<section>]


INFO コマンドの出力を取得
戻り値: JSON - 出力は JSON としてシリアル化されます。

パラメーター:

  • connString - URI またはセッション名
  • password - Redis パスワード
  • section - 情報の セクション (デフォルトでは default)
redis.ping[connString,<password>]


接続が確立されているかどうかをテストします。
戻り値: 1 - 接続が確立されています。0 - 接続が切断されています(認証や設定の問題など、何らかのエラーが発生した場合)

パラメーター:

  • connString - URI またはセッション名
  • password - Redis パスワード
redis.slowlog.count[connString,<password>]


Redis 起動以降のスローログエントリ数
戻り値: Integer

パラメーター:

  • connString - URI またはセッション名
  • password - Redis パスワード
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"}
smart.disk.discovery


S.M.A.R.T.デバイスのリストを返します。
戻り値: JSONオブジェクト

コメント:

  • 以下のマクロとその値が返されます: {#NAME}, {#DISKTYPE}, {#MODEL}, {#SN}, {#PATH}, {#ATTRIBUTES}, {#RAIDTYPE};
  • HDD、SSD、NVMEドライブタイプがサポートされています。ドライブがRAIDに属していない場合、{#RAIDTYPE}は空になります。RAIDの場合、{#NAME}にはアドオンが付きます。例: {"{#NAME}": "/dev/sda cciss,2"}
smart.disk.get[<path>,<raid type>]


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"br>disk_type - ディスクの種類(HDD、SSD、または NVME)を保持します。例: {"disk_type": "ssd"}
  • パラメータが指定されていない場合、この項目はすべてのディスクに関する情報を返します。
systemd.unit.get[ユニット名,<インターフェース>]


systemd ユニットのすべてのプロパティを返します。
戻り値: JSON オブジェクト

パラメーター:

  • ユニット名 - ユニット名 (名前を確認するには、アイテムのプロトタイプで {#UNIT.NAME} マクロを使用することをお勧めします);
  • インターフェース - ユニットインターフェースの種類。指定可能な値: Unit (デフォルト)、ServiceSocketDeviceMountAutomountSwapTargetPath

コメント:

  • このアイテムは Linux プラットフォームでのみサポートされます。
  • ユニットインターフェースの LoadState、ActiveState、および UnitFileState は、テキストと整数として返されます: "ActiveState":{"state":1,"text":"active"}
systemd.unit.info[ユニット名,<プロパティ>,<インターフェース>]


systemd ユニット情報
戻り値: 文字列

パラメーター:

  • ユニット名 - ユニット名 (名前を確認するには、アイテムプロトタイプで {#UNIT.NAME} マクロを使用することをお勧めします);
  • プロパティ - ユニットプロパティ (例: ActiveState (デフォルト)、LoadState、Description);
  • インターフェース - ユニットインターフェースタイプ (例: Unit (デフォルト)、Socket、Service)

コメント:

  • このアイテムは Linux プラットフォームでのみサポートされます。
  • このアイテムを使用すると、dbus API で説明されているように、特定のタイプのインターフェースから特定のプロパティを取得できます。

例:

systemd.unit.info["{#UNIT.NAME}"] #検出されたsystemdユニットのアクティブ状態(アクティブ、リロード中、非アクティブ、失敗、アクティベート中、非アクティベート中)情報を収集します。
       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] #このソケットユニットからの接続数を収集します。
systemd.unit.discovery[<type>]


systemdユニットとその詳細のリスト。低レベル検出に使用されます。
戻り値: JSONオブジェクト

パラメーター:

  • type - 可能な値: allautomountdevicemountpathservice (デフォルト)、socketswaptarget

この項目はLinuxプラットフォームでのみサポートされます。

web.certificate.get[hostname,<port>,<address>]


証明書を検証し、証明書の詳細を返します。
戻り値: JSON オブジェクト

パラメーター:

  • hostname - IP または DNS のいずれかです。
    URL スキーム (https のみ)、パス (無視されます)、およびポート番号を含めることができます。
    第 1 パラメーターと第 2 パラメーターの両方にポート番号が指定されている場合は、それらの値が一致している必要があります。
    アドレス (第 3 パラメーター) が指定されている場合、ホスト名は SNI およびホスト名の検証にのみ使用されます。
  • port - ポート番号 (HTTPS の場合はデフォルト 443)。
  • address - IP または DNS のいずれかです。指定されている場合は、接続に使用され、ホスト名 (第 1 パラメーター) は SNI およびホストの検証に使用されます。第 1 パラメータが IP で第 3 パラメータが DNS の場合、第 1 パラメータは接続に使用され、第 3 パラメータは SNI とホスト検証に使用されます。

コメント:

  • ホスト構成で指定された接続先が存在しないか、利用できない場合、または TLS ハンドシェイクが無効な証明書以外のエラーで失敗した場合、この項目はサポートされません。
  • 現在、AIA (Authority Information Access) X.509 拡張、CRL と OCSP (OCSP ステープリングを含む)、および証明書の透明性はサポートされていません。
  • 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: 詳細な検証メッセージ(例:"証明書が正常に検証されました")
  • sha1_fingerprint: 証明書のSHA-1フィンガープリント
  • sha256_fingerprint: 証明書のSHA-256フィンガープリント
  • $.result.value フィールドは証明書の検証結果を示します。可能な値は次のとおりです。
  • valid – 証明書は有効で信頼されています。
  • valid-but-self-signed – 証明書は有効ですが自己署名されています。つまり、サブジェクトが発行者と一致しています。
  • invalid – 有効期限切れ、ホスト名の誤り、署名機関の不明などの問題により、証明書が無効です。

例:

web.certificate.get[example.com,443]

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"
       }