本文へスキップ

Dockerインストール

Dockerコンテナを利用したWhaTapデータベースモニタリングエージェントのインストール方法をご案内します。

Tips

インストール方法の選択

ノート

サポートされているデータベース

MySQL、PostgreSQL、SQL Server

WhaTapモニタリングサービスを利用するには、サインアップ後にプロジェクトを作成し、モニタリング対象のサーバーにエージェントをインストールする必要があります。サインアップの詳細については、次のドキュメントを参照してください。

プロジェクト作成​

エージェントをインストールする前にプロジェクトを作成してください。

  1. WhaTapモニタリングサービスにログインしてください。

  2. 左側のサイドメニューで プロジェクト全体 > + Project ボタンをクリックします。

  3. 商品選択 画面でインストールする製品を選択します。

  4. 以下の項目を入力または選択します。

    • プロジェクト名：プロジェクト名を入力します。

    • データサーバーリージョン：データサーバーの設置されているリージョンを選択します。リージョンとは、クラウドサービスを提供するデータセンターの集合体です。選択したリージョンにユーザーデータが保存されます。

    • プロジェクトタイムゾーン：アラートおよびレポート生成時の基準となる時刻を設定します。

    • 通知言語の設定：アラート通知メッセージの言語を設定します。（韓国語、英語に対応）

    • プロジェクトグループ：複数のプロジェクトをグループとしてまとめて管理できます。所属するグループがある場合は選択してください。

    • プロジェクト説明：プロジェクトに関する補足説明や詳細情報を入力します。

  5. すべての設定が完了したら、プロジェクトを作成する ボタンをクリックします。

ノート

組織を選択してプロジェクトを追加する場合は、組織下位のグループを必須に設定する必要があります。

グループに関する詳細は、次のドキュメントを参照してください。

構成図の確認​

DBXエージェントは、別のサーバーにインストールするか、DBサーバーにインストールできます。 インストールする方法を選択し、構成とファイアウォールを確認します。

別途サーバーにインストールDBサーバーに直接インストール

アカウント生成​

データベースモニタリングをするために必要な権限を持つアカウントを作成します。root(admin) アカウントでログインしてアカウントを作成してください。

create login DB_User with password='DB Password';
create user DB_User for login DB_User;
grant connect any database to DB_User;
grant view server state to DB_User;
grant view any definition to DB_User;

  • Kill session使用時の追加権限

    grant alter any connection to DB_User;

  • Azure SQL Database環境でKill session使用時の追加権限

    grant kill database connection to DB_User;

  • ジョブ遂行内訳とバックアップ/復旧履歴メニュー機能を利用する際に必要な権限

    msdbデータベースにアクセスできるように権限を付与してください。

    USE msdb;
    CREATE USER DB_User FOR LOGIN DB_User;
    GRANT SELECT to DB_User;

  • オブジェクト情報照会時の必要権限

    2014バージョン以下の場合は、モニタリング対象DBごとに接続して権限を付与してください。

    grant view any definition to DB_User;

  • プラン照会時の必要権限

    各DBごとに接続して実行してください。

    grant showplan to DB_User;
ノート

  • 権限を持つアカウントがある場合は、このステップを省略して次のステップへ進みます。

  • サンプルコードのDB_User は、DBのユーザーアカウント名です。ユーザーが利用するユーザーアカウント名に変更してください。

  • コード例のDB_Passwordには、ユーザーパスワードを入力します。

アクセスキーの確認​

アクセスキーは、WhaTapサービスを有効にするための固有IDです。

インストール手順セクションでプロジェクトアクセスキーの発行ボタンをクリックします。 アクセスキーを自動的に発行した後、次のステップを進みます。

ノート

プロジェクトを作成すると、自動的にエージェントインストールページに移動します。 エージェントインストールページが移動しない場合は、画面左側のメニューから管理 > エージェントインストールを選択します。

エージェントの実行​

次のコマンドを実行して、WhaTapデータベースモニタリングエージェントをDockerコンテナとして起動します。

docker run -d --name whatap-db-agent \
-e WHATAP_CONF="
license=x6051ro88nrc9-x4hmr76jvvlfnq-z52cnv1dfa8n5c 
whatap.server.host=13.124.11.223/13.209.172.35
dbms=mysql
db_ip=10.0.0.1
db_port=3306 
connect_option=?useSSL=true&verifyServerCertificate=false&serverTimezone=SERVER_TIMEZONE" \
-e DB_USERNAME=mydbuser \
-e DB_PASSWORD=mypassword \
whatap/db-agent:latest

設定項目​

必須設定​

  • license: プロジェクトアクセスキー
  • whatap.server.host: WhaTap収集サーバーIP (13.124.11.223/13.209.172.35)
  • dbms: データベースタイプ (mysql, postgresql, mssql)
  • db_ip: データベースサーバーIPアドレス
  • db_port: データベースサーバーポート番号
  • DB_USERNAME: データベースアカウントID
  • DB_PASSWORD: データベースアカウントパスワード

選択設定​

  • connect_option: データベース接続オプション
    • useSSL=true&verifyServerCertificate=false: SSLを使用してデータベースに接続する場合
    • serverTimezone=SERVER_TIMEZONE: JDBCドライバー接続時にサーバータイムゾーン設定が必要な場合
ノート

上記コマンドの設定値を実際の環境に合わせて修正してください。

エージェント動作確認​

次のコマンドでエージェントが正常に動作しているか確認します。

docker logs -f whatap-db-agent

エージェントの削除​

次のコマンドを実行して、WhaTapデータベースモニタリングエージェントコンテナを停止し、削除します。

docker stop whatap-db-agent && docker rm whatap-db-agent
最終修正：