エージェントのインストール
WhaTapモニタリングサービスを使用するには、会員登録後にプロジェクトを作成し、対象サーバーにエージェントをインストールする必要があります。会員登録に関する詳細については、次の文書を参照してください。
次の動画ガイドを参照してください。
プロジェクト作 成
エージェントをインストールする前にプロジェクトを作成してください。
-
WhaTapモニタリングサービスに移動し、ログインします。
-
プロジェクトを作成するには、画面左サイドメニューからプロジェクト全体 > + Projectボタンを選択してください。
-
商品選択 画面でプロジェクトにインストールする製品を選択してください。
-
プロジェクト名, データサーバーリージョン, プロジェクトタイムゾーン項目を順番に設定してください。
-
通知言語の設定で、警告通知メッセージの言語を選択してください。
-
すべての設定を完了した後は プロジェクトを作成する ボタンを選択してください。
-
データサーバーリージョンは、リージョン(クラウドサービスを提供するためにインストールしたデータセンターのグループ)を意味します。特定のリージョンを選択すると、そのリージョンに所属するデータセンターにユーザーのデータが保存されます。
-
プロジェクトタイムゾーンは通知とレポートを生成する基準時間です。
-
複数のプロジェクトをグループで管理する場合は、プロジェクトグループからグループを選択するか、グループを追加してください。 グループの詳細については、次の文書を参照してください。
-
組織を選択してプロジェクトを追加する場合は、組織下位のグループを必須に設定する必要があります。
アクセスキーの確認
アクセスキーは、WhaTapサービスを有効にするための固有IDです。
インストール手順セクションでプロジェクトアクセスキーの発行ボタンをクリックします。 アクセスキーを自動的に発行した後、次のス テップを進みます。
プロジェクトを作成すると、自動的にエージェントインストールページに移動します。 エージェントインストールページが移動しない場合は、画面左側のメニューから管理 > エージェントインストールを選択してください。
Virtual Environmentの活性化
アプリケーションがvirtualenvを使用している場合は、仮想環境を有効にしてください。_bin/activate_ファイルを実行します。
エー ジェントダウンロード
アクセスキーを発給してエージェントダウンロードセクションに移動してください。 次のコードを実行してエージェントをインストールしてください。
pip install whatap-python
pipコマンドでインストールできない場合は、pypi WhaTapページからインストールファイルをダウンロードしてください。ダウンロードしたファイルを解凍してインストールを進めてください。
Docker
-
Dockerコンテナでサービスされるアプリケーションの場合、次の内容を_DockerFile_に追加してください。
-
Pythonエージェントをインストールしてください。
DockerfileENV WHATAP_HOME /whatap
RUN mkdir -p /whatap
RUN pip install whatap-python
// requirements.txtを使用する場合は、そのファイルにwhatap-pythonを追加してください。 -
アクセスキーおよび収集サーバーIP設定を登録してください。
DockerfileRUN touch /whatap/whatap.conf
RUN echo "license=[発行されたアクセスキー]" > /whatap/whatap.conf
RUN echo "whatap.server.host=[収集サーバIP]" >> /whatap/whatap.conf
RUN echo "app_name=[エージェント名]" >> /whatap/whatap.conf
RUN echo "app_process_name=[アプリケーションプロセス名の例)uwsgi, gunicorn.. ]" >> /whatap/whatap.conf
-
-
既存の実行コマンド
python manage.py runserver
の前に'whatap-start-agent'を追加してください。Dockerfile#ENTRYPOINT python manage.py runserver
ENTRYPOINT whatap-start-agent python manage.py runserver
エージェントファイル構成の詳細については、Pythonファイル構成を参考にしてください。
Details
Pythonエージェント構成ファイル
Pythonエージェントファイルは、アプリケーションモニタリングに必要な情報を抽出し、タブ収集サーバーに伝達するトレーサーと、トレーサーがデータを送信できるよう支援する要素で構成されています。-
whatap.conf
エージェント設定の基本的な必須ファイルです。エージェントに関連するオプションはすべてwhatap.confファイルで設定できます。
-
paramkey.txt
追跡したトランザクションのトレース情報として収集したHTTPとSQLデータのパラメータ情報を確認するために使用します。
セキュリティキーをファイルに保存した後、実際に収集されたデータをブラウザで確認したい場合は、ファイルに保存されたセキュリティキーを入力して表示できます。