本文へスキップ

手動インストール

WhaTapデータベースモニタリングは、DBXエージェントがSingleStoreクラスターに接続して指標を収集します。エージェントはアグリゲーターノード1か所にのみインストールすればよく、リーフノードはMV_NODESで自動検出されてクラスター全体が一緒に収集されます。すべてのノードにエージェントをインストールする必要はありません。このドキュメントは、エージェントを手動でインストールし、whatap.confファイルを設定する基本的な方法を案内します。SingleStore 9.0以上の環境を対象とします。

モニタリングアカウントの作成​

DBXエージェントが使用するモニタリング専用アカウントを作成し、次の権限を付与してください。

grant select, process, cluster on *.* to '{モニタリング_アカウント}'@'%';
PrivilegeDescription
selectモニタリングに必要なシステムビュー・テーブルの照会
process実行中のセッション・クエリ情報の照会
clusterクラスターノードの構成と分散状態の照会

MySQLやMariaDBの案内に含まれる一部の専用権限は、SingleStoreでは必要ありません。

SingleStoreのインストールはManual（手動）方式を使用します。

DBXエージェントダウンロード​

DBXエージェントファイルをダウンロードします。 次の2つの方法を利用します。

  • wgetコマンドを使用してダウンロードできます。

    BASH
    wget -O whatap.agent.database.tar.gz "https://service.whatap.io/download/dbx_agent?type=singlestore&format=tar.gz"

  • コマンドでダウンロードできない場合は、WhaTapモニタリングサービス画面でダウンロードボタンを選択します。

DBXエージェントファイルをダウンロードして圧縮を解凍してください。

BASH
tar -zxvf whatap.agent.database.tar.gz
ノート

セキュリティ設定によりTAR形式のファイルをダウンロードできないユーザーのためにZIP形式のファイルも一緒に提供します。 インストール画面で.zip ダウンロードボタンを選択します。

whatap.confの基本設定​

エージェントをインストールしたディレクトリのwhatap.confファイルに、次の項目を設定してください。

whatap.conf
license={AccessKey}
whatap.server.host={WhaTap_Server_アドレス}
dbms=singlestore
db_ip={DB_Server_IP}
db_port={DB_Server_Port}
OptionDescription
licenseプロジェクトのAccess Key
whatap.server.hostデータを送信するWhaTap Serverのアドレス
dbmssinglestoreに固定
db_ip接続するSingleStoreアグリゲーターノードのIP
db_port接続ポート

dbmsは必ずsinglestoreに設定してください。MySQLと同じようにmysqlのままにすると、SingleStore専用画面が表示されません。

設定オプションの詳しい説明はDBXエージェント設定のドキュメントを参照してください。

ファイアウォール設定​

DBサーバーは、DBXエージェントがDBポートにアクセスできるようにInbound接続を許可し、DBXエージェントはWhaTap Serverへデータを送信できるように6600ポートのOutboundを許可する必要があります。収集サーバーのアドレス一覧はサポート環境ドキュメントを参照してください。

TypeDirectionPort
DBXエージェント → DBサーバーInboundDB接続ポート
DBXエージェント → WhaTap ServerOutbound6600

モニタリングの開始​

設定を終えた後にエージェントを実行すると、エージェントが指標の収集を開始します。

最終修正：