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

WhaTapモニタリングサービスを使用するには、会員登録後にプロジェクトを作成し、対象サーバーにエージェントをインストールする必要があります。会員登録に関する詳細については、次の文書を参照してください。

次の動画ガイドを参照してください。

プロジェクト作成

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

WhaTapモニタリングサービスに移動し、ログインします。
プロジェクトを作成するには、左のサイドメニューからプロジェクト全体 > + Projectボタンを選択します。
商品選択画面でプロジェクトにインストールする製品を選択してください。
プロジェクト名、データサーバーリージョン、プロジェクトタイムゾーン項目を順番に設定します。
通知言語の設定で、警告通知メッセージの言語を選択します。
すべての設定を完了した後はプロジェクトを作成するボタンを選択します。

ノート

データサーバーリージョンは、リージョン(クラウドサービスを提供するためにインストールしたデータセンターのグループ)を意味します。特定のリージョンを選択すると、そのリージョンに所属するデータセンターにユーザーのデータが保存されます。
プロジェクトタイムゾーンは通知とレポートを生成する基準時間です。
複数のプロジェクトをグループで管理する場合は、プロジェクトグループからグループを選択するか、グループを追加してください。グループの詳細については、次の文書を参照してください。
組織を選択してプロジェクトを追加する場合は、組織下位のグループを必須に設定する必要があります。

アクセスキーの確認

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

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

ノート

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

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

アクセスキーが発行されると、エージェントダウンロドセクションでダウンロードボタンがアクティブになります。

ダウンロードボタンを選択してから、WhaTapエージェントファイルをダウンロードしてください。
Tips
次のコマンドを使用して、サーバーから直接にダウンロードすることもできます。
wget https://api.whatap.io/agent/whatap.agent.java.tar.gz
モニタリング対象サーバーに接続してください。
目的のモニタリング対象サーバーのパスにエージェントファイルを圧縮して解凍してください。圧縮を解凍したパスは$WHATAP_HOMEになります。
```
tar -zxvf whatap.agent.java.tar.gz
```

エージェントのインストールファイルを構成

エージェントファイルは、アプリケーションモニタリングに必要な情報を抽出し、WhaTap収集サーバーに送信するトレーサーとトレーサーがデータを送信するのに役立つ要素で構成されています。

whatap.confファイルを設定する

基本情報を入力する

圧縮を解いた$WHATAP_HOMEパスに移動してください。_$WHATAP_HOME/whatap.conf_ファイルにアクセスキーとデータ収集サーバーのIPアドレスを入力してください。WhaTapモニタリングサービス画面に移動しインストールの案内セクションのエージェントダウンロド項目からアクセスキー、収集サーバIPアドレス値をコピーして貼り付けてください。

license={アクセスキー}
whatap.server.host={収集サーバーIP}

ノート

whantap.confファイルの詳細については、次の文書を参照してください。

セキュリティキーの設定

SQL変数、HTTPクエリを検索、Thread停止機能を使用する場合は、セキュリティキーを設定してください。

Javaエージェント2.2.2バージョン以降

$WHATAP_HOMEパスにsecurity.confファイルを作成した後、次のように 6桁の英数字のパスワードを入力してください。
security.conf
```
paramkey=ABCDEF # SQL変数およびHTTPクエリの検索
threadkill=ABCDEF # Thread停止機能
```
Javaエージェント2.2.2バージョン未満

$WHATAP_HOMEパスにparamkey.txtファイルを作成した後、次のように 6桁の英数字のパスワードを入力してください。
paramkey.txt
```
ABCDEF # SQL変数およびHTTPクエリの検索、スレッド停止機能
```

Tips

Javaエージェント 2.2.2 のバージョン未満から2.2.2バージョンにアップデートする場合、既存のparamkey.txtファイルの設定値は、security.confファイルに自動的に適用されます。例えば、paramkey.txtの設定値がFEDCBAで、バージョン2.2.2にアップデートすると、security.confファイルが次のように適用されます。

