Java の監視に必要なシステム要件

Instana 以下の JVM ディストリビューションに対応しています：

• Amazon Corretto
• Azul Zulu
• IBM J9 （詳細については、 IBM、 J9、および OpenJ9 の「考慮事項」、ならびに IBM、 J9、および OpenJ9 の「制限事項」 を参照してください）
• Eclipse OpenJ9 （詳細については、 IBM、 J9、および OpenJ9 の「考慮事項」 を参照してください）
• OpenJDK
• AdoptOpenJDK
• Oracle HotSpot
• SAP JVM
• Sun HotSpot
• BEA JRockit
• 日立 JVM

Java Runtimes 8 またはそれ以前のバージョンを使用している場合は、以下の手順を必ず実行してください：

• Amazon Corretto、Azul Zulu、OpenJDK、Oracle HotSpot、または SAP JVM で、各モニター対象 JVM のランタイムで tools.jar ファイルを使用可能にします。 ファイルは $JAVA_HOME/lib/tools.jarにあります。

• Java 8 をお使いの場合は、 Java 8 1.8.0_181 またはそれ以降のバージョンにアップグレードしてください。 Java 8から 1.8.0_40 までのビルドには、ラムダ関数の実装に関連する多くの既知の問題があります。 したがって、 Java 8 において、 Instana エージェントは、 1.8.0_40 およびそれ以前のバージョンをサポートしていません。 そのため、いくつかの異常終了が修正されているため、新しいバージョンにアップグレードする必要があります。

Java バージョン9では、Jigsawフレームワークに基づくモジュール化されたビルドが導入されました。 Java Runtimes 9 以降をご利用の場合は、以下の手順を実行してください：

• ``や` jmod `を使用して作成 jlink されたものなど、カスタムランタイムイメージを使用する場合は、インスツルメントされた JVM に以下のモジュールを含めるようにしてください：

  • java.instrument
  • jdk.attach

  お使いの Java 9以降のランタイムに必要な java.instrument および jdk.attach モジュールが含まれているかどうかを確認するには、次のコマンドを実行してください：

  java --list-modules
   

  JVM 8 以前のバージョンでこのコマンドを実行すると、エラーメッセージ Unrecognized option: --list-modules が表示されます。

• Apache Tomcat が Windows 上でサービスとして実行されている場合、監視対象のプロセスはファイル C:\java12\bin\java.exe としてではなく、ファイルC:\Program Files\Apache Software Foundation\Tomcat 8.5\bin\Tomcat8.exe として実行されます。

  Instana この設定に対応しています。 ただし、サービスを開始する前に、そのサービスが実行されている JVM 上のディレクトリ bin が.ディレクトリにある必要があります PATH。 パスを設定するには、次のコマンドを実行してください：

  set PATH=%PATH%;C:\java12\bin
   

  サーバーの jvm.dll ファイルが C:\java12\bin\instrument.dll ファイルをロードする必要があるため、パスを設定する必要があります。 ファイルがパスに指定されていない場合、サーバーはそれを見つけることができず、以下のエラーが表示されます。

  com.sun.tools.attach.AgentLoadException: Failed to load agent library: instrument was not loaded.Can't find dependent libraries
   

Java Runtime 21 を使用している場合、次のような警告メッセージが表示されることがあります：

WARNING: A Java agent has been loaded dynamically (/tmp/.instana/javaagent-loader-1.3.56.jar)
WARNING: If a serviceability tool is in use, please run with -XX:+EnableDynamicAgentLoading to hide this warning
WARNING: If a serviceability tool is not in use, please run with -Djdk.instrument.traceUsage for more information
WARNING: Dynamic loading of agents will be disallowed by default in a future release
 

この問題を回避するには、アプリケーションを開始する前に、仮想マシンの引数に以下のコマンドを追加します。

-XX:+EnableDynamicAgentLoading
 

Instana のホストエージェントは、 $TMP/.instana ディレクトリ内に一時的なJARファイルを作成します。 これらのJARファイルは、 JVM の監視に必要です。 JVM の監視を正常に行うには、エージェントを実行するrootユーザーと JVM を実行するユーザーが、当該 $TMP ディレクトリに対する必要な読み取りおよび書き込み権限を持っていることを確認してください。 また、 Instana$TMP/.instana$TMP ディレクトリ内のファイルを削除しないでください。

エージェントのログに や Suppressed spans due to high number of short といったログが表示された場合、 Discarded span due to queue overflowJava Tracer のスパン処理に高負荷がかかっていることを意味します。 その結果、 Java のTracerは、アプリケーションのパフォーマンス低下を防ぐため、スパン数を数個削減しています。

負荷を軽減するため、 Java Tracer は以下の手順を実行します：

1. これは、短期間の出口スパンを抑止します。
2. 負荷がまだ高い場合は、スパンをバッチ単位でグループ化します。
3. バッチ処理が成功しない場合は、いくつかのスパンがドロップされます。