本文へスキップ

XOSエージェント設定

データベースサーバーのリソースをさらにモニタリングする場合は、データベースサーバーに別のXOSエージェントを実行してデータを収集できます。

ノート

  • x86アーキテクチャで動作するOS環境にのみ適用されます。

  • XOSエージェントのインストールについての詳細は、次の文書を参照してください。

whatap.confファイルの設定​

XOSエージェントを実行する前に、whatap.confファイルで、以下のオプションを設定します。

  • xos Int

    既定値0

    XOSエージェントを使用するかどうかを設定します。0に設定するとXOSからのデータは収集されません。1に設定するとすべてのXOSからのデータを収集します。IPアドレスを設定する場合、そのIPアドレスが一致するXOSからのデータのみ収集します。

  • xos_port String

    既定値3002

    XOSエージェントと通信するポートを設定します。XOSエージェントはUDPで通信します。ファイアウォールでUDPポートがブロックされている場合は、該当ポートを開放してください。

  • xos_cpu_iowait Int

    既定値1

    XOSエージェントから収集したCPU使用率にiowaitを追加できます。1に設定するとiowaitが追加され、0に設定するとiowaitは追加されません。

  • xos_mem_buffcache Int

    既定値0

    XOSエージェントから収集したメモリ使用率にbuffcacheを追加できます。1に設定するとbuffcacheが追加され、0に設定するとbuffcacheは追加されません。

xos.confファイルの設定​

xosディレクトリをデータベースサーバーにコピーし、xos.confファイルにエージェントサーバー情報を入力して追加オプションを設定してください。

  • dbx_ip String

    DBXエージェントをインストールしたサーバーのIPアドレスを入力します。

  • dbx_port String

    既定値3002

    DBXエージェントと通信するポートを設定します。

    DBXエージェントは、UDPで通信します。ファイアウォールでUDPポートがブロックされている場合は、該当ポートを開放してください。

  • cpu_limit Int

    既定値0

    limitの設定値より大きい値を持つプロセス情報を収集します。1/100%単位で1.23%の場合、123として設定します。

  • mem_limit Int

    既定値10240

    limitの設定値より大きい値を持つプロセス情報を収集します。単位は「KB」で既定値である10240は、10MBになります。(1024 KB = 1 MB)

  • disk_usage_interval Second

    既定値 60

    インスタンス別のディスク使用率と使用可能サイズ、全体サイズ情報を表示します。値が'0'の場合、ディスク使用率は収集しません。

  • port_check String

    接続状態をチェックするサーバーとポートを指定します。IP:Portの形式で設定し、コンマ(,)で区切って複数登録が可能です。接続ができないサーバーとポートの一覧は、db_port_checkカテゴリに保存されます。

    xos.conf
    port_check=192.168.122.113:3333,192.168.122.113:3334

    接続ができなかったサーバーとポートの一覧を確認する場合、分析 > メトリクス照会メニューでdb_port_checkカテゴリを選択します。

    port_check

  • process_check String

    プロセスの実行状態をモニタリングできます。オプション値でプロセス名を入力します。コンマ(,)を区切り文字として使用し、複数登録することができます。

    xos.conf
    process_check=pmon,smon,tnslsnr,melong,haha

    指定された文字列を含むプロセス名が検知されない場合、db_process_checkカテゴリにその文字列の一覧を保存します。例えば、melong、hahaの2つのプロセスがない場合、分析 > メトリクス照会メニューでdb_process_checkカテゴリを選択した後、確認できます。

    process_check

    ノート

    process_checkオプションを使用して、データベースで実行されているプロセスが終了した場合はアラート通知を送信できます。詳細は次の文書を参照してください。

  • process_check_interval Second

    既定値 6

    process_checkオプションに設定されたプロセスの実行状況を確認する間隔を設定します。(単位：秒)

  • iplist_interval Second

    既定値0(off)

    DBサーバーのIP一覧を収集する間隔を設定します。(単位：秒、3以上で設定)

    ノート

    whatap.confのファイルにxos_dbip=trueオプションを設定するとdb_ip_listのカテゴリに転送します。分析 > メトリクス照会メニューでdb_ip_listカテゴリを選択した後、確認することができます。

  • file String

    ログメニュー(ログTail、ログトレンド、ログ検索、ログ設定)を使用するには、fileオプションにモニタリングするログファイル名のフルパスを入力します。

    次の例を参照してください。

    xos.conf
    # example
    file=C:/Program Files/Microsoft SQL Server/MSSQL16.MSSQLSERVER/MSSQL/Log/ERRORLOG
    Tips

    モニタリングするログファイルを追加するにはfile、file1、file2といった方法でオプションを追加します。

    xos.conf
    file={log_file_path1}
    file1={log_file_path2}
    file2={log_file_path3}
    file3={log_file_path4}

ユーザーメトリクス収集 (SHMON)​

SHMONはユーザー定義のシェルスクリプトの実行結果を定期的に収集し、メトリクスとして保存します。

  • shmon Int

    既定値: 1

    対応バージョン: dbx 2.55.01以降 & xos 1.2.0f以降

設定​

  1. エージェントのインストールパスにshmonディレクトリを作成します。
  2. 収集するスクリプトを.shファイルとして保存します。
  3. xos.confでSHMONを有効にします。
  4. エージェントを再起動します。
  5. アイコン サイトマップ > メトリクス照会 メニューで、shmon カテゴリを確認します。
# xos.conf
shmon=1
ノート
  • fileオプションは、DBXエージェントの2.2.0バージョン以降に対応しています。

  • ログメニューの詳細は次の文書を参照してください。

XOSエージェントの実行​

データベースサーバーで次のバッチファイルを実行してください。

start.bat

画面に表示される実行ログにエラーがないことを確認し、実行を終了した後、次の手順に従ってサービスに登録します。

  • サービスを登録

    xosフォルダにある_install_WindowsService.bat_ファイルを次のように実行してサービスに登録してください。もしcreateオプションの次に名前を入力しないとWhatapXOSAgent名前でサービスに基本登録されます。

    install_WindowsService.bat create WhatapXOSAgent

  • サービスを削除

    install_WindowsService.bat delete WhatapXOSAgent
最終修正：