paramkey=FEDCBA
threadkill=FEDCBA

paramkey.txtファイルが存在しない場合、security.confファイルのキー値は、WHATAPというキー値で自動的に生成されます。

ノート

SQLパラメータ情報の記録に関するエージェント設定は、次の文書を参照にしてください。
HTTPパラメータ情報の記録に関するエージェント設定は、次の文書を参照にしてください。

JVMオプション追加

使用するアプリケーションサーバー環境に応じて、以下の設定を行います。エージェントをインストールして適用する前に動作環境を確認してください。

Tomcat

WhaTapモニタリングソリューションをTomcatアプリケーションに統合するためのJVM(Java Virtual Machine)オプションの追加方法についての詳細な案内を提供します。ユーザーは本文書を通じて、Javaエージェントのインストール後、Tomcatアプリケーションの性能および可用性モニタリングのために必要なJVM設定を適用する方法を段階別に確認できます。エージェントのインストール過程の中で必須JVMオプションの構成とTomcatとの円滑な統合のための最適な設定方法、ヒストグラムの照会方法が含まれています。

JBoss

WhaTapモニタリングソリューションをJBossアプリケーションに統合するためのJVM(Java Virtual Machine) オプションの追加方法についての詳細な案内を提供します。本文書は、Javaエージェントのインストール後、JBossアプリケーションの性能および可用性をモニタリングするために必要なJVM設定を適用する手順を説明します。エージェントをインストールする際に必要なJVMオプションの構成とJBossとの統合に最適な設定方法、ヒープヒストグラムの照会方法が含まれています。

JEUS

WhaTapモニタリングソリューションをJEUSアプリケーションに統合するためのJVM(Java Virtual Machine) オプションの追加方法についての詳細な案内を提供します。本文書は、Javaエージェントのインストール後、JEUSアプリケーションの性能および可用性をモニタリングするために必要なJVM設定を適用する手順を説明します。エージェントをインストールする際に必要なJVMオプションの構成とJEUSとの統合に最適な設定方法、ヒープヒストグラムの照会方法が含まれています。

WebLogic

WhaTapモニタリングソリューションをWebLogicアプリケーションに統合するためのJVM(Java Virtual Machine) オプションの追加方法についての詳細な案内を提供します。ユーザーは本文書を通じて、Javaエージェントのインストール後、WebLogicアプリケーションの性能および可用性モニタリングのために必要なJVM設定を適用する方法を段階別に確認できます。エージェントのインストール過程の中で必須JVMオプションの構成とWebLogicとの円滑な統合のための最適な設定方法、ヒストグラムの照会方法が含まれています。

WebSphere

WhaTapモニタリングソリューションをWebSphereアプリケーションに統合するためのJVM(Java Virtual Machine) オプションの追加方法についての詳細な案内を提供します。本文書は、Javaエージェントのインストール後、WebSphereアプリケーションの性能および可用性をモニタリングするために必要なJVM設定を適用する手順を説明します。エージェントをインストールする際に必要なJVMオプションの構成とWebSphereとの統合に最適な設定方法、ヒープヒストグラムの照会方法が含まれています。

Resin

WhaTapモニタリングソリューションをResinアプリケーションに統合するためのJVM(Java Virtual Machine) オプションの追加方法についての詳細な案内を提供します。本文書は、Javaエージェントのインストール後、Resinアプリケーションの性能および可用性をモニタリングするために必要なJVM設定を適用する手順を説明します。エージェントをインストールする際に必要なJVMオプションの構成とResinとの統合に最適な設定方法、ヒープヒストグラムの照会方法が含まれています。

Liberty

WhaTapモニタリングソリューションをLibertyアプリケーションに統合するためのJVM(Java Virtual Machine) オプションの追加方法についての詳細な案内を提供します。本文書は、Javaエージェントのインストール後、Libertyアプリケーションの性能および可用性をモニタリングするために必要なJVM設定を適用する手順を説明します。エージェントをインストールする際に必要なJVMオプションの構成とLibertyとの統合に最適な設定方法、ヒープヒストグラムの照会方法が含まれています。

