AIX DB2
AIX DB2 input は、DB2 CLP コマンドを通じてインスタンス、データベース、表スペース、HADR、およびカスタム指標を収集します。
設定¶
[inputs]
# ミドルウェア input の全体スイッチ。
enabled = true
[[inputs.db2]]
# インスタンス名。instance タグとして使用されます。
name = "db2inst1"
# この DB2 インスタンスの収集を有効にするかどうか。
enabled = true
# 収集間隔。
interval = "60s"
# 任意。収集前にインスタンス環境変数を読み込む。
env_file = ""
# HADR などの高度な指標を収集するかどうか。
collect_advanced = false
# 任意。カスタム指標コマンド。key=value 形式の行を出力すること。
deep_metrics_command = ""
# DB2 コマンドのパス。
db2_command = "db2"
db2pd_command = "db2pd"
# DB2 インスタンスユーザー。
instance_user = "db2inst1"
# 収集対象のデータベース一覧。
db_names = ["SAMPLE"]
コマンド依存¶
| コマンド | 説明 |
|---|---|
db2 get snapshot for dbm |
DB2 インスタンスの agent 指標を収集します。 |
db2 get snapshot for database on <db> |
データベースの接続、ロック、ログ、buffer pool の概要を収集します。 |
db2 list tablespaces show detail |
表スペース容量を収集します。 |
db2 get db cfg for <db> |
HADR、アーカイブログ関連の設定を収集します。 |
db2pd -db <db> -hadr |
collect_advanced = true のとき HADR の実行状態を収集します。 |
deep_metrics_command |
カスタムコマンド。key=value 行を出力し、カスタム指標を収集します。 |
指標¶
すべての指標には host、input=db2、instance=<name> タグが付与されます。
db2_instance¶
| Tags & Fields | 説明 |
|---|---|
| host ( tag) |
ホスト名。 |
| input ( tag) |
固定で db2。 |
| instance ( tag) |
input インスタンス名。 |
| up | インスタンスコマンドの実行成功可否。 Type: int | (gauge) |
| agents | DB2 agents 数。 Type: int | (gauge) Unit: count |
| agents_registered | registered agents 数。 Type: int | (gauge) Unit: count |
| agents_waiting | token 待ちの agents 数。 Type: int | (gauge) Unit: count |
db2_database¶
| Tags & Fields | 説明 |
|---|---|
| db_name ( tag) |
データベース名。 |
| status ( tag) |
データベース状態。 |
| connected | データベースが active かどうか。 Type: int | (gauge) |
| connections | 現在の接続数。 Type: int | (gauge) Unit: count |
| locks_held | 現在保持しているロック数。 Type: int | (gauge) Unit: count |
| lock_waits | ロック待機回数。 Type: int | (count) Unit: count |
| deadlocks | デッドロック回数。 Type: int | (count) Unit: count |
| bufferpool_hit_pct | buffer pool のヒット率。 Type: float | (gauge) Unit: percent |
| log_available_bytes | 利用可能なログ領域。 Type: int | (gauge) Unit: digital,B |
| log_used_bytes | 使用済みログ領域。 Type: int | (gauge) Unit: digital,B |
db2_tablespace¶
| Tags & Fields | 説明 |
|---|---|
| db_name ( tag) |
データベース名。 |
| tablespace ( tag) |
表スペース名。 |
| total_pages | 総ページ数。 Type: int | (gauge) Unit: count |
| used_pages | 使用済みページ数。 Type: int | (gauge) Unit: count |
| free_pages | 空きページ数。 Type: int | (gauge) Unit: count |
| page_size_bytes | ページサイズ。 Type: int | (gauge) Unit: digital,B |
| used_pct | 使用率。 Type: float | (gauge) Unit: percent |
db2_database_config¶
| Tags & Fields | 説明 |
|---|---|
| db_name ( tag) |
データベース名。 |
| parameter ( tag) |
設定項目名。 |
| value | 数値型の設定項目値。 Type: int | (gauge) |
db2_hadr¶
| Tags & Fields | 説明 |
|---|---|
| db_name ( tag) |
データベース名。 |
| member ( tag) |
HADR メンバー。 |
| hadr_role ( tag) |
HADR ロール。 |
| hadr_state ( tag) |
HADR 状態。 |
| hadr_connect_status ( tag) |
HADR 接続状態。 |
| connected | HADR が接続済みかどうか。 Type: int | (gauge) |
| primary | HADR ロールが PRIMARY かどうか。 Type: int | (gauge) |
| hadr_log_gap | HADR のログギャップ。 Type: int | (gauge) Unit: count |
| standby_replay_log_gap | standby replay のログギャップ。 Type: int | (gauge) Unit: count |
カスタム指標¶
カスタム指標のフィールドは deep_metrics_command の出力によって決まります。表に列挙したフィールドは tag として扱われ、それ以外の key=value のうち数値は float | (gauge) field として報告され、数値以外は tag になります。数値 field がない場合は count=1 を補完し、単位は count になります。
| Measurement | Tags | 説明 |
|---|---|---|
db2_table_metric |
table, db_name, schema |
カスタムのテーブル指標。 |
db2_index_metric |
index, db_name, schema, table |
カスタムのインデックス指標。 |
db2_long_transaction |
application, db_name, auth_id |
カスタムの長時間トランザクション指標。 |
db2_purescale_member |
member, db_name, status |
カスタムの pureScale member 指標。 |
db2_deep_metric |
metric, db_name, unit |
汎用 DB2 カスタム指標。 |