AIX SAP

AIX SAP input 通过 sapcontrol 采集 SAP 实例进程、队列、enqueue 和高级指标。

配置¶

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

[[inputs.sap]]
# 实例名，会作为 instance tag。
name = "sap00"
# 是否启用该 SAP 实例采集。
enabled = true
# 采集间隔。
interval = "60s"
# 可选，采集前加载实例环境变量。
env_file = ""
# 是否采集 work process、alert、instance 等高级指标。
collect_advanced = false
# 可选，自定义指标命令，输出 key=value 行。
deep_metrics_command = ""
# SAP 实例号。
instance_number = "00"
# sapcontrol 命令路径。
sapcontrol = "sapcontrol"

命令依赖¶

命令	说明
`sapcontrol -nr <nr> -function GetProcessList`	采集实例进程状态。
`sapcontrol -nr <nr> -function GetQueueStatistic`	采集队列统计。
`sapcontrol -nr <nr> -function GetEnqueueStatistic`	采集 enqueue 统计。
`sapcontrol -nr <nr> -function ABAPGetWPTable`	`collect_advanced = true` 时采集 work process。
`sapcontrol -nr <nr> -function GetAlerts`	`collect_advanced = true` 时采集告警。
`sapcontrol -nr <nr> -function GetSystemInstanceList`	`collect_advanced = true` 时采集系统实例列表。
`deep_metrics_command`	自定义命令，输出 `key=value` 行，采集自定义指标。

指标¶

所有指标都会追加 host、input=sap、instance=<name> 标签。

`sap`¶

Tags & Fields	Description
instance_number (`tag`)	SAP instance number。
up	是否存在 running process。 Type: int \| (gauge)
running_processes	运行中进程数。 Type: int \| (gauge) Unit: count
stopped_processes	停止进程数。 Type: int \| (gauge) Unit: count

`sap_queue`¶

Tags & Fields	Description
instance_number (`tag`)	SAP instance number。
queue_length	当前队列长度。 Type: float \| (gauge) Unit: count
queue_high	队列高水位。 Type: float \| (gauge) Unit: count
queue_max	队列最大值。 Type: float \| (gauge) Unit: count
queue_writes	队列写次数。 Type: float \| (count) Unit: count
queue_reads	队列读次数。 Type: float \| (count) Unit: count

`sap_enqueue`¶

Tags & Fields	Description
instance_number (`tag`)	SAP instance number。
enqueue_locks	enqueue lock 数。 Type: float \| (gauge) Unit: count
enqueue_waits	enqueue wait 数。 Type: float \| (count) Unit: count
enqueue_errors	enqueue error 数。 Type: float \| (count) Unit: count
enqueue_high	enqueue 高水位。 Type: float \| (gauge) Unit: count
enqueue_max	enqueue 最大值。 Type: float \| (gauge) Unit: count
used_pct	使用率。 Type: float \| (gauge) Unit: percent

`sap_work_process`¶

Tags & Fields	Description
instance_number (`tag`)	SAP instance number。
wp_type (`tag`)	work process 类型。
count	work process 数量。 Type: int \| (gauge) Unit: count
running	running work process 数量。 Type: int \| (gauge) Unit: count
waiting	waiting work process 数量。 Type: int \| (gauge) Unit: count
held	held work process 数量。 Type: int \| (gauge) Unit: count
stopped	stopped work process 数量。 Type: int \| (gauge) Unit: count
errors	error work process 数量。 Type: int \| (gauge) Unit: count

`sap_alert`¶

Tags & Fields	Description
instance_number (`tag`)	SAP instance number。
severity (`tag`)	告警级别。
count	当前级别告警数量。 Type: int \| (gauge) Unit: count

`sap_instance`¶

Tags & Fields	Description
instance_number (`tag`)	SAP instance number。
instance (`tag`)	SAP 系统实例名。
hostname (`tag`)	实例主机名。
host (`tag`)	实例主机。
dispstatus (`tag`)	实例状态。
features (`tag`)	实例功能列表。
instance_nr	实例号。 Type: int \| (gauge)
http_port	HTTP 端口。 Type: int \| (gauge)
https_port	HTTPS 端口。 Type: int \| (gauge)
start_priority	启动优先级。 Type: int \| (gauge)
up	实例是否运行。 Type: int \| (gauge)

自定义指标¶

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

Measurement	Tags	Description
`sap_st03`	`metric`, `task_type`, `unit`	自定义 ST03 指标。
`sap_stad`	`transaction`, `user`, `client`	自定义 STAD 指标。
`sap_ccms`	`node`, `severity`, `class`	自定义 CCMS 指标。
`sap_deep_metric`	`metric`, `unit`	通用 SAP 自定义指标。