Javaエージェント構成プロパティ

エージェントとコントローラ間のコミュニケーション プロパティを次に示します。

AWS インスタンス

appdynamics-aws-instance-enabled プロパティは、登録時にエージェントが AWS インスタンス ID をデフォルトで取得できるようにします。

このプロパティはデフォルトで有効になっており、エージェントログには Agent AWS instance-id retrieval enabled: true が含まれます。プロパティを無効にするには、appdynamics.aws.instance.enabled=false を設定します。エージェントログには、次が含まれます。Agent AWS instance-id retrieval enabled: false.

System Property： -Dappdynamics.aws.instance.enabled

Environment Variable：APPDYNAMICS_AWS_INSTANCE_ENABLED

Type：ブール型

Default：True

Required: はい

コントローラホスト

コントローラのホスト名または IP アドレス。値の例として、192.168.1.22、myhost、または myhost.example.com があります。これは Splunk AppDynamics のブラウザベースのユーザーインターフェイスのアクセスに使用するホストと同じです。オンプレミスのコントローラの場合、コントローラをインストールしたときに構成したアプリケーション サーバー ホスト名の値を使用します。コントローラサービスを使用する場合、Splunk AppDynamics オンプレミス からのウェルカムメールを参照してください。Splunk AppDynamics

Element in controller-info.xml： <controller-host>

System Property： -Dappdynamics.controller.hostName

Environment Variable：APPDYNAMICS_CONTROLLER_HOST_NAME

Type：文字列

Default: なし

Required：オーケストレーションの有効化プロパティが以下の場合は必須。

trueオーケストレーションの有効化が true で、アプリケーション エージェントが Splunk AppDynamics ワークフローによって作成されるコンピューティング クラウド インスタンスに展開されている場合、自動検出値をオーバーライドする場合を除き、コントローラホストを設定しないでください。「オーケストレーションの有効化プロパティ」を参照してください。

コントローラポート

Splunk AppDynamics コントローラの HTTP(S) ポート。これは Splunk AppDynamics のブラウザベースのユーザーインターフェイスのアクセスに使用するポートです。

コントローラ SSL 対応プロパティが true に設定されている場合はコントローラの HTTPS ポートを指定し、それ以外の場合は HTTP ポートを指定します。「コントローラ SSL 対応プロパティ」を参照してください。

Element in controller-info.xml： <controller-port>

System Property： -Dappdynamics.controller.port

Environment Variable：APPDYNAMICS_CONTROLLER_PORT

Type：正の整数

Default：オンプレミスのインストールの場合、HTTP ではポート 8090、HTTPS ではポート 8181 がデフォルトになります。SaaS コントローラサービスの場合は、HTTPS 接続にポート 443 を使用します。

Required：オーケストレーションの有効化プロパティが false の場合は必須。

Splunk AppDynamicsオーケストレーションの有効化が true で、アプリケーション エージェントが ワークフローによって作成されるコンピューティング クラウド インスタンスに展開されている場合、自動検出値をオーバーライドする場合を除き、コントローラポートを設定しないでください。「オーケストレーションの有効化プロパティ」を参照してください。

コントローラSSL対応

trueに設定すると、エージェントがSSL (HTTPS) を使用してコントローラに接続するよう指定します。SSL対応がtrueの場合、コントローラポートのプロパティをコントローラのHTTPSポートに設定します。「コントローラ ポート プロパティ」を参照してください。

Element in controller-info.xml： <controller-ssl-enabled>

System Property： -Dappdynamics.controller.ssl.enabled

Environment Variable：APPDYNAMICS_CONTROLLER_SSL_ENABLED

Type：ブール型

Default：False

Required: なし

コントローラ キーストアパスワード

コントローラ証明書のパスワードのプレーンテキスト値。[暗号化されたログイン情報の使用（Use Encrypted Credentials）] が true の場合、パスワードを暗号化します。暗号化された認証情報を使用「エージェントのログイン情報の暗号化」を参照してください。

Element in controller-info.xml： <controller-keystore-password>

System Property： -Dappdynamics.controller.keystorePassword

Environment Variable： APPDYNAMICS_CONTROLLER_KEYSTORE_PASSWORD

Type：文字列

Default: なし

Required: なし

コントローラ キーストアパスワード

