エージェントのインストール
モニタリング対象アプリケーションサーバーからTCP通信にデータを配信します。また、WhaTap収集サーバーにデータを送信するには、同じサーバにエージェントをインストールする必要があります。インストール方式は、パッケージインストールで可能です。
エージェントは基本127.0.0.1:6600TCPサーバーで動作します。Goアプリケーションからデータを受信し、WhaTap収集サーバーにOutbound 6600ポートに送信します。
-
WhaTapリポジトリ(Repository)をインストールします。
-
whatap-agent Linuxパッケージ(yum, apt-get)をインストールします。
-
whatap-agentサービスを実行してください。
WhaTapモニタリングサービスを使用するには、会員登録後、プロジェクトを作成し、ターゲットサーバーにエージェントをインストールする必要があります。
プロジェクト作成
エージェントをインストールする前にプロジェクトを作成してください。
-
WhaTapモニタリングサービスに移動し、ログインします。
-
プロジェクトを作成するには、画面左サイドメニューからプロジェクト全体 > + Projectボタンを選択してください。
-
商品選択 画面でプロジェクトにインストールする製品を選択してください。
-
プロジェクト名、データサーバーリージョン、プロジェクトタイムゾーンなどの項目を設定してください。
-
すべての設定を完了した後は プロジェクトを作成する ボタンを選択してください。
-
データサーバーリージョンは、リージョン(クラウドサービスを提供するためにインストールしたデータセンターのグループ)を意味します。特定のリージョンを選択すると、そのリージョンに所属するデータセンターにユーザーのデータが保存されます。
-
プロジェクトタイムゾーンは通知とレポートを生成する基準時間です。
-
複数のプロジェクトをグループで管理する場合は、プロジェクトグループからグループを選択するか、グループを追加してください。 グループの詳細については、次の文書を参照してください。
-
組織を選択してプロジェクトを追加する場合は、組織下位のグループを必須に設定する必要があります。
アクセスキーの確認
アクセスキーは、WhaTapサービスを有効にするための固有IDです。
インストール手順セクションでプロジェクトアクセスキーの発行ボタンをクリックします。 アクセスキーを自動的に発行した後、次のステップを進みます。
プロジェクトを作成すると、自動的にエージェントインストールページに移動します。 エージェントインストールページが移動しない場合は、画面左側のメニューから管理 > エージェントインストールを選択してください。
エージェントダウンロード
アクセスキーが発行されたら、次のコマンドを使用してエージェントをダウンロードしてください。
- Red Hat/CentOS
- Debian/Ubuntu
- Amazon Linux
- Alpine Linux
- Alpine Linux Docker
## パッケージリポジトリ登録
$ sudo rpm -Uvh https://repo.whatap.io/centos/5/noarch/whatap-repo-1.0-1.noarch.rpm
## パッケージインストール
$ sudo yum install whatap-agent
## パッケージリポジトリ登録
$ wget https://repo.whatap.io/debian/release.gpg -O -|sudo apt-key add -
$ wget https://repo.whatap.io/debian/whatap-repo_1.0_all.deb
$ sudo dpkg -i whatap-repo_1.0_all.deb
$ sudo apt-get update
## パッケージインストール
$ sudo apt-get install whatap-agent
## パッケージリポジトリ登録
$ sudo rpm --import https://repo.whatap.io/centos/release.gpg
$ echo "[whatap]" | sudo tee /etc/yum.repos.d/whatap.repo > /dev/null
$ echo "name=whatap packages for enterprise linux" | sudo tee -a /etc/yum.repos.d/whatap.repo > /dev/null
$ echo "baseurl=https://repo.whatap.io/centos/latest/\$basearch" | sudo tee -a /etc/yum.repos.d/whatap.repo > /dev/null
$ echo "enabled=1" | sudo tee -a /etc/yum.repos.d/whatap.repo > /dev/null
$ echo "gpgcheck=0" | sudo tee -a /etc/yum.repos.d/whatap.repo > /dev/null
## パッケージインストール
$ sudo yum install whatap-agent
whatap-agent.tar.gzファイルをダウンロードし、「/」ディレクトリを基準に圧縮して解凍します。/usr/whatap/agent パスにモニタリングファイルを作成します。
$ wget https://s3.ap-northeast-2.amazonaws.com/repo.whatap.io/alpine/x86_64/whatap-agent.tar.gz
$ tar -xvzf whatap-agent.tar.gz -C /
whatap-agent.tar.gzファイルをダウンロードし、 /usr/whatap/agent パスに解凍します。
FROM alpine
RUN apk update && apk upgrade
# Install WhaTap Go monitoring agent
RUN wget https://s3.ap-northeast-2.amazonaws.com/repo.whatap.io/alpine/x86_64/whatap-agent.tar.gz
RUN tar -xvzf whatap-agent.tar.gz -C /
エージェント構成ファイル
モニタリング情報を収集するトレーサー、収集した情報をサーバーに転送するエージェント、トレーサーとエージェント をサーバーへ動的に適用するインストールスクリプト ファイルで構成されます。
-
whatap-agent:エージェント、トレーサーからUDPとして転送した情報を収集サーバーに転送するプログラムです。
-
/etc/init.d/whatap-agent:サービスのスクリプトファイルです。
-
whatap_agent:サービスの実行ファイルです。
-
whatap.conf:設定情報および収集サーバーのIP、アクセスキーを入力するファイルです。
-
whatap-boot-
yyyymmdd
.log:エージェントログファイルです。(パス:/usr/whata/agent/log)
エージェント設定
基本設定
次のコマンドを順番に実行して、whatap.confファイルにアクセスキーと収集サーバーIPアドレスなどを設定してください。
-
アプリケーションの開始スクリプトパスにwhatap.confファイルを作成してください。
-
WHATAP_HOME
環境変数を設定しない場合は、アプリケーション起動スクリプトのパスをwhatap.confファイルパスとして認識します。
# スクリプトの実行パスにwhatap.confファイルを作成
$ echo "license={アクセスキー}" >> ./whatap.conf
$ echo "whatap.server.host={収集サーバーのIPアドレス}" >> ./whatap.conf
$ echo "app_name={アプリケーション名}" >> ./whatap.conf
# アプリケーション実行
./app
-
license
:アクセスキーを入力してください。 -
whatap.server.host
:収集サーバーのIPアドレスを入力してください。 -
app_name
:アプリケーション名を入力してください。文字列を使用してユーザー設定することができます。ノートapp_name
はエージェント名を決定するための構成要素です。詳細については、次の文書を参照してください。
WHATAP_HOME
環境変数の設定
whatap.confファイルパスをWHATAP_HOME
環境変数に設定できます。WHATAP_HOME
パスを最初に作成してください。
# WHATAP_HOMEパスを作成した後、whatap.confファイルパスを設定
mkdir ./whatap_home
echo "license={アクセスキ ー}" >> ./whatap_home/whatap.conf
echo "whatap.server.host={収集サーバーのIPアドレス}" >> ./whatap_home/whatap.conf
echo "app_name={アプリケーション名}" >> ./whatap_home/whatap.conf
# アプリケーション実行
WHATAP_HOME=./whatap_home ./app
プロセス別エージェント名の設定
2つ以上のプロセスで実行されるアプリケーションは、1つのwhatap.confファイルを共有しても、ユーザーが設定した変更が反映されない場合があります。 プロセスごとにそれぞれのwhatap.confファイルを設定することをお勧めします。
エージェント名が重複しないように、ユーザーは文字列にエージェント名を追加して区別ができます。app_name
オプションで設定した値は、エージェント名の最前列に追加されます。
同じインスタンスで、同じコマンドで実行されるエージェント名が重複する現象を回避できます。
# WHATAP_HOMEパス を先に作成した後、whatap.confファイルパス設定
mkdir ./whatap_home
echo "license={アクセスキー}" >> ./whatap_home/whatap.conf
echo "whatap.server.host={収集サーバーのIPアドレス}" >> ./whatap_home/whatap.conf
echo "app_name={アプリケーション名-1}" >> ./whatap_home/whatap.conf
# アプリケーション実行
WHATAP_HOME=./whatap_home ./app
# WHATAP_HOMEパスを先に作成した後、whatap.confファイルパス設定
mkdir ./whatap_home1
echo "license={アクセスキー}" >> ./whatap_home1/whatap.conf
echo "whatap.server.host={収集サーバーのIPアドレス}" >> ./whatap_home1/whatap.conf
echo "app_name={アプリケーション名-2}" >> ./whatap_home1/whatap.conf
# アプリケーション実行
WHATAP_HOME=./whatap_home1 ./app