Oracleプラグイン

概要

設定パラメータを使用すると、Oracleプラグインの動作をカスタマイズできます。

これらは agent 2 の設定ファイルではなく、専用の設定ファイル（例: oracle.conf）に指定することを推奨します。その後、Include ディレクティブを使用して、このファイルを Zabbix agent 2 の設定に含めます。

すべてのパラメータは、パラメータが必須であると明示されていない限り、任意です。

このページの構成は次のとおりです。

• パラメータ概要（パラメータの詳細を表示するには、その名前をクリックします）
• パラメータ詳細

注意事項:

• デフォルト値は、配布される設定ファイルの値ではなく、プロセスのデフォルト値を反映しています。
• 値には 環境変数 を使用できます。
• Zabbix がサポートする設定ファイルの文字エンコーディングは UTF-8 のみで、BOM は含められません。
• "\#" で始まるコメントは、行頭でのみサポートされます。

パラメーターの詳細

Plugins.Oracle.CallTimeout

リクエストが完了するまでの最大待機時間（秒）です。
このパラメータは現在、効果がありません。最大待機時間は代わりにitem timeoutによって決定されます。

デフォルト: Timeout¹
範囲: 1-30

Plugins.Oracle.ConnectTimeout

接続が確立されるまでの最大待機時間を秒単位で指定します。

デフォルト: Timeout¹
範囲: 1-30

Plugins.Oracle.CustomQueriesPath

カスタムクエリを含む .sql ファイルが格納されたディレクトリの完全なパス名を指定します。

デフォルト:
/usr/local/share/zabbix/custom-queries/oracle - Unix システムの場合、
*:\Program Files\Zabbix Agent 2\Custom Queries\Oracle - Windows システムの場合 (* は ProgramFiles 環境変数のドライブ名)

例:

/etc/zabbix/oracle/sql

Plugins.Oracle.CustomQueriesEnabled

oracle.custom.query アイテムキーの実行を有効にします。
無効の場合、カスタムクエリディレクトリのパスからクエリは読み込まれません。

デフォルト: false
範囲: true/false

Plugins.Oracle.Default.Password

Oracle に接続するためのデフォルトパスワードを指定します。
アイテムキーまたは名前付きセッションで値が指定されていない場合に使用されます。

Plugins.Oracle.Default.Service

Oracle に接続するためのデフォルトのサービス名を指定します（SID はサポートされていません）。
アイテムキーまたは名前付きセッションで値が指定されていない場合に使用されます。

Plugins.Oracle.Default.Uri

Oracle に接続するためのデフォルト URI を指定します。
アイテムキーまたは名前付きセッションで値が指定されていない場合に使用されます。
埋め込み資格情報は無視されます。
URI 形式に一致する必要があります。
サポートされるスキーム: tcp, tcps
スキーマは省略できます。
ポートも省略できます（デフォルト=1521）。
接続文字列として TNS キーまたは TNS 値を指定することもできます。TNS 値は空白を含めずに構成する必要があります。

Examples:

tcp://127.0.0.1:1521
localhost
zbx_tns_example (TNS key)
(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=localhost)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=xe))) (TNS value)

Plugins.Oracle.Default.User

Oracle に接続するためのデフォルトのユーザー名を指定します。
アイテムキーまたは名前付きセッションで値が指定されていない場合に使用されます。

Plugins.Oracle.KeepAlive

未使用のプラグイン接続が閉じられるまでの最大待機時間を秒単位で設定します。

デフォルト: 300
範囲: 60-900

Plugins.Oracle.ResolveTNS

Oracleサーバーへの接続に使用する接続文字列（ConnString）の解釈方法を指定します。
false に設定すると、既定のスキームとポートが ConnString に追加されます（存在しない場合）。
このオプションを true に設定すると、既定のスキームとポートは省略されます（ConnString に明示的に指定されている場合を除く）。また、ConnString はそのまま Oracle クライアントに渡されます。Oracle クライアントが tnsnames.ora ファイル内で ConnString を見つけた場合は、見つかった接続記述を使用して Oracleサーバーに接続します。

既定: true
範囲: true/false

Plugins.Oracle.Sessions.<SessionName>.Password

Oracle に接続するための、指定したセッションのパスワードを設定します。
<SessionName> - アイテムキーで使用するセッション名を定義します。

Plugins.Oracle.Sessions.<SessionName>.Service

Oracle に接続するための、名前付きセッションのサービス名を指定します（SID はサポートされていません）。
<SessionName> - アイテムキーで使用するセッション名を定義します。

Plugins.Oracle.Sessions.<SessionName>.Uri

Oracle に接続するための、名前付きセッション URI を指定します。
<SessionName> - アイテムキーで使用するセッション名を定義します。
埋め込み資格情報は無視されます。
URI 形式に一致している必要があります。
サポートされるスキーム: tcp, tcps
スキームは省略できます。
ポートは省略できます（default=1521）。
接続文字列として TNS キーまたは TNS 値を指定することもできます。TNS 値は空白を含めずに記述する必要があります。

Examples:

tcp://127.0.0.1:1521
localhost
zbx_tns_example (TNS key)
(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=localhost)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=xe))) (TNS value)

Plugins.Oracle.Sessions.<SessionName>.User

Oracle に接続するための、指定したセッションのユーザー名を設定します。
<SessionName> - アイテムキーで使用するセッション名を定義します。

脚注

¹ タイムアウトは、Zabbix エージェント 2 の設定ファイル（zabbix_agent2.conf または zabbix_agent2.win.conf）内の Timeout オプションで定義されます。

関連項目

• 一般的な Zabbix エージェント 2 の設定パラメーターの説明: Zabbix agent 2 (UNIX) / Zabbix agent 2 (Windows)
• プラグイン の設定手順