デフォルトでは、エージェントは、エージェントホームの <agent_home>/<version>/conf ディレクトリにある cacerts.jks という名前の Java トラストストアファイルを探します。このプロパティを使用し、異なるJavaトラストストアファイルを使うコントローラSSL証明書の完全な検証を可能にします。「Java エージェント用 SSL の有効化」を参照してください。Javaエージェント用SSLの有効化

Element in controller-info.xml： <controller-keystore-filename>

System Property： -Dappdynamics.controller.keystoreFileName

Environment Variable： APPDYNAMICS_CONTROLLER_KEYSTORE_FILENAME

Type：文字列

Default: なし

Required: なし

デフォルトのSSL証明書検証の強制

SSL検証のデフォルトの動作をオーバーライドするのに使用。このプロパティには3つの状態があります。

• true：エージェントは、コントローラによって送信された証明書の完全な検証を強制的に実行します。これにより、エージェントは SSL 信頼チェーンを適用できます。パブリック証明機関（CA）がコントローラの SSL 証明書に署名した場合、この設定を使用します。「トラステッド CA 署名済み証明書を使用したオンプレミス SSL の有効化」を参照してください。
• false：エージェントは、証明書の最小限の検証を実行します。このプロパティはコントローラのSSL証明書の完全な検証を無効にします。SaaS証明書の検証が失敗した場合にこの設定を使用。
• unspecified：エージェントが実行する検証内容は、コンテキストに応じて以下のようになります。
  • エージェントがSaaSコントローラに接続している場合、完全な検証を実行。
  • エージェントがオンプレミスコントローラに接続しており、cacerts.jks ファイルがある場合、cacerts.jks ファイルを使用して完全な検証が実行されます。
  • エージェントがオンプレミスコントローラに接続しており、cacerts.jks ファイルがない場合、最小限の検証が実行されます。

Splunk AppDynamics エージェントの SSL プロトコル

「」にある SSL 互換性に関する表には、さまざまなバージョンの Java エージェントのデフォルト セキュリティ プロトコルが一覧で表示されています。 エージェントとコントローラの互換性ご使用のバージョンのエージェントのデフォルト セキュリティ プロトコルがコントローラと互換性がない場合、または介在するプロキシとの互換性がない場合は、--Dappdynamics.agent.ssl.protocol システムプロパティを渡して次のセキュリティプロトコルのいずれかを構成します。

• [SSL]
• [TLS]
• TLSv1.2
• TLSv1.1

System Property： -Dappdynamics.agent.ssl.protocol

Type：文字列

Default：「エージェントとコントローラテナントの互換性」を参照してください。

Required: なし

許可される TLS/SSL プロトコルの構成

TLS/SSL を介したエージェント通信により、エージェントは、JVM セキュリティサブシステムを初期化することにより、許可されるプロトコルのリストを設定します。既知の脆弱性により、Splunk AppDynamics はデフォルトで SSLv3 と TLSv1 プロトコルを除外します。

JVM の初期化後は、許可されるプロトコルのリストを変更できなくなります。エージェントが SSLv3 または TLSv1 プロトコルを無効にしないようにする場合は、次のプロパティを使用して、一方（またはカンマで区切って両方）のプロトコルを指定することにより、許可されるよう構成できます。

System Property： -Dappdynamics.agent.tls.allowedAlgorithms

Type：文字列

Default: なし

Required: なし

次の例では、TSLv1.2 を JVM で使用できます。

-Dappdynamics.agent.tls.allowedAlgorithms=TLSv1.2

無効な TLS/SSL プロトコルの設定

TLS/SSL を介したエージェント通信により、エージェントは JVM セキュリティサブシステムを初期化することにより、許可されるアルゴリズムのリストを設定します。

JVM の初期化後は、許可されるプロトコルのリストを変更できなくなります。エージェントが特定のアルゴリズムを有効にしないようにする場合は、次のプロパティを使用して、一方（またはカンマで区切って両方）のアルゴリズムを指定することにより、無効になるように設定できます。

System Property： -Dappdynamics.agent.tls.disabledAlgorithms

Type：文字列

Default: なし

Required: なし

-Dappdynamics.agent.tls.disabledAlgorithms=RSASSA-PSS,RSAPSS

暗号化された認証情報を使用

[Use Encrypted Credentials] を有効にする前に、Secure Credential Store の初期化に関する手順について、「エージェントの認証情報を暗号化する」を参照してください。

