本文へスキップ

パッケージマネージャーインストール

パッケージマネージャーを利用したWhaTapデータベースモニタリングエージェントのインストール方法をご案内します。

Tips

インストール方法の選択

  • aptパッケージマネージャーを使用するDebian/Ubuntu系システムの場合は、このドキュメントを参照してください。
  • Docker環境では、Dockerインストールを参照してください。
  • その他の環境では、手動インストールを参照してください。
ノート

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

MySQL、PostgreSQL、SQL Server

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

プロジェクト作成​

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

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

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

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

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

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

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

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

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

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

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

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

ノート

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

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

構成図の確認​

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

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

アカウントの作成​

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

ノート

  • 必要な権限を持つアカウントがすでにある場合は、このステップをスキップして次のステップに進んでください。

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

  • サンプルコードのDB_Passwordには、ユーザーパスワードを入力してください。

機能と使用環境に応じて追加権限を付与してください。

  • PostgreSQL 10バージョン以降

    SQL
    create user DB_User with password 'DB Password'; 
    grant pg_monitor to DB_User;

  • PostgreSQL 10バージョン未満

    SQL
    create user DB_User with password 'DB Password';
    alter user DB_User with superuser;

  • Kill sessionを使用する場合 (バージョン10以上)

    データベースモニタリングでは、進行中のセッションを終了できるKill Session機能を提供します。この機能を使用するには、次のように権限を設定してください。

    SQL
    grant pg_signal_backend to DB_User;

  • テーブルサイズを収集する場合 (統計/レポート > DBサイズ > テーブルサイズ(トップ50))

    SQL
    grant usage on schema {schema_name} to DB_User;
    ノート

    個別のDBごとにコマンドを実行する必要があります。

  • オブジェクト情報を照会する場合(分析 > Topオブジェクト)

    SQL
    grant select on all tables in schema {schema_name} to DB_User;
権限による対応機能を確認する

基本権限外の権限は、ユーザーの環境によって付与する必要はありません。ただし、一部の機能が動作しないことがあります。

権限commandメニューと機能詳細履歴
基本権限grant pg_monitor to whatap;インスタンスモニタリング / マルチインスタンス / SQL統計grant pg_read_all_stats,pg_read_all_settings to DB_User;と同一
詳細権限grant usage on schema {schema_name} to whatap;DBサイズ / テーブルサイズ(トップ50)当該DBのすべてのスキーマに対して権限が必要
grant select on all tables in schema {schema_name} to whatap;テーブルレイアウトを照会-
grant pg_read_all_settings to whatap;パラメータ照会特定のパラメータ値が見えないことがある
セッション中止grant pg_signal_backend to whatap;アクティブセッション > セッション中止PostgreSQL 9.6バージョン以下はsuperuser権限が必要

アクセスキーの確認​

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

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

ノート

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

エージェントのインストール​

WhaTapリポジトリの追加​

次のコマンドを実行して、WhaTap公式リポジトリをシステムに追加します。

curl -s https://repo.whatap.io/debian/release.gpg | gpg --dearmor | sudo tee /etc/apt/trusted.gpg.d/whatap-release.gpg > /dev/null
echo "deb [signed-by=/etc/apt/trusted.gpg.d/whatap-release.gpg] https://repo.whatap.io/debian unstable/" | sudo tee /etc/apt/sources.list.d/whatap.list
sudo apt-get update

パッケージのインストール​

次のコマンドでWhaTapデータベースモニタリングエージェントをインストールします。

sudo apt-get install whatap-db

エージェントの設定と起動​

設定ファイルを作成し、エージェントを起動します。

sudo bash -c 'cat > /usr/whatap/db/whatap.conf <<EOF
license=ライセンスキー
whatap.server.host=13.124.11.223/13.209.172.35
dbms=mysql
db_ip=127.0.0.1
db_port=3306
EOF'
cd /usr/whatap/db && sudo /usr/whatap/db/uid.sh whatap whatap && cd -
sudo service whatap-db restart
ノート
  • whatap.confファイルに必要なデータベースオプションを追加できます。
  • uid.shスクリプトのパラメータ値(データベースアカウントIDおよびパスワード)を実際の環境に合わせて修正してください。

エージェントの管理​

エージェントのアップデート​

エージェントを最新バージョンにアップデートするには、次のコマンドを実行します。

sudo apt-get update
sudo apt-get install whatap-db
sudo service whatap-db restart

エージェントの停止とパッケージの削除​

WhaTapデータベースモニタリングエージェントを削除するには、次のコマンドを実行します。

sudo service whatap-db stop
sudo apt-get remove whatap-db

エージェントログの確認​

エージェントログを確認するには、次のコマンドを使用します。

sudo service whatap-db log
最終修正：