AIX Oracle
AIX Oracle input は sqlplus を使って SQL を実行し、データベース状態、セッション、表領域、ASM、FRA、待機イベント、拡張指標を収集します。
設定¶
[inputs]
# ミドルウェア input の全体スイッチ。
enabled = true
[[inputs.oracle]]
# インスタンス名。instance tag として使用されます。
name = "orcl"
# この Oracle インスタンスの収集を有効にするかどうか。
enabled = true
# 収集間隔。
interval = "60s"
# 任意。収集前にインスタンス環境変数を読み込む。
env_file = ""
# DataGuard、インスタンス情報、invalid objects などの拡張指標を収集するかどうか。
collect_advanced = false
# 任意。カスタム指標コマンド。key=value 行を出力します。
deep_metrics_command = ""
# Oracle の環境と接続情報。
oracle_home = "/u01/app/oracle/product/19c/dbhome_1"
oracle_sid = "ORCL"
sqlplus = "/u01/app/oracle/product/19c/dbhome_1/bin/sqlplus"
user = "datakitaix"
# パスワードは環境変数から読み取り、設定ファイルには書きません。
password_env = "DATAKITAIX_ORACLE_PASSWORD"
user が空の場合は connect / as sysdba を使用します。そうでない場合は password_env で指定した環境変数からパスワードを読み取ります。
コマンド依存¶
| コマンド | 説明 |
|---|---|
sqlplus -s /nolog |
Oracle SQL を実行します。 |
deep_metrics_command |
key=value 行を出力するカスタムコマンド。カスタム指標を収集します。 |
指標¶
すべての指標には host、input=oracle、instance=<name> タグが追加されます。
oracle¶
| Tags & Fields | Description |
|---|---|
| oracle_sid ( tag) |
Oracle SID。 |
| open_mode ( tag) |
データベースの open mode。 |
| up | SQL の実行が成功したかどうか。 Type: int | (gauge) |
| open | データベースが READ WRITE/READ ONLY かどうか。 Type: int | (gauge) |
| sessions | 現在の session 数。 Type: float | (gauge) Unit: count |
| processes | 現在の process 数。 Type: float | (gauge) Unit: count |
| archive_errors | アーカイブ先の異常数。 Type: float | (gauge) Unit: count |
| redo_log_groups | redo log group の数。 Type: float | (gauge) Unit: count |
oracle_tablespace¶
| Tags & Fields | Description |
|---|---|
| oracle_sid ( tag) |
Oracle SID。 |
| tablespace ( tag) |
表領域名。 |
| used_pct | 表領域の使用率。 Type: float | (gauge) Unit: percent |
oracle_asm_diskgroup¶
| Tags & Fields | Description |
|---|---|
| diskgroup ( tag) |
ASM ディスクグループ名。 |
| total_mb | 総容量。 Type: float | (gauge) Unit: digital,MB |
| free_mb | 空き容量。 Type: float | (gauge) Unit: digital,MB |
| used_pct | 使用率。 Type: float | (gauge) Unit: percent |
oracle_recovery_area¶
| Tags & Fields | Description |
|---|---|
| area ( tag) |
FRA 名。既定値は default。 |
| space_limit_mb | FRA の上限。 Type: float | (gauge) Unit: digital,MB |
| space_used_mb | FRA の使用済み容量。 Type: float | (gauge) Unit: digital,MB |
| reclaimable_mb | 回収可能容量。 Type: float | (gauge) Unit: digital,MB |
| used_pct | 使用率。 Type: float | (gauge) Unit: percent |
oracle_wait_class¶
| Tags & Fields | Description |
|---|---|
| wait_class ( tag) |
wait class。 |
| waits | 待機回数。 Type: int | (count) Unit: count |
| time_waited_cs | 待機時間。単位は centisecond。 Type: int | (count) |
oracle_datafile_status¶
| Tags & Fields | Description |
|---|---|
| status ( tag) |
datafile の状態。 |
| count | 対応する状態のデータファイル数。 Type: int | (gauge) Unit: count |
oracle_dataguard¶
| Tags & Fields | Description |
|---|---|
| oracle_sid ( tag) |
Oracle SID。 |
| name ( tag) |
DataGuard 指標名。 |
| unit ( tag) |
指標の単位。 |
| value | DataGuard の数値型指標値。 Type: float | (gauge) |
| value_seconds | DataGuard の時間間隔型指標値。 Type: float | (gauge) Unit: time,s |
| count | 数値でない DataGuard 指標のプレースホルダー。 Type: int | (gauge) Unit: count |
oracle_instance¶
| Tags & Fields | Description |
|---|---|
| oracle_sid ( tag) |
Oracle SID。 |
| instance ( tag) |
RAC/GV$INSTANCE のインスタンス名。 |
| host ( tag) |
インスタンスがあるホスト。 |
| status ( tag) |
インスタンス状態。 |
| parallel ( tag) |
インスタンスの parallel 状態。 |
| up | インスタンス状態が OPEN かどうか。 Type: int | (gauge) |
oracle_invalid_objects¶
| Tags & Fields | Description |
|---|---|
| oracle_sid ( tag) |
Oracle SID。 |
| owner ( tag) |
オブジェクトの owner。 |
| count | VALID でないオブジェクト数。 Type: float | (gauge) Unit: count |
カスタム指標¶
カスタム指標フィールドは deep_metrics_command の出力によって決まります。表に列挙されたフィールドは tag として扱われ、その他の key=value のうち数値は float | (gauge) field として報告され、数値でないものは tag になります。数値 field がない場合は count=1 を補い、単位は count です。
| Measurement | Tags | Description |
|---|---|---|
oracle_awr_metric |
metric, unit, oracle_sid |
カスタム AWR 指標。 |
oracle_ash_wait |
event, wait_class, oracle_sid |
カスタム ASH 待機指標。 |
oracle_sql |
sql_id, module, schema, oracle_sid |
カスタム SQL 指標。 |
oracle_segment |
segment, owner, segment_type, tablespace, oracle_sid |
カスタム segment 指標。 |
oracle_deep_metric |
metric, unit, oracle_sid |
汎用 Oracle カスタム指標。 |