Jetty

WhaTapモニタリングソリューションをJettyアプリケーションに統合するためのJVM(Java Virtual Machine) オプションの追加方法についての詳細な案内を提供します。本文書は、Javaエージェントのインストール後、Jettyアプリケーションの性能および可用性をモニタリングするために必要なJVM設定を適用する手順を説明します。エージェントをインストールする際に必要なJVMオプションの構成とJettyとの統合に最適な設定方法、ヒープヒストグラムの照会方法が含まれています。

Spring Boot

WhaTapモニタリングソリューションをSpring Bootアプリケーションに統合するためのJVM(Java Virtual Machine) オプションの追加方法についての詳細な案内を提供します。本文書は、Javaエージェントのインストール後、Spring Bootアプリケーションの性能および可用性をモニタリングするために必要なJVM設定を適用する手順を説明します。エージェントをインストールする際に必要なJVMオプションの構成とSpring Bootとの統合に最適な設定方法、ヒープヒストグラムの照会方法が含まれています。

Play2

WhaTapモニタリングソリューションをPlay2アプリケーションに統合するためのJVM(Java Virtual Machine) オプションの追加方法についての詳細な案内を提供します。本文書は、Javaエージェントのインストール後、Play2アプリケーションの性能および可用性をモニタリングするために必要なJVM設定を適用する手順を説明します。エージェントをインストールする際に必要なJVMオプションの構成とPlay2との統合に最適な設定方法、ヒープヒストグラムの照会方法が含まれています。

IBM BlueMix

IBM BluemixクラウドプラットフォームでJavaアプリケーションを実行するユーザーが、WhaTapのJavaモニタリングエージェントを効果的に適用するためのJVMオプションを設定する方法についてご案内します。ユーザーはこの文書を通じてIBM Bluemix環境でWhaTapのJavaエージェントをインストールしてからエージェントを構成する過程、必要なJVMオプションの追加方法を段階別に確認できます。さらに、ヒストグラムの照会方法が含まれています。

Elastic Beanstalk

AWS Elastic Beanstalk環境でJavaアプリケーションを実行するユーザーが、WhaTapのJavaモニタリングエージェントを効果的に適用するためのJVMオプションを設定する方法を案内します。Elastic Beanstalkに合わせたWhaTap Javaエージェントのインストールと構成過程、必須JVMオプションの追加及び設定方法を確認することができます。さらに、ヒストグラムの照会方法が含まれています。

Docker

ドッカー(Docker)環境でJavaアプリケーションにWhaTap Javaモニタリングエージェントを適用する手順を案内します。ユーザーは、既存のDockerのイメージにWhaTap Javaエージェント設定を追加して新しいイメージをビルドする手順、whatap.confファイルの作成、Dockerfileの作成、JAVA_OPTの修正方法などを確認できます。また、Java 17以降のバージョンで必要な追加JVMオプションと様々なJavaバージョンによるヒープ・ヒストグラムの照会設定方法も案内します。

バッチアプリケーション

WhaTapのJavaエージェントをバッチアプリケーションに適用する方法を案内します。バッチアプリケーションの独特な開始をはじめ中止の繰り返し動作によるウェブアプリケーションとの違いを説明し、必要なエージェントのダウンロード、エージェントとバッチホストの構成、エージェントと一緒にバッチ作業の実行、time_limit設定などを通じた実行時間のモニタリング方法を提供します。

Java 1.6バージョン未満

Java 1.6バージョン未満でJavaエージェントを適用する方法を案内します。Java 1.5と1.4バージョンそれぞれについてエージェントのインストールと設定手順、そして-javaagentオプションに関する制約事項を確認できます。

プロジェクト作成​

アクセスキーの確認​

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

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

whatap.confファイルを設定する​

基本情報を入力する​

セキュリティキーの設定​

JVMオプション追加​