自動命名

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

controller-info.xml 内の要素：<auto-naming>

型：boolean

デフォルト：なし

**必須**

アプリケーション名

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

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

controller-info.xml 内の要素：<application-name>

システムプロパティ：-Dappdynamics.agent.applicationName

環境変数：APPDYNAMICS_AGENT_APPLICATION_NAME

型：文字列

デフォルト：なし

必須：はい

ティア名

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

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

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

controller-info.xml 内の要素：<tier-name>

システムプロパティ：-Dappdynamics.agent.tierName

環境変数：APPDYNAMICS_AGENT_TIER_NAME

型：文字列

デフォルト：なし

必須：はい

ノード名

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

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

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

controller-info.xml 内の要素：<node-name>

システムプロパティ：-Dappdynamics.agent.nodeName

環境変数：APPDYNAMICS_AGENT_NODE_NAME

型：文字列

デフォルト：なし

必須：はい

ノード名を再利用

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 のインストゥルメント化」を参照してください。

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

システムプロパティ：-Dappdynamics.agent.reuse.nodeName

環境変数：APPDYNAMICS_JAVA_AGENT_REUSE_NODE_NAME（4.5.8 で新規追加）

type: boolean

デフォルト：False

必須：いいえ

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

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

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

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

システムプロパティ：-Dappdynamics.agent.reuse.nodeName.prefix

環境変数：APPDYNAMICS_JAVA_AGENT_REUSE_NODE_NAME_PREFIX（4.5.8 で新規追加）

型：文字列

デフォルト：なし

必須：-Dappdynamics.agent.reuse.nodeName=true の場合

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

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

セルフサービス

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

システムプロパティ：-Dappdynamics.agent.selfService

型：文字列

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

デフォルト：なし

必須：いいえ