AIX DB2

AIX DB2 input 通过 DB2 CLP 命令采集实例、数据库、表空间、HADR 和自定义指标。

配置¶

[inputs]
# 中间件 input 总开关。
enabled = true

[[inputs.db2]]
# 实例名，会作为 instance tag。
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	Description
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	Description
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	Description
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	Description
db_name (`tag`)	数据库名。
parameter (`tag`)	配置项名称。
value	数值型配置项值。 Type: int \| (gauge)

`db2_hadr`¶

Tags & Fields	Description
db_name (`tag`)	数据库名。
member (`tag`)	HADR member。
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 日志 gap。 Type: int \| (gauge) Unit: count
standby_replay_log_gap	standby replay log gap。 Type: int \| (gauge) Unit: count

自定义指标¶

自定义指标字段由 deep_metrics_command 输出决定。表中列出的字段会作为 tag；其他 key=value 中数字会作为 float | (gauge) field 上报，非数字会作为 tag。如果没有数字 field，会补充 count=1，单位为 count。

Measurement	Tags	Description
`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 自定义指标。