このページで
10 Oracleプラグイン
概要
このセクションでは、Oracle Zabbix エージェント 2 のプラグイン設定ファイル（oracle.conf）でサポートされているパラメータを一覧表示します。
次の点に注意してください。
- デフォルト値は、同梱の設定ファイル内の値ではなく、プロセスのデフォルト値を反映しています。
- Zabbix がサポートする設定ファイルは、BOM なしの UTF-8 エンコーディングのみです。
- "#" で始まるコメントは、行頭でのみサポートされます。
パラメーター
| Parameter | Mandatory | Range | Default | Description |
|---|---|---|---|---|
| Plugins.Oracle.CallTimeout | no | 1-30 | Timeout1 | リクエストの完了を待機する最大時間（秒）です。 このパラメーターは現在、効果がありません。最大待機時間は代わりにitem timeoutによって決定されます。 |
| Plugins.Oracle.ConnectTimeout | no | 1-30 | Timeout1 | 接続が確立されるまでの最大待機時間（秒）です。 |
| Plugins.Oracle.CustomQueriesPath | no | カスタムクエリを含む .sql ファイルが格納されたディレクトリの完全なパス名です。 デフォルトでは無効です。 例: /etc/zabbix/oracle/sql |
||
| Plugins.Oracle.Default.Password | no | Oracle への接続に使用するデフォルトのパスワードです。アイテムキーまたは名前付きセッションで値が指定されていない場合に使用されます。 | ||
| Plugins.Oracle.Default.Service | no | Oracle への接続に使用するデフォルトのサービス名です（SID はサポートされていません）。アイテムキーまたは名前付きセッションで値が指定されていない場合に使用されます。 | ||
| Plugins.Oracle.Default.Uri | no | tcp://localhost:1521 | Oracle への接続に使用するデフォルトの URI です。アイテムキーまたは名前付きセッションで値が指定されていない場合に使用されます。 埋め込み資格情報を含めないでください（無視されます）。 URI 形式に一致している必要があります。 tcp スキームのみサポートされます。スキームは省略できます。ポートは省略可能です（default=1521）。 Zabbix 7.0.19 以降では、接続文字列として TNS キーまたは TNS 値を指定することもできます。TNS 値は空白を含めずに記述する必要があります。 例: tcp://127.0.0.1:1521localhostzbx_tns_example（TNS キー）(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=localhost)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=xe)))（TNS 値） |
|
| Plugins.Oracle.Default.User | no | Oracle への接続に使用するデフォルトのユーザー名です。アイテムキーまたは名前付きセッションで値が指定されていない場合に使用されます。 | ||
| Plugins.Oracle.KeepAlive | no | 60-900 | 300 | 未使用のプラグイン接続が閉じられるまでの最大待機時間（秒）です。 |
| Plugins.Oracle.ResolveTNS | no | true / false | false | このオプションは、Oracle サーバーへの接続に使用するメトリクスキー 'commonParams' 内の接続文字列（ConnString）の解釈方法を指定します。 false に設定すると、デフォルトのスキーマとポートが ConnString に追加されます（存在しない場合）。true に設定すると、デフォルトのスキーマとポートは省略され（ConnString に明示的に指定されている場合を除く）、ConnString はそのまま Oracle クライアントに渡されます。Oracle クライアントが tnsnames.ora ファイル内で ConnString を見つけた場合、見つかった接続記述が Oracle サーバーへの接続に使用されます。 このパラメーターは Zabbix 7.0.19 以降でサポートされます。 |
| Plugins.Oracle.Sessions.<SessionName>.Password | no | 名前付きセッションのパスワードです。 <SessionName> - アイテムキーで使用するセッション名を定義します。 |
||
| Plugins.Oracle.Sessions.<SessionName>.Service | no | 接続に使用する名前付きセッションのサービス名です（SID はサポートされていません）。 <SessionName> - アイテムキーで使用するセッション名を定義します。 |
||
| Plugins.Oracle.Sessions.<SessionName>.Uri | no | Oracle 用の名前付きセッション接続文字列です。 <SessionName> - アイテムキーで使用するセッション名を定義します。 埋め込み資格情報を含めないでください（無視されます）。 URI 形式に一致している必要があります。 tcp スキームのみサポートされます。スキームは省略できます。ポートは省略可能です（default=1521）。 Zabbix 7.0.19 以降では、接続文字列として TNS キーまたは TNS 値を指定することもできます。TNS 値は空白を含めずに記述する必要があります。 例: tcp://127.0.0.1:1521localhostzbx_tns_example（TNS キー）(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=localhost)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=xe)))（TNS 値） |
||
| Plugins.Oracle.Sessions.<SessionName>.User | no | 名前付きセッションのユーザー名です。 <SessionName> - アイテムキーで使用するセッション名を定義します。 |
参照:
- 一般的な Zabbix エージェント 2 の設定パラメーターの説明: Zabbix agent 2 (UNIX) / Zabbix agent 2 (Windows)
- プラグインの設定手順
脚注
1 タイムアウトは、Zabbix エージェント 2 の設定ファイル（zabbix_agent2.conf または zabbix_agent2.win.conf）の Timeout オプションで定義されます。