本文へスキップ

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

    cubrid

    注意

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

  • db String

    モニタリングするDB名を設定してください。

  • db_ip String

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

CUBRID専用オプション​

  • db_port Int

    既定値0

    アプリケーション接続情報に使用するブローカーのポート情報です。ブローカー設定ファイル(cubrid_broker.conf)にBROKER_PORT項目に定義された値を入力してください。(CUBRIDの既定値 BROKER_PORT: 33000)

  • cms_port Int

    既定値 8001

    CUBRID Managerが使用するポートです。CUBRID Manager設定ファイル(cm.conf)のcm_port`項目に定義された値を入力してください。モニタリング情報をCUBRID Managerのapiを使用して読み込むために必要です。

  • cms_token_file String

    ユーザーが生成したDBが複数ある場合、WhaTapエージェントをDB数だけインストールして設定する必要があります。この場合、エージェント間でトークンを共有するには、cms_token_fileパスが必要です。_{エージェントインストールパス}/cms_token_に設定してください。

    例) agent2をインストールした場合、agent1のcms_token_fileパスを共有するために次のように設定してください。

    whtap.conf

    cms_token_file=/agent1/cms_token

  • broker String

    既定値 broker1、query_editor

    CUBRIDをインストールすると、デフォルトでbroker1、query_editorでブローカーが実行されます。ユーザーが任意にブローカーの名前を変更または、追加で移動を行った場合は、変更を入力してください。

    ノート

    brokerオプションで設定する名前は、cubrid broker statusコマンドで確認できます。

データ収集​

  • long_run_session_sec Second

    既定値10

    設定した時間より長く実行されているセッションをlong runセッションとして処理します。(単位：秒)

  • tables_hour Int

    既定値5

    テーブル情報を保存するために情報を収集する時間を設定します。デフォルトは5で、午前5時に収集を開始します。

  • tables_min_row Int

    既定値10000

    テーブル情報を収集する場合、設定した値より小さいrow番号のテーブル情報は収集しません。

AES256暗号化の適用​

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

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

whatap.conf
cypher_level=256

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

エージェント名の識別​

Details

エージェント名を設定する WhaTapモニタリングサービスでは、モニタリング対象を包括的な意味でオブジェクトを使用し、エージェントと同じ意味で使用されることがあります。モニタリング対象のオブジェクトを区別するには、名前を区別する必要があります。WhaTapは、オブジェクト名とオブジェクトIDによって対象を区別します。

ノート
  • オブジェクト(エージェント) 名は、プロジェクトごとに一意である必要があります。
  • オブジェクトID＝CRC32（オブジェクト名）です。オブジェクトIDまたは名前が変更されると、以前のデータとリンクされません。

WhaTapはモニタリングは、情報収集対象であるデータベースサーバーを識別するための情報として、データベースサーバーから収集して情報を活用します。基本的な使用情報は、データベースサーバーの種類、IPアドレス、サービスポートなどを組み合わせてデータベースサーバーの固有の識別子として使用します。必要に応じてユーザーが設定した名前を利用するか、パターンを変更して固有の値に変更して利用します。エージェントの名前は必ず固有の値である必要があります。

データベースサーバーから抽出した情報を使用する理由は、データベースサーバーの停止またはネットワークの切断、エージェント問題による収集サーバーとエージェントの通信障害が復旧した場合に再接続したエージェントから送信される情報が既存エージェントから送信された情報との継続性を維持するためです。

  • object_name String

    既定値{type}-{ip2}-{ip3}-{port}

    データベースサーバーを識別するためのエージェント名(ONAME) の構成方法です。ONAMEに基づいてOIDが生成されます。

    設定説明
    {type}whatap.app_nameに設定された値を使用します。
    {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}データベースサーバのポート
    {hostname}ホスト名

  • auto_oname_enabled Boolean

    既定値false

    サーバーに登録するエージェント名(oname)をサーバーから自動受信される機能をアクティブにします。適用する場合は、-Dwhatap.name、および-Dwhatap.onameオプションは無視されます。収集サーバーとの通信により、onameを与えられた後、エージェントの一般的な動作を開始します。

  • auto_oname_prefix String

    既定値agent

    エージェント名をサーバーから自動的に割り当てる場合、エージェント名のprefixや業務名を使用します。prefixにシリアル番号1~)を付与します。

  • auto_oname_reset Int

    既定値0

    サーバーから新しいエージェント名を付与するために修正します。エージェント名を自動付与すると、whatap.onameというシステム環境変数に設定されます。一度定められたシステムの環境変数は、JAVAインスタンスが再起動するまで維持します。リセットしたいときは、auto_oname_reset値を修正してください。現在の設定値と異なる値に変更すると適用されます。