[Use Encrypted Credentials] を「True」に設定し、エージェントが Secure Credential Store で暗号化された認証情報を使用するよう構成します。認証情報の暗号化の使用を有効化した場合、Credential Storeファイル名と難読化されたCredential Storeパスワードを指定しなければなりません。

[暗号化されたログイン情報の使用（Use Encrypted Credentials）] が true の場合、次を暗号化します。暗号化された認証情報を使用

• アカウントアクセスキー
• コントローラ キーストアパスワード
• プロキシパスワード

controller-info.xml 内の要素：<use-encrypted-credentials>

型：boolean

デフォルト：False

必須：いいえ

Credential Storeファイル名

Secure Credential Storeキーストアへの絶対パス。「エージェントのログイン情報の暗号化」を参照してください。

controller-info.xml 内の要素：

型：文字列

デフォルト：なし

必須：[Use Encrypted Credentials] が「True」の場合

Credential Storeパスワード

Secure Credential Storeの難読化されたキーストアのパスワード。<credential-store-password>「エージェントのログイン情報の暗号化」を参照してください。

controller-info.xml 内の要素：<credential-store-filename>

型：文字列

デフォルト：なし

必須：[暗号化されたログイン情報の使用（Use Encrypted Credentials）] が True の場合

自動命名

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 エージェントの構成」を参照してください。

デフォルト：なし

必須：いいえ

Splunk AppDynamics コントローラがマルチテナントモードで実行している場合、または Splunk AppDynamics オンプレミス SaaS コントローラを使用している場合、エージェントがコントローラの認証に使用するアカウント名とキーを指定します。

Splunk AppDynamics オンプレミス SaaS コントローラを使用する場合、アカウント名は Splunk AppDynamics から送信されるウェルカムメールで通知されます。この情報は、<controller_home>/initial_account_access_info.txt ファイルにも記載されています。

コントローラがシングルテナントモードで実行している場合は、アカウントアクセスキーの構成だけが必要となります。コントロールインスタンス用の一意のアクセスキーは、UI の「2024-03-18_22-14-12_ライセンス使用状況の確認」ページで調べることができます。

アカウント名

コントローラの認証に使用されるアカウント名。

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

System Properties： -Dappdynamics.agent.accountName

Environment Variable： APPDYNAMICS_AGENT_ACCOUNT_NAME

Type：文字列

Default: なし

Required：Splunk AppDynamics オンプレミス コントローラとその他のマルチテナントユーザーの場合は必須、シングルテナントユーザーの場合は必須ではない。

アカウントアクセスキー

コントローラの認証に使用されるアカウントアクセスキー。認証情報の暗号化の使用がtrueの場合、パスワードを暗号化します。「エージェントのログイン情報の暗号化」を参照してください。

Element in controller-info.xml： <account-access-key>

System Properties： -Dappdynamics.agent.accountAccessKey

Environment Variable： APPDYNAMICS_AGENT_ACCOUNT_ACCESS_KEY

Type：文字列

Default: なし

Required: はい

プロキシプロパティを使用し、プロキシを通じてコントローラに接続するようにエージェントを構成する。

プロキシホスト

プロキシホスト名またはIPアドレス

System Property： -Dappdynamics.http.proxyHost

Type：文字列

Default: なし

Required: なし

プロキシポート

プロキシHTTP(S)ポート

System Property： -Dappdynamics.http.proxyPort

Type：正の整数

Default: なし

Required: なし

プロキシユーザー名

プロキシホストが認証したユーザー名

System Property： -Dappdynamics.http.proxyUser

Type：文字列

Default: なし

Required: なし

プロキシパスワード

プロキシホストにより認証されるユーザーのパスワードを含むファイルへの絶対パス。パスワードはファイルの最初の行になければなりません。

