自動命名

true に設定すると、Java エージェントはアプリケーションのノードに一意の名前を自動的に割り当てます。他のエージェント識別プロパティが別の設定で指定されていない場合、エージェントのティアとアプリケーションは自動的に命名されます。デフォルトの名前は MyApp、MyTier、application_server@host の形式になります。このプロパティを有効にした後は、必ず JVM を再起動してください。サーバーが再起動されるまで、ノード名はコントローラ UI に null として表示されます。

Element in controller-info.xml： <auto-naming>

Type：ブール型

Default: なし

Required：なし

アプリケーション名

このJVMノードが属する合理的なビジネスアプリケーションの名前。これはアプリケーションサーバー上のデプロイメント名(ear/war/jar)ではないことにご注意ください。

構成された名前のビジネスアプリケーションが存在しない場合、自動的に作成されます。

Element in controller-info.xml： <application-name>

System Property： -Dappdynamics.agent.applicationName

Environment Variable： APPDYNAMICS_AGENT_APPLICATION_NAME

Type：文字列

Default: なし

Required: はい

ティア名

このJVMノードが属するティアの名前。これはアプリケーションサーバー上のデプロイメント名(ear/war/jar)ではないことにご注意ください。

JVM またはアプリケーションサーバ起動スクリプトに、--Dserver.tier のような、ティアを参照するシステムプロパティがある場合、${server.tier} をティア名として使用できます。Javaエージェント設定にシステムプロパテイを使用するJavaエージェント設定にシステムプロパテイを使用する

エージェントは、最初にコントローラと接続したときにティアが存在しない場合、名前の付いたティアをコントローラに登録します。コントローラモデルに名前の付いたティアが存在する場合は、エージェントは既存のティアと関連付けられます。

Element in controller-info.xml： <tier-name>

System Property： -Dappdynamics.agent.tierName

Environment Variable： APPDYNAMICS_AGENT_TIER_NAME

Type：文字列

Default: なし

Required: はい

ノード名

ノードの名前。JVM が動的に作成される場合にシステムプロパティを使いノード名を設定する。

JVM またはアプリケーションサーバ起動スクリプトに、-Dserver.name のような、ノード名として使えるシステムプロパティがある場合、${server.name} をノード名として使用できます。また、${server.name}_${host.name}.MyNode のような式を使いノード名を定義できます。Javaエージェント設定にシステムプロパテイを使用するJavaエージェント設定にシステムプロパテイを使用する

一般的に、ノード名はビジネスアプリケーションおよび物理的なホスト内で一意でなければなりません。同じ物理マシン上で複数のノードに同じノード名を使用したい場合は、ユニークホストIDのプロパティを使って複数の仮想ホストを作成します。「ユニークホスト ID」を参照してください。

Element in controller-info.xml： <node-name>

System Property： -Dappdynamics.agent.nodeName

Environment Variable： APPDYNAMICS_AGENT_NODE_NAME

Type：文字列

Default: なし

Required: はい

ノード名を再利用

Splunk AppDynamicsこのプロパティを true に設定して でノード名を再利用します。プロパティが true の場合、ノード名を指定する必要はありませんが、-Dappdynamics.agent.reuse.nodeName.prefix を使用してノード名プレフィックスを指定する必要があります。

このプロパティは、寿命が短い JVM が多数ある環境のモニタリングに役立ちます。true の場合、Splunk AppDynamics は新しい JVM の過去の JVM のノード名を再利用します。これにより、本質的には同一プロセスのノードが異なる時間で実行される場合に、Splunk AppDynamics 内で別の名前が付いたノードが時間の経過とともに急増するのを回避できます。実際の作業負荷に基づき新しい JVM の起動とシャットダウンが行われる z/OS 動的ワークロード マネージャ ベースの環境などがこの環境の一例です。

Splunk AppDynamics はノード名をアプリ、ティア、シーケンス番号を使い生成します。ノード名はプールされます。たとえば、ノードがパージされる（ノードの存続期間に基づく）と、シーケンス番号が再利用されます。

Javaエージェントは起動すると、コントローラに登録されてコントローラがノード名を生成するまで、コンソールに出力を記録します。ログをファイルに書き込むようにエージェントを構成するには、<agent_home>/<version_number>/conf/logging で log4j-unknown.xml を編集します。「動的な環境における JVM のインストゥルメント化」を参照してください。

コントローラは、ノードの保持期間プロパティに基づいてノード名を再利用します。

System Property： -Dappdynamics.agent.reuse.nodeName

Environment Variable：APPDYNAMICS_JAVA_AGENT_REUSE_NODE_NAME（4.5.8 で新規追加）

Type：ブーリアン

Default：Fales

Required: なし

Example：以下の設定では、コントローラは「reportGen」というプレフィックスのあるノード名を生成します。並列で実行しているノードの数に応じて、ノード名には、-1 や -2 などのサフィックスが付きます。シャットダウンされ履歴ノードと見なされるノードの名前は、新しいノードにより再利用される場合があります。

-Dappdynamics.agent.reuse.nodeName=true -Dappdynamics.agent.reuse.nodeName.prefix=reportGen

ノード名プレフィックスを再利用

ノード名を再利用するようにエージェントを構成する際に、このプロパティを使用し、コントローラがノード名を動的に生成するのに使用するプレフィックスを指定します。

System Property： -Dappdynamics.agent.reuse.nodeName.prefix

Environment Variable：APPDYNAMICS_JAVA_AGENT_REUSE_NODE_NAME_PREFIX（4.5.8 で新規追加）

Type：文字列

Default: なし

Required：次の場合：-Dappdynamics.agent.reuse.nodeName=true

Example：以下のプロパティ仕様を使い、エージェントはコントローラに「reportGen」というプレフィックスのあるノード名を生成するよう指示します。並列して実行しているノード数に応じて、ノード名には--1、 --2、などのサフィックスが付きます。

-Dappdynamics.agent.reuse.nodeName=true -Dappdynamics.agent.reuse.nodeName.prefix=reportGen

セルフサービス

プラットフォームに基づいて自動的にノードに名前を付けるようJavaエージェントを構成します。自動ノード命名を機能させるには、アプリケーション名とティア名を指定する必要があります。

System Property： -Dappdynamics.agent.selfService

Type：文字列

Values：tibco：Java エージェントは TIBCO プロセス名のノードに名前を付けます。詳細については、「TIBCO BusinessWorks の Java エージェントの構成」を参照してください。

Default: なし

Required: なし