Javaモニタリングのシステム要件

Instana は、以下の JVM ディストリビューションをサポートしています：

• Amazon Corretto
• Azul Zulu
• J9IBM （詳細については、 および OpenJ9 を考慮し、 OpenJ9J9IBM および IBMJ9 制限事項を参照してください）
• OpenJ9Eclipse （詳細については、 および OpenJ9J9IBM を考慮してください）
• 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 またはそれ以降のバージョンにアップグレードしてください。 1.8.0_40 までの Java 8 ビルドには、ラムダ関数の実装に関連する既知の問題が多数ある。 そのため、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 ファイルとして実行されます。

  インスタナはこの設定をサポートしている。 しかし、サービスを開始する前に、サービスを実行している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ランタイム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モニタリングを成功させるためには、エージェントを実行するルート・ユーザーとJVMを実行するユーザーが、 $TMP ディレクトリに対して必要な読み取り権限と書き込み権限を持っていることを確認してください。 また、 $TMP と $TMP/.instana ディレクトリからInstanaファイルをクリーンアップしないでください。

エージェントのログに Suppressed spans due to high number of short や Discarded span due to queue overflow のようなログが表示された場合、Java Tracer のスパン処理に高負荷がかかったことを意味します。 その結果、Javaトレーサーは、アプリケーションのパフォーマンス問題を回避するために、いくつかのスパンをドロップする。

負荷を軽減するために、Java Tracerは以下のステップを実行する：

1. 持続時間の短い出口スパンを抑制する。
2. それでも負荷が高い場合は、スパンを一括してグループ化する。
3. バッチングがうまくいかないと、数スパン落ちる。