本文へスキップ

一般インストール

Linux環境のGoアプリケーションにWhaTapモニタリングエージェントをインストールするには、次の手順を実行してください。

Tips

インストールを開始する前に、次の情報を準備してください。

  • WhaTapプロジェクトアクセスキー([プロジェクトメニュー] > [管理] > [エージェントインストール]で確認)
  • WhaTap収集サーバーIPアドレス

Goライブラリを適用​

モニタリング対象アプリケーションにWhaTap Go Libraryを追加する方法は次のとおりです。自動計測を推奨します。

ライブラリ設定方式

区分設定方式説明備考
自動計測whatap-go-inst使用whatap-go-instツールでコード自動挿入推奨
手動計測go-api直接使用APIを直接コードに追加細かい制御が必要な場合

自動計測 (推奨)​

whatap-go-instツールを使用してソースコードにモニタリングコードを自動的に挿入します。

1. whatap-go-instをインストール​

Go Versionインストール方法
Go 1.21+ (推奨)go installを利用
Go 1.18~1.20バイナリダウンロード
  • Go 1.21+ (推奨)
    go install github.com/whatap/go-api-inst/cmd/whatap-go-inst@latest

  • Go 1.18~1.20

    事前にビルドされたバイナリをダウンロードしてください。

    Linux x86_64:

    wget https://github.com/whatap/go-api-inst/releases/latest/download/whatap-go-inst_linux_amd64.tar.gz
    tar -xvzf whatap-go-inst_linux_amd64.tar.gz
    sudo mv whatap-go-inst /usr/local/bin/

Linux ARM64:

    wget https://github.com/whatap/go-api-inst/releases/latest/download/whatap-go-inst_linux_arm64.tar.gz
    tar -xvzf whatap-go-inst_linux_arm64.tar.gz
    sudo mv whatap-go-inst /usr/local/bin/

2. プロジェクト初期化およびビルド​

次のコマンドはgo.modがあるプロジェクトルートディレクトリで実行してください。

初回インストールの場合

whatap-go-instを初めてインストールする場合は、まずPATH環境変数を設定する必要があります。

# 環境変数を追加 (初回インストール時のみ必要)
export PATH=$PATH:$(go env GOPATH)/bin

# go-apiパッケージダウンロードおよびインストール
go get github.com/whatap/go-api@latest
go mod tidy

# ビルド (モニタリングコードを自動挿入)
whatap-go-inst go build -o myapp .
ノート

詳細な使用方法は、自動計測ガイドを参照してください。

手動計測​

go-apiを直接ダウンロードした後、ソースコードにモニタリングコードを手動で挿入します。

1. go-apiをダウンロード​

go get github.com/whatap/go-api

2. モニタリングコードを追加​

import "github.com/whatap/go-api/trace"

func main(){
    trace.Init(nil)
    defer trace.Shutdown()

    ctx, _ := trace.Start(context.Background(), "Start Tx")
    ...
    trace.End(ctx, err)
}
ノート

詳細なAPI使用方法は、手動計測ガイドを参照してください。

モニタリング環境変数を設定​

モニタリング環境変数はwhatap.confファイルで設定します。

whatap.confは**アプリケーションが実行される作業ディレクトリ(working directory)**に作成する必要があります。

主要設定​

環境変数説明
licenseプロジェクトアクセスキー
whatap.server.hostWhaTap収集サーバーアドレス
app_nameアプリケーション名

実行方式によるwhatap.confの位置​

実行方法Working Directorywhatap.confの位置
./myapp現在のディレクトリ./whatap.conf
/home/user/app/myapp/home/user/app/home/user/app/whatap.conf
絶対パスで実行/ (ルート)WHATAP_HOME設定が必要

設定方法​

基本実行​

echo "license={アクセスキー}" >> ./whatap.conf
echo "whatap.server.host={収集サーバーIPアドレス}" >> ./whatap.conf
echo "app_name={アプリケーション名}" >> ./whatap.conf
./app

WHATAP_HOME環境変数設定​

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つ以上のプロセスで実行されるアプリケーションは、プロセスごとに個別のwhatap.confファイル設定を推奨します。

# アプリケーション1
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 

# アプリケーション2
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
ノート

app_nameは、エージェント名を決定するための構成要素です。詳細については、次のドキュメントを参照してください。

データ中継用エージェントをインストール​

アクセスキーを発行されたら、次のコマンドを使用してエージェントをダウンロードしてください。

SH
## パッケージリポジトリ登録
$ sudo rpm -Uvh https://repo.whatap.io/centos/5/noarch/whatap-repo-1.0-1.noarch.rpm

## パッケージインストール
$ sudo yum install whatap-agent

モニタリングを開始​

アプリケーションサーバーを再起動すると、エージェントが情報収集を開始します。

最終修正：