[暗号化されたログイン情報の使用（Use Encrypted Credentials）] が false の場合、パスワードをプレーンテキストで入力します。エージェントの認証情報を暗号化する[暗号化されたログイン情報の使用（Use Encrypted Credentials）] が true の場合、パスワードを暗号化します。エージェントの認証情報を暗号化する「[暗号化されたログイン情報の使用」を参照してください。

System Property： -Dappdynamics.http.proxyPasswordFile

Type：文字列

Default: なし

Required: なし

Example：-Dappdynamics.http.proxyPasswordFile=/path/to/file-with-password

Enable Orchestration

When set to true, enables auto-detection of the controller host and port when the app server is a compute cloud instance created by a Cisco AppDynamicsorchestration workflow. See Controller Host Property and Controller Port Property.

In a cloud compute environment, auto-detection is necessary for the Create Machine tasks in the workflow to run correctly.

If the host machine on which this agent resides is not created through Splunk AppDynamics workflow orchestration, this property should be set to false.

Element in controller-info.xml: <enable-orchestration>

Type: Boolean

Default: False

Required: No

Agent Runtime Directory

Sets the directory under which all files the agent writes at runtime. If this property is specified, all agent logs are written to <Agent-Runtime-Directory>/logs/node-name and transaction configuration is written to the <Agent-Runtime-Directory>/conf/node-name directory. The log folder location can be overridden with the appdynamics.agent.logs.dir property.

Element in controller-info.xml: <agent-runtime-dir>

System Property: -Dappdynamics.agent.runtime.dir

Environment Variable: APPDYNAMICS_AGENT_BASE_DIR

Type: String

Default: <agent_home>/nodes

Required: No

Redirect Logfiles

Sets the destination directory to which the logs will be written to.

System Property: -Dappdynamics.agent.logs.dir

Type: String

Default: <agent_home>/logs/<Node_Name>

Required: No

Custom Path for agent conf Directory

Sets a custom path for the agent conf directory. This is where the agent reads its static config files from. If you need to change custom-activity-correlation.xml or app-agent-config.xml and the agent installation is read-only, this instructs the agent to read the static config files from elsewhere

System Property:-

Type: String

Default: <agent_home>/ver4.5.x.x.x/conf

Required: No

Force Agent Registration

Set to true only under these conditions:

• The agent has been moved to a new application or tier from the UI, and
• You want to override that move by specifying a new application name or tier name in the agent configuration

Element in controller-info.xml: <force-agent-registration>

Type: Boolean

Default: False

Required: No

Auto Node Name Prefix

Set this property if you want the Controller to generate node names automatically using a prefix that you provide.

The Controller generates node names by concatenating the specified prefix with a UUID suffix. For example, if you set the prefix as follows:

-Dappdynamics.agent.auto.node.prefix=JoannaAutoNode

The generated node name is

JoannaAutoNode_d39dbfc1-6f4b-4eb7-a788-c1c0135b6bcb

This property provides a similar function to the Reuse Node Name Prefix Property property. However, this property is not meant to be used in combination with reusing node names; use Reuse Node Name Prefix Property for those cases instead.

Element in controller-info.xml: Not applicable

System Property: -Dappdynamics.agent.auto.node.prefix=<your_prefix>

Type: String

Default: Serial number maintained by the Controller appended to the tier name

Required: No

Auto Logs Directory Cleanup

Set this property if you want the Java agent to automatically delete the older node directories. By default this property is disabled and set to 0

On every agent restart, the agent deletes the older node directories that have not been updated in the last hours as specified in the property. For example, if you set the property as follows:

-appdynamics.agent.log.dir.threshold.hours=4

On the next agent restart, the agent will delete the node directories that have not been updated in the last 4 hours.

Element in controller-info.xml: Not applicable

System Property: -appdynamics.agent.log.dir.threshold.hours

Type: Integer

Default: 0

Required: No

Cron/Batch JVM

Set this property to true if the JVM is a batch/cron process. You can use this property to stall the shutdown to allow the agent to send metrics before shutdown.

Element in controller-info.xml: Not applicable

System Property: -Dappdynamics.cron.vm

Type: Boolean

Default: False

Required: No

Unique Host ID

Logically partitions a single physical host or virtual machine such that it appears to the Controller that the application is running on different machines. Set the value to a string that is unique across the entire managed infrastructure. The string may not contain any spaces. If you have a machine agent associated with the application monitored by the app agent, then this property must be set on the machine agent to the same value. See Machine Agent Installation Scenarios.

System Property: -Dappdynamics.agent.uniqueHostId

Environment Variable: APPDYNAMICS_AGENT_UNIQUE_HOST_ID

Type: String

Default: None

Required: No

Agent Meta Info

Allows you to associate arbitrary information with a node, which can then be used as a basis for applying health rules or policies by node. For example, you can exclude a health rule from applying to agents tagged as test agents based on a meta-info property. Pass the property in key___value format (for example, "key1___value1").

For information on using the properties in health rules or policies (along with built-in meta-info properties), see Configure Health Rules or Configure Policies.

System Property: -Dappdynamics.agent.node.metaInfo

Type: String

Default: None

Required: No

Low Entropy

Addresses agent startup issues in systems with low to zero entropy available for seeding the PRNG algorithm. This is set to true by default. The NativePRNGNonBlocking algorithm is used through SecureRandom if the system property appdynamics.low.entropy is set. Windows is not affected by this change as it does not support NativePRNGNonBlocking, and continues to use the existing Secure Random implementation.

System Property: appdynamics.low.entropy=true

Element in controller-info.xml: No

Environment Variable: No

Type:Boolean

Default:True

Required: No

If appdynamics.low.entropy=true then the agent takes measures to ensure it does not block when generating random values, even in the absence of entropy.

For example: From Java Agent 20.11, the agent defaults to using NativePRNGNonBlocking as its SecureRandom implementation. This will try to use a non-blocking low entropy algorithm for UUID generation. Note that NativePRNGNonBlocking is not supported on Windows and defaults to the existing implementation of SHA1PRNG.

Analytics Agent

For use with the transaction analytics feature with a remote (or non-default) Analytics agent. See Enable the App Server Agent for a Remote Analytics Agent.

System Property: -Dappdynamics.analytics.agent.url

Element in controller-info.xml: No

Environment Variable: No

Type: String

Default: http://localhost:9090/v2/sinks/bt

Required: No

Use Simple Hostname

By default (unless overridden with the uniqueHostId system property), the agent determines the host name of the OS it is running in by reverse DNS lookup. In some circumstances, this host name may be set as the fully qualified domain name of the host name. If this property is set to true, the agent removes any domain name and uses the simple hostname to identify the host. In cases where the host name is an IP address (which happens if the DNS lookup fails) the full IP address in string form is used. The host name is used in mapping metrics gathered by the machine agent to application nodes (see Unique Host ID Property).

Element in controller-info.xml: <use-simple-hostname>

Type: Boolean

Default: False

Required: No

For example: If this property is set to true 'server.mydomain.com' becomes 'server'.

Dynamic Services JAR Signing

When set to True, it enables automatic JAR signing of the dynamic services. In addition, it Identifies vulnerabilities in the dynamic service workflow. Also, it provides checks to prevent loading and executing code from a malicious dynamic service. When Set to False, disables the JAR signing.

Element in controller-info.xml: <enable-jar-signing>

Type: Boolean

Default: True

Required: No

Identify JVM Vendors

Java Agent automatically identifies the underlying JVM. In case it identifies incorrectly, this flag can be used to override the automatically detected JVM vendor. This property identifies the JVM even when it is renamed. Set this property to true to identify the underlying JVM. By default, this property is disabled.

Element in controller-info.xml: Not Applicable

System Property:: -Dappdynamics.jvm.vendor

Type: String

Accepted Values: ibm, sun

Default: N/A

Required: No

Java Agent Tags

Tags are key-value pairs that are associated with your entities, such as applications, tiers, nodes, etc. These tags act as metadata that help you find your application resources in the Controller UI. You can reduce the Mean Time To Detection (MTTD) of any entity related issues by tagging them using appropriate custom tags. To know how to import tags in Controller, see Custom Tag APIs.

The Java Agent tags can defined during the agent registration using the system property or environmental variable. In case of conflict, the environmental variable takes precedence over system property. These tags are sent to the Controller UI and help filter data using tag-based filtering and tag-based columns. If you make changes to your tagging configuration, you must restart the agent.

System Property: -Dappdynamics.entity.tag.*

Here are example tags using system property:

• -Dappdynamics.entity.tag.key1 = value1
• -Dappdynamics.entity.tag.key2 = value2

Environment Variable: APPDYNAMICS_ENTITY_TAG_*

Here are example tags using environmental variable:

• APPDYNAMICS_ENTITY_TAG_key1=value1
• APPDYNAMICS_ENTITY_TAG_key2=value2

Type: String

Default: None

Required: Optional

Set the following system property true to disable tags.

System Property: -Dappdynamics.disable.tags

Type: Boolean

Default: False

Required: Optional