このページで
11 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 | Unixシステムでは/usr/local/share/zabbix/custom-queries/oracleWindowsシステムでは *:\Program Files\Zabbix Agent 2\Custom Queries\Oracle。ここで*はProgramFiles環境変数のドライブ名です |
カスタムクエリを含む.sqlファイルが置かれたディレクトリのフルパス名です。例: /etc/zabbix/oracle/sql |
|
| Plugins.Oracle.CustomQueriesEnabled | no | false | 設定すると、oracle.custom.queryアイテムキーの実行を有効にします。無効の場合、カスタムクエリディレクトリのパスからクエリは読み込まれません。 |
|
| 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スキームのみサポートされます。スキームは省略できます。ポートは省略できます（デフォルト=1521）。 Zabbix 7.4.3以降では、接続文字列として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.4.3以降でサポートされています。 |
| 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スキームのみサポートされます。スキームは省略できます。ポートは省略できます（デフォルト=1521）。 Zabbix 7.4.3以降では、接続文字列として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> - アイテムキーで使用するセッション名を定義します。 |
See also:
- 一般的な Zabbix エージェント 2 の設定パラメーターの説明: Zabbix agent 2 (UNIX) / Zabbix agent 2 (Windows)
- プラグインの設定手順
脚注
1 タイムアウトは、Zabbix エージェント 2 の設定ファイル（zabbix_agent2.conf または zabbix_agent2.win.conf）の Timeout オプションで定義されます。