Application Real-Time Monitoring Service:ARMS エージェントの手動インストール失敗に関するトラブルシューティング

現象

ライセンスキーが無効です エラーが、ArmsAgent/log/ ディレクトリ内のログに表示されます。

原因

ARMS エージェントのインストールパッケージはリージョン固有です。ARMS エンドポイント情報はパッケージにカプセル化されています。ご利用のアプリケーションが実行されているリージョンとは異なるリージョンのパッケージをダウンロードした場合、エージェントは正しい ARMS エンドポイントに接続できません。

ソリューション

1. ご利用のアプリケーションが実行されているリージョンを確認します。

2. その特定のリージョン向けの ARMS エージェントのインストールパッケージをダウンロードします。ダウンロードリンクについては、「ARMS エージェントを手動でインストールする」をご参照ください。

3. 既存のエージェントディレクトリを、新しくダウンロードしたパッケージに置き換えます。

4. ご利用のアプリケーションを再起動します。

現象

ArmsAgent/log/ ディレクトリのエージェントログに LicenseKey is invalid エラーが表示されます。

原因

起動コマンドで指定されたライセンスキーが、ARMS コンソールでご利用のアプリケーションに割り当てられたライセンスキーと一致しません。

ソリューション

1. ARMS コンソールにログインします。

2. 左側のナビゲーションウィンドウで、アプリケーションモニタリング > アプリケーションリスト を選択します。

3. [アプリケーション] ページで、お使いのアプリケーションの名前をクリックしてライセンスキーを確認します。

4. コンソールのライセンスキーと、ご利用の起動コマンドの -Darms.licenseKey パラメーターの値を比較します。両者が同一であることを確認してください。

5. 値が異なる場合は、起動コマンドを正しいライセンスキーで更新し、ご利用のアプリケーションを再起動します。

現象

アプリケーションの起動後、ARMS エージェントが起動に失敗するか、データをレポートしません。

原因

特定の初期の JDK 1.8 バージョン、具体的には 1.8.0_25 と 1.8.0_31 には、ARMS エージェントが正しく機能するのを妨げる既知の互換性の問題があります。

ソリューション

1. ご利用の JDK バージョンを確認します。

   java -version

2. 出力にバージョン 1.8.0_25 または 1.8.0_31 が表示された場合は、より新しい JDK バージョンにアップグレードしてください。

3. サポートされている JDK バージョンとフレームワークの完全なリストについては、「ARMS がサポートする Java コンポーネントとフレームワーク」をご参照ください。

現象

アプリケーションの起動後、ArmsAgent ディレクトリに logs サブディレクトリが存在しません。

原因

aliyun-java-agent.jar ファイルが JVM によってロードされませんでした。これは通常、ArmsAgent ディレクトリのファイル権限が正しくない場合や、起動コマンドの -javaagent パラメーターが間違ったパスを指している場合に発生します。

ソリューション

1. ご利用の起動コマンドの -javaagent パラメーターが正しい JAR ファイルを指していることを確認します。

   # 例：実際のプロセスのコマンドラインを確認します
   ps -ef | grep java | grep javaagent

2. ArmsAgent ディレクトリとその内容が、アプリケーションを実行するユーザーによって読み取り可能であることを確認します。

   ls -la /path/to/ArmsAgent/

3. 権限が正しくない場合は、修正します。

   chmod -R 755 /path/to/ArmsAgent/

4. アプリケーションを再起動し、ArmsAgent ディレクトリに logs サブディレクトリが作成されるかどうかを確認します。