すべてのプロダクト
Search
ドキュメントセンター

Application Real-Time Monitoring Service:ARMS エージェントのインストールに関する FAQ

最終更新日:Jan 23, 2025

ARMS エージェントのログを表示するにはどうすればよいですか?

  • デフォルトでは、ログは ${agent ルートディレクトリ}/logs/${pid}_${ip}.log にあります。

    ${agent ルートディレクトリ} はエージェントディレクトリを指し、エージェントのインストール方法によって異なります。

    • エージェントがコンテナー、Enterprise Distributed Application Service (EDAS)、または Enterprise Distributed Application Service にインストールされている場合、${agent ルートディレクトリ} は /home/admin/.opt/ArmsAgent/ または /home/admin/.opt/AliyunJavaAgent です。

    • エージェントを手動でインストールした場合、${agent ルートディレクトリ} はエージェントをダウンロードして解凍したディレクトリを指します。

    • エージェントのインストール方法がわからない場合は、ps ef | grep java コマンドを実行して、プロセスの起動コマンドを表示できます。エージェントディレクトリは -javaagent パラメーターで指定されています。起動コマンドが -javaagent:/home/zhangsan/agent/arms-bootstrap-1.7.0-SNAPSHOT.jar であると仮定すると、エージェントディレクトリは /home/zhangsan/agent です。

  • 起動パラメーター -DJM. LOG.PATH=xxx を手動で変更した場合、ログは ${JM.LOG.PATH}/${pid}_${ip}.log にあります。

ARMS エージェントにデータがないのはなぜですか?

  1. エージェントが正常に起動したかどうかを確認します。

    1. アプリケーションの起動中に、エージェントが正常にロードされたことを示すキーワードが標準出力ログに含まれているかどうかを確認します。

      ARMS エージェント v3.x の標準出力ログには、エージェントがマウントされると (AliyunJavaAgentBootstrap) arms agent start cost が含まれます。

      ARMS エージェント v4.x の標準出力ログには、エージェントがマウントされると Aliyun Java Agent start cost が含まれます。

      このようなログが存在しない場合は、エージェントがマウントされていないか、事前チェックが失敗したことを示します。この場合も同様に、ログ情報 ( Aliyun Java Agent requires minimal memory of 200M など) がその事実を示しています。

    2. 起動ログで例外が発生したかどうかを確認します。例外 java.security.NoSuchAlgorithmException: DES KeyGenerator not available が発生した場合は、エージェントを 4.x にアップグレードしてください。そうでない場合は、チケットを送信する

      説明

      エージェントログの場所については、「ARMS エージェントのログを表示するにはどうすればよいですか?」をご参照ください。

  2. エージェントが正常に起動した場合は、次の手順を実行してトラブルシューティングを続行します。

    1. エージェントログで regionId キーワードを検索して、エージェントがデータをレポートするリージョンを特定します。正しいリージョンを選択しているかどうかを確認します。

    2. エージェントがネットワーク接続関連のエラーを報告したかどうかを確認します。報告されている場合は、「Java 用 ARMS エージェントに必要なネットワーク構成」のトピックを参照してエラーを解決することをお勧めします。

    3. アプリケーションにトラフィックがあるかどうかを確認します。

  1. 問題が解決しない場合は、チケットを送信する

ARMS では、個々のデプロイメントにエージェントバージョンを指定するのではなく、Kubernetes クラスター全体に統一されたエージェントバージョンを指定できますか?

はい。チケットを送信するか、テクニカルサポートに連絡して Kubernetes クラスター全体に統一されたエージェントバージョンを指定してください。

Pinpoint エージェントの後に ARMS エージェントをマウントすると、データがないのはなぜですか?

  • ARMS エージェント v3.x は Pinpoint Agent をベースに開発されています。ARMS エージェント v3.x または Pinpoint Agent のいずれかのみをインストールできます。

  • ARMS エージェント v4.x は OpenTelemetry Java エージェントをベースに開発されており、Pinpoint エージェントと並行してマウントできます。ただし、両方のエージェントを同時にマウントした場合の互換性は保証されません。

ARMS 接続後の java.lang.NoSuchMethodError: 'org.springframework.http.HttpStatus エラーを解決するにはどうすればよいですか?

v3.2.0 より前の ARMS エージェントの場合、EDAS からアプリケーションの ARMS エージェントをインストールし、-Dedas.scg.enable 機能を有効にすると、com.navercorp.pinpoint.plugin.reactive.filter.AccessLogFilte がフィルターチェーンに自動的に追加されます。このエラーは、フィルターが spring boot3 に適していないために発生しました。この問題は ARMS エージェント v3.2.0 以降で修正されています。

ログの「logContent rate limit count」とは何ですか?

このメッセージは、ログ出力が過剰なため、エージェントがレート制限されていることを示しています。レート制限は、アプリケーションのパフォーマンスが過剰なログの影響を受けないようにするために実装されています。エージェントの誤動作や問題を示すものではありません。