11 Oracleプラグイン

概要

このセクションでは、Oracle Zabbix エージェント 2 プラグイン設定ファイル（oracle.conf）でサポートされているパラメータを一覧表示します。

以下の点に注意してください。

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

パラメータ

Parameter Mandatory Range Default Description
Plugins.Oracle.CallTimeout no 1-30 global timeout リクエストが完了するまでの最大待機時間（秒）です。
Plugins.Oracle.ConnectTimeout no 1-30 global timeout 接続が確立されるまでの最大待機時間（秒）です。
Plugins.Oracle.CustomQueriesPath no /usr/local/share/zabbix/custom-queries/oracle for Unix systems

*:\Program Files\Zabbix Agent 2\Custom Queries\Oracle for Windows systems, where * is the drive name from the ProgramFiles environment variable		 カスタムクエリを含む .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:1521
localhost
zbx_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:1521
localhost
zbx_tns_example (TNS キー)
(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=localhost)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=xe))) (TNS 値)
Plugins.Oracle.Sessions.<SessionName>.User no 名前付きセッションのユーザー名です。
<SessionName> - アイテムキーで使用するセッション名を定義します。

関連項目: