Javaエージェントのディストリビューションアーカイブを解凍すると、以下のファイルとディレクトリが現在のディレクトリに抽出されます。

Java エージェントディレクトリコンテンツ 

  • conf:共通の構成ファイル。構成ファイルのより具体的なバージョンがバージョン固有の構成ディレクトリ ver<version_number>/conf に存在しない場合、エージェントはこのディレクトリの構成ファイルを使用。 
  • javaagent.jar:Java エージェントのブートストラップに使用される共通の JAR ファイル。エージェントを有効化するには、起動時に --javaagent 引数の値としてこのファイルの完全修飾ロケーションを JVM に伝える。
  • readme.txt:Java エージェントのインストール用手順と備考。 
  • utils:エージェントの複数のバージョン間で共有されるユーティリティ用バイナリファイル。  
  • ver<version_number>javaagent.jar ファイル、構成ファイル、およびこのバージョンの Java エージェントに固有のその他のリソース。このディレクトリには、ver4.4.0.5 などの Java エージェントのバージョン番号を反映した名前が付けられています。
    とりわけ、このディレクトリには以下が含まれています。
    • conf:このバージョンの Java エージェントが使用する構成ファイル(controller-info.xmlapp-agent-config.xml など)。これらのファイルの設定は、<agent_home>/conf ディレクトリ内の構成ファイルよりも優先されます。 
    • external-services分析データソース動的サービスなど、エージェントを拡張する動的にロードされるモジュール。
    • javaagent.jar:Java エージェントのバイナリとして機能するバージョン固有の JAR ファイル。インストゥルメント化を直接構成するときは、この Java エージェント JAR を使用しないでください。その場合は、ルートディレクトリの javaagent.jar を使用します。 
    • lib:このバージョンの Java エージェントの動作をサポートするライブラリ。  
    • logs:エージェントが書き込むログファイル。
    • sdk:AppDynamics の Java エージェントの機能を拡張するためのサンプル、API、および Javadoc。
    • utilsこのバージョンのエージェント固有のユーティリティ用バイナリファイル。

アプリケーションの展開方法を変更せずにエージェントをアップグレードできるため(新しいエージェントバージョンを解凍し、ファイルシステムの以前の場所に配置します)、JVM 引数を最上位の javaagent.jar で指定できます。最上位の jar の特定のバージョンは、名前に同じバージョン番号が付いたディレクトリの下にある javaagent.jar と同じように動作します。

バージョン固有の  javaagent.jar では、異なるバージョンのエージェントを使用し、同時に同じ最上位の構成ファイルを再利用できます。異なるバージョンのエージェントで異なるアプリケーション JVM 引数を指定できます。 

構成ディレクトリのコンテンツ

このディレクトリにあるファイルは通常、エージェント構成とデプロイメントに使用されます。

  • transactions.xml: エージェントが認識するビジネストランザクションの構成設定。
  • controller-info.xml: このエージェントがAppDynamicsコントローラにレポートするデータに関連付けられているノード、ティア、アプリケーションを識別する構成設定と、コントローラの接続設定。詳細については、Javaエージェント構成プロパティを参照してください。
  • app-agent-config.xml: このエージェントのローカル構成設定。このファイルの設定は、AppDynamicsデプロイメント用にグローバルに指定されている同等の設定に上書きされる。このファイルは通常、短期のプロパティ設定またはエージェントの問題のデバッグに使用されます。
  • jmx: JMXおよびWebsphere PMIメトリックを構成するためのファイル。
  • logging/log4j.xml:エージェントのログレベルを管理するフラグ。デフォルトのログレベルを変更しないことを強く推奨。