本文へスキップ

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

Virtual Environmentの活性化​

アプリケーションがvirtualenvを使用している場合は、仮想環境を有効にしてください。_bin/activate_ファイルを実行します。

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

アクセスキーを発行してエージェントダウンロドセクションに移動します。次のコードを実行してエージェントをインストールします。

pip install whatap-python
Tips

pipコマンドでインストールできない場合は、pypi WhaTapページからインストールファイルをダウンロードしてください。ダウンロードしたファイルを解凍してインストールを進めてください。

tar xzvf whatap_python-1.x.x.tar.gz \
cd whatap_python-1.X.Y.Z \
python setup.py install

エージェント構成ファイル​

Pythonエージェントファイルは、アプリケーションモニタリングに必要な情報を抽出し、WhaTap収集サーバーに転送するトレーサーとトレーサーがデータを送信できるように支援する要素で構成されています。エージェントファイルの構成については、以下を参照してください。

エージェント設定​

WHATAP_HOMEの基本パス設定​

ログと設定ファイルパスのための$WHATAP_HOMEパスを指定してください。whatapディレクトリを新たに作成することをお勧めします。

$ export WHATAP_HOME=[PATH]

アクセスキーと収集サーバーのIP設定​

アクセスキー及び収集サーバーのIP設定のためにwhatap-setting-configコマンドを実行します。

$ whatap-setting-config \
--host [ COLLECTION_SERVER_IP ] \
--license [ ACCESS_KEY ] \
--app_name [ USER_DEFINED_AGENT_NAME ] \
--app_process_name [ APPLICATION_PROCESS_NAME(uwsgi, gunicorn etc..) ]

設定表示​

$WHATAP_HOMEに指定した経路にwhatap.conf ファイルが作成・設定されます。次のコマンドを実行しなさいwhatap.confファイルが作成されているか確認してください。

$ cat $WHATAP_HOME/whatap.conf
whatap.conf
license=[ACCESS_KEY]
whatap.server.host=[COLLECTION_SERVER_IP]

# application name
app_name=[ USER_DEFINED_AGENT_NAME ]

# middleware process name ex)uwsgi, gunicorn ..
app_process_name=[ APPLICATION_PROCESS_NAME(uwsgi, gunicorn etc..) ]
ノート

権限の問題が発生する場合

  • WhaTap設定のための_$WHATAP_HOME/whatap.conf_ファイルの読み取りおよび書き込み権限

  • WhaTapログのための_$WHATAP_HOME/logs_パスと下位ファイルの読み取りおよび書き込み権限

$WHATAP_HOMEパスに関する権限の問題が発生した場合は、次のコマンドを実行して権限を付与します。

echo `sudo chmod -R 777 $WHATAP_HOME`

アプリケーションサーバーの環境ごとに適用​

アプリケーションサーバーの環境によって、適用する方法が異なる場合があります。ユーザーの環境に合わせた適用方法で進めてください。

Commandの環境では次のようにwhatap-start-agentコマンドを、アプリケーション開始コマンド(Application start command) の前に追加します。

BASH
# $ whatap-start-agent [Application start command]
$ whatap-start-agent python manage.py runserver

アプリケーションサーバーを実行すると、エージェントがモニタリングデータを収集し始めます。

サービス実行の確認​

次のコマンドを実行してWhaTap Pythonサービスが正常に実行されるか確認します。

ps -ef | grep whatap_python

次のステップ​

  • インストールの点検

    プロジェクトの生成とエージェントのインストールまですべて適用した場合は、次の文書で点検事項を確認します。

  • インストール問題の解決

    エージェントをインストールする際に発生する可能性がある問題と、これを解決するための具体的なガイドを提供します。 詳細については、次の文書を参照してください。

  • エージェント設定

    エージェント設定(whatap.conf)ファイルにオプションを適用して、モニタリングのための様々な機能を提供します。 デフォルト設定から、サーバーの接続とデータ転送の設定、複数のアプリケーションサーバーの設定ファイルの管理方法、トランザクションの追跡などが含まれます。 詳細については、次の文書を参照してください。

  • モニタリングの開始

    すべての設定を完了してから、アプリケーションサーバーを再起動します。 エージェントが情報の収集を開始します。 まず、アプリケーションメニューでモニタリングデータが収集されていることを確認します。 アプリケーションについての詳細は、次の文書を参照してください。

最終修正：