コンテンツにスキップ

AIX SAP

AIX SAP input は sapcontrol を使って、SAP インスタンスのプロセス、キュー、enqueue、および高度なメトリクスを収集します。

配置¶

[inputs]
# ミドルウェア input の全体スイッチ。
enabled = true

[[inputs.sap]]
# インスタンス名。instance タグとして使用されます。
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`¶

タグとフィールド	説明
instance_number (`tag`)	SAP インスタンス番号。
up	稼働中のプロセスが存在するかどうか。 Type: int \| (gauge)
running_processes	稼働中プロセス数。 Type: int \| (gauge) Unit: count
stopped_processes	停止中プロセス数。 Type: int \| (gauge) Unit: count

`sap_queue`¶

タグとフィールド	説明
instance_number (`tag`)	SAP インスタンス番号。
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`¶

タグとフィールド	説明
instance_number (`tag`)	SAP インスタンス番号。
enqueue_locks	enqueue ロック数。 Type: float \| (gauge) Unit: count
enqueue_waits	enqueue 待機数。 Type: float \| (count) Unit: count
enqueue_errors	enqueue エラー数。 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`¶

タグとフィールド	説明
instance_number (`tag`)	SAP インスタンス番号。
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`¶

タグとフィールド	説明
instance_number (`tag`)	SAP インスタンス番号。
severity (`tag`)	アラートレベル。
count	現在のレベルのアラート数。 Type: int \| (gauge) Unit: count

`sap_instance`¶

タグとフィールド	説明
instance_number (`tag`)	SAP インスタンス番号。
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	説明
`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 カスタムメトリクス。