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
mysql
注意別のオプション値を入力すると、モニティリングのデータ収集が正常に動作しない場合があります。
-
db_ip String
モニタリングするデータベースサーバーのIPアドレスを設定します。
-
db_port String
データベースが通信に使用するポート番号を設定します。
データ収集
-
deadlock_interval Int
既定値
60
deadlock情報を読み込む間隔(単位: 分)を設定します。deadlock情報は、設定した間隔で発生した最後のdeadlock情報のみを読み込みます。
-
long_run_session_sec Second
既定値
10
設定した時間より長く実行されているセッションをlong runセッションとして処理します。(単位:秒)
-
tables_hour Int
既定値
5
テーブル情報を保存するために情報を収集する時間を設定します。デフォルトは
5
で、午前5時に収集を開始します。
-
replication_name String
レプリケーション名を設定すると、同じ
replication_name
を持つDBの間にMaster/Slave関係があるものとみなします。レプリケーションセットを定義するオプションとしてマスターノードとスレーブノードの両方に同じ値の
replication_name
オプションを設定するとインスタンスモニタリングでツリー構造で表示されます。また、このオプション値を基準にFlexボードでレプリケーション状態をモニタリングするウィジェットを提供します。
-
skip_whatap_session Int
既定値
0
1
が設定されている場合、WhaTapから収集するためのqueryが実行するセッションをactive session listに表示しません。(既定値:0)
-
skip_sys_session Int
既定値
1
2
が設定されている場合、sysセッション(root、system user、event_scheduler)はactive sessionで表示されません。1
を設定すると、sysセッションは表示されますが、total runtimeから除外されます。
-
trx_rseg_history_len Boolean
MySQL 5.7 or later
DBX agent v1.6.15 or later
既定値
false
trx_rseg_history_len
指標の収集有無を設定します。true
に設定するとdb_mysql_counter
カテゴリで確認できます。 -
active_transactions Boolean
MySQL 5.5 or later
DBX agent v1.6.15 or later
既定値
false
active_transactions
指標の収集有無を設定します。true
に設定するとdb_mysql_counter
カテゴリで確認できます。 -
collect_variables_metric Boolean
DBX agent v1.6.15 or later
既定値
false
DBパラメータをリアルタイムで収集できます。
variables_metric
オプションに設定したパラメータを収集します。 -
variables_metric String
DBX agent v1.6.15 or later
uptime
、version
、read_only
のようにDBパラメータ名を設定してください。2つ以上の値を設定するには、コンマ(,)を区切り文字として利用してください。collect_variables_metric
オプションをtrue
に設定してからDBパラメータ名を設定すると、db_mysql_variables
カテゴリで確認できます。whatap.confcollect_variables_metric=true
variables_metric=uptime,version
AWS RDS CloudWatch適用
AWS CloudWatchを使用するエージェント設定に関する説明です。 収集を開始するとメトリクスに含まれ、分析 > メトリクスチャートメニューからdb_mysql_counter
カテゴリで他の指標と一緒に確認することができます。
-
aws_region String
AWSリージョンを設定します。
-
aws_arn String
AWS認証のために適切な権限を持つIAM ROLEのARNを使用することができます。
必須権限
ROLEには、次のアクセス権限(Policy)が必要です。
権限 権限内容 rds:DescribeDBInstances インスタンスクラスの情報収集 rds:DescribeDBClusters autoscale使用時クラスターから情報収集 rds:DescribeDBLogFiles CloudWatchログ収集 rds:DownloadDBLogFilePortion CloudWatchログ収集 ec2:DescribeInstanceTypes インスタンスクラスに対応するcpu数を収集 elasticache:DescribeCacheClusters elasticacheを利用する場合時、インスタンスクラスの情報を収集 cloudwatch:ListMetrics CloudWatch指標一覧を収集 cloudwatch:GetMetricStatistics CloudWatch指標から値を収集 logs:DescribeLogStreams CloudWatchログ収集(掲示されたログ機能を使用する場合) logs:GetLogEvents CloudWatchログ収集(掲示されたログ機能を使用する場合) -
cloud_watch String
CloudWatchモニタリングの使用有無を設定します。 設定値は
on
またはoff
です。 -
cloud_watch_instance String
CloudWatchインスタンス名を設定します。
-
cloud_watch_interval Second
CloudWatchでモニタリング値を取得する間隔を設定します。(単位:秒)
-
cloud_watch_metrics String
CloudWatchに読み込みするモニタリング指標名を設定します。次のように設定できます。
cloud_watch_metrics=CPUUtilization,FreeableMemory,FreeStorageSpace,NetworkTransmitThroughput,NetworkReceiveThroughput
RDS CloudWatch収集の設定例
次のような基本設定を作成することにより、RDS CloudWatchをモニタリングし、データを収集します。
cloud_watch=on
aws_region=ap-northeast-2
# AWS IAMで役割(Role)を作成し、ロールARN(Role ARN)値をコピーして貼り付けてください。
aws_arn=arn:aws:iam::999999999999:role/UpdateApp
cloud_watch_metrics=CPUUtilization,FreeableMemory,FreeStorageSpace,NetworkTransmitThroughput,NetworkReceiveThroughput
#インスタンス名の例
cloud_watch_instance=pg-rds
AES256暗号化の適用
WhaTap DBXエージェントは、収集されたデータを暗号化してサーバーに送信します。データの重要度や設定によって変更できます。基本的にXOR演算とAESアルゴリズムによる暗号化を使用し、平文を128ビット単位に分割して暗号化、復号を行います。ユーザー設定により、256ビットまで拡張できます。
WhaTap DBXエージェントをインストールしたパスで、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
値を修正してください。現在の設定値と異なる値に変更すると適用されます。