DBXエージェントの設定

DBXエージェントに必要な設定は、whatap.confファイルに作成されます。設定できるオプションについては、次を参照してください。

基本オプション

license String

エージェントのインストール時にサーバーから付与されたプロジェクトアクセスキーを設定します。プロジェクトアクセスキーには、エージェントが属するプロジェクトとセキュリティ通信のためのパスワードキーが含まれています。
whatap.server.host String

既定値127.0.0.1,127.0.1

エージェントが収集したデータを送信するWhaTap収集サーバーのIPアドレスを設定します。収集サーバーの冗長化で2つ以上のIPを所有する場合は、コンマ(,)を区切り文字として使用します。設定したIPアドレスには、収集サーバーproxyデーモンがリスニング状態でサービスされる必要があります。

whatap.server.port String

既定値6600

収集サーバーのポート(port)を設定します。ポートは1つのみ設定ができるので、whatap_server_hostに設定した収集サーバは同一ポートを使用する必要があります。
dbms String

altibase

注意
別のオプション値を入力すると、モニティリングのデータ収集が正常に動作しない場合があります。

db String

接続するデータベース名です。

db_ip String

モニタリングするデータベースサーバーのIPアドレスを設定します。

db_port String

データベースが通信に使用するポート番号を設定します。

データ収集

db_param_enabled Boolean

既定値 true

DBパラメータの収集有無を設定します。

conn_fail_count Int

既定値 15

15回連続コネクションエラーが発生した時に通知を送信します。希望する回数を入力して、通知の発生基準を調整できます。

long_run_session_sec Second

既定値10 (単位：秒)

設定した時間より長く実行されているセッションを、long runセッションで処理します。

skip_whatap_session Int

既定値0

1が設定されている場合、WhaTapから収集するためのqueryが実行するセッションをactive session listに表示しません。(既定値：0)

segments Boolean

既定値 true

セグメントサイズの情報を収集します。統計/レポート > テーブルスペース容量増減メニューで当該データベースまたはテーブルスペースを選択すると、サイズ情報が確認できます。
segments_hour Int

既定値5

セグメントサイズの情報を収集する時刻を設定します。既定値は5であり、朝の5時に収集を始めます。
segments_min_size Int

既定値10

セグメントサイズの情報を収集する最小単位として既定値は10MBです。セグメントサイズ情報を収集する時に設定した値よりも小さいサイズのセグメントサイズ情報は収集しません。
tablespace_lock Boolean

既定値false

データファイルの追加やテーブルスペースの変更時に発生するテーブルスペースのロック(tablespace lock)をモニタリングするには、当該オプション値をtrueに変更します。

xview_min_sec Int

既定値0

xview収集時、クエリの実行時間が設定された時間よりも長くかかる場合にのみ収集します。デフォルトとしては、実行時間が0秒以上のすべてのクエリを収集します。

ユーザーメトリック収集 (SQLMON)

SQLMON は、ユーザー定義の SQL 結果を定期的に収集し、メトリクスとして保存します。
数値を返し、負荷が低いクエリに適しています。

sqlmon Int

デフォルト値: 1
- 1: dbx と sqlmon を同時に実行
- 2: sqlmon のみ実行
対応バージョン: 2.3.5 以上

設定

エージェントのインストールパスに sqlmon ディレクトリを作成します。
収集するクエリを .sql ファイルとして保存します。
whatap.conf で SQLMON を有効化します。
エージェントを再起動します。
サイトマップ > メトリクス照会メニューで、sqlmon カテゴリを確認します。

# whatap.conf
sqlmon=1

AES256暗号化の適用

WhaTap DBXエージェントは、収集されたデータを暗号化してサーバーに送信します。データの重要度や設定によって変更できます。基本的にXOR演算とAESアルゴリズムによる暗号化を使用し、平文を128ビット単位に分割して暗号化、復号を行います。ユーザー設定により、256ビットまで拡張できます。

WhaTap DBXエージェントをインストールしたパスで、whatap.confファイルを次のオプションに追加します。

whatap.conf
cypher_level=256

設定を追加してから、エージェントを再起動してください。

エージェント名の設定

自動設定する

エージェント設定(whatap.conf)で名前を設定しないと、エージェント名はIP アドレスとポート番号が結合されて自動指定されます。例えば、IPアドレスが10.11.12.13であり、ポート番号が3000であれば、エージェント名はDBX-12-13-3000に設定されます。

エージェント名を決定する主な変数については、以下を参照してください。

設定	説明
`{type}`	DBX値を使います。
`{ip0}`	IPv4アドレスのうち、1番目の単位を使用します。(例：10.11.12.13のうち10)
`{ip1}`	IPv4アドレスのうち、2番目の単位を使用します。(例：10.11.12.13のうち11)
`{ip2}`	IPv4アドレスのうち、3番目の単位を使用します。(例：10.11.12.13のうち12)
`{ip3}`	IPv4アドレスのうち、4番目の単位を使用します。(例：10.11.12.13のうち13)
`{port}`	データベースサーバのポート

ノート

RDSのようにIPアドレスが数字でなければDBX-{ip0}-{hash}-{port}形式で名前が設定されます。ここで{hash}値は、IPアドレスを4桁の16進数に変換した値です。

手動設定する

エージェント名を直接設定したい場合は、whatap.confファイルでwhatap.nameまたはobject_nameオプションに目的の名前を入力します。ユーザーが入力した名前がエージェント名として設定されます。

whatap.conf
whatap.name=agent-1234
# or
object_name=agent-1234

基本オプション​

データ収集​

ユーザーメトリック収集 (SQLMON)​

設定​

AES256暗号化の適用​

エージェント名の設定​

自動設定する​

手動設定する​