.NETエージェント環境変数
このページでは、Windows システム環境変数を使用して設定できる .NET 構成プロパティについて説明します。
エージェントのアカウント名
SaaSまたはマルチテナントコントローラのアカウント名を指定します。
Environment Variable：APPDYNAMICS.AGENT.ACCOUNTNAME
Type：文字列
Default：シングルテナント コントローラの場合、アカウント名を指定しないと、エージェントはデフォルトの「customer1」とみなします。
Required：SaaS コントローラまたはマルチテナントコントローラの場合のみ。
エージェントのアプリケーション名
コントローラで使用するビジネスアプリケーションを指定します。アプリケーション名が存在しない場合、エージェントが登録された時にコントローラがそれを作成します。「アプリケーションモニタリングの概要」を参照してください。
Environment Variable：APPDYNAMICS.AGENT.APPLICATIONNAME
Type：文字列
Default: なし
Required: はい
エージェントアカウントのパスワード
コントローラのアカウントアクセスキーを指定します。
Environment Variable：APPDYNAMICS.AGENT.ACCOUNTACCESSKEY
Type：文字列
Default: なし
Required: はい
エージェントのノード名
ノードの名前。
一般的に、ノード名はビジネスアプリケーションおよび物理的なホスト内で一意でなければなりません。同じ物理マシン上で複数のノードに同じノード名を使用したい場合は、ユニークホストIDのプロパティを使って複数の仮想ホストを作成します。「ユニークホスト ID」を参照してください。
Environment Variable：APPDYNAMICS_AGENT_NODE_NAME
Type：文字列
Default: なし
Required: はい
エージェントの再利用ノード名
この環境変数をtrueに設定し、AppDynamicsでノード名を再利用する。プロパティが true の場合、ノード名を指定する必要はありませんが、appdynamics.agent.reuse.nodeName.prefix を使用してノード名プレフィックスを指定する必要があります。
このプロパティは、寿命が短い CLR が多数ある環境のモニタリングに役立ちます。true の場合、Splunk AppDynamics は新しい CLR に過去の CLR のノード名を再利用します。これにより、本質的には同一プロセスのノードが異なる時間で実行される場合に、Splunk AppDynamics 内で別の名前が付いたノードが時間の経過とともに急増するのを回避できます。
Splunk AppDynamics はノード名をアプリ、ティア、シーケンス番号を使い生成します。ノード名はプールされます。たとえば、ノードがパージされる（ノードの存続期間に基づく）と、シーケンス番号が再利用されます。
.NET エージェントは起動時に、コントローラに登録され、コントローラがノード名を生成するまで、出力をコンソールに記録します。
コントローラは、node.retention.period プロパティに基づいてノード名を再利用します。
Environment Variable：appdynamics.agent.reuse.nodeName
Type：ブール型
Default：False
Required: なし
例：次の環境変数の仕様を使用して、コントローラはプレフィックス「reportGen」を含むノード名を生成します。並列で実行しているノードの数に応じて、ノード名には、--1 や --2 などのサフィックスが付きます。シャットダウンされ履歴ノードと見なされるノードの名前は、新しいノードにより再利用される場合があります。
appdynamics.agent.reuse.nodeName=true
appdynamics.agent.reuse.nodeName.prefix=reportGen
エージェントの再利用ノード名プレフィックス
Environment Variable：appdynamics.agent.reuse.nodeName.prefix
Type：文字列
Default: なし
Required：appdynamics.agent.reuse.nodeName=true の場合
Example：次の環境変数の仕様を使用して、エージェントはコントローラに対して、プレフィックス「reportGen」を含むノード名を生成するように指示します。並列して実行しているノード数に応じて、ノード名には--1、 --2、などのサフィックスが付きます。
appdynamics.agent.reuse.nodeName=true
appdynamics.agent.reuse.nodeName.prefix=reportGen
エージェントのティア名
Environment Variable：APPDYNAMICS_AGENT_TIER_NAME
Type：文字列
Default: なし
Required: はい
Agent 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 Standalone Machine Agent Installation Scenarios.
unique_host_id only before any registration. After registration, modifying the unique_host_id can result in loss of visibility.
Environment Variable: APPDYNAMICS_AGENT_UNIQUE_HOST_ID
Type: String
Default: None
Required: No
AWS インスタンスの ID
インストゥルメント化するアプリケーションが AWS で実行されている場合、.NET エージェントは AWS インスタンス ID の収集をサポートします。AWS インスタンス ID を収集するには、次のように設定します。APPDYNAMICS.AWS.INSTANCE.ENABLED=true
Environment Variable：APPDYNAMICS.AWS.INSTANCE.ENABLED
Type：ブール型
Default：false
Required: なし
コントローラのホスト名
Environment Variable：APPDYNAMICS.CONTROLLER.HOSTNAME
Type：文字列
Default: なし
Required：必須。エージェントの config.xml ファイルまたはエージェント構成ユーティリティを使用して設定することもできます。
コントローラのポート番号
コントローラの HTTP（S）ポートを指定します。APPDYNAMICS.CONTROLLER.SSL.ENABLED 環境変数を true に設定した場合は、コントローラの HTTPS ポートを指定します。それ以外の場合は、HTTP ポートを指定します。
Environment Variable：APPDYNAMICS.CONTROLLER.PORT
Type：正の整数
Default：8090
- オンプレミスのインストールの場合、HTTPのデフォルトはポート8090、HTTPSのデフォルトはポート8181です。
- SaaSコントローラの場合、HTTPに80またはHTTPSに443を使用。
Required：必須。エージェントの config.xml ファイルまたはエージェント構成ユーティリティを使用して設定することもできます。
コントローラSSL対応
「true」に設定すると、エージェントとコントローラ間で SSL による暗号化が可能になります。
Environment Variable：APPDYNAMICS.CONTROLLER.SSL.ENABLED
Type：ブール型
Default：false
Required：不要。エージェントの config.xml ファイルまたはエージェント構成ユーティリティを使用して設定することもできます。
HTTP プロキシ ホスト（HTTP Proxy Host）
プロキシホストの名前。
環境変数：APPDYNAMICS_PROXY_HOST_NAME
タイプ：文字列
デフォルト：[なし（None）]
要否：オプション。エージェントの AppDynamicsConfig.json ファイルの「proxy」セクションで設定することもできます。
HTTP プロキシ ポート（HTTP Proxy Port）
プロキシのポート番号。
環境変数：APPDYNAMICS_PROXY_PORT
型：正の整数
デフォルト：[なし（None）]
要否：オプション。エージェントの AppDynamicsConfig.json ファイルの「proxy」セクションで設定することもできます。
HTTP プロキシユーザ
プロキシに接続するユーザの名前。
環境変数：APPDYNAMICS_PROXY_AUTH_NAME
タイプ：文字列
デフォルト：[なし（None）]
要否：オプション。エージェントの AppDynamicsConfig.json ファイルの「proxy」セクションで設定することもできます。
HTTP プロキシパスワード
プロキシに接続するユーザのパスワード。
環境変数：APPDYNAMICS_PROXY_AUTH_PASSWORD
タイプ：文字列
デフォルト：[なし（None）]
要否：オプション。エージェントの AppDynamicsConfig.json ファイルの「proxy」セクションで設定することもできます。
HTTP プロキシドメイン
プロキシに接続するドメイン。
環境変数：APPDYNAMICS_PROXY_AUTH_DOMAIN
タイプ：文字列
デフォルト：[なし（None）]
要否：オプション。エージェントの AppDynamicsConfig.json ファイルの「proxy」セクションで設定することもできます。
環境変数の参照
.NET エージェント（config.xml を使用）は、エージェントノード名、エージェントティア名、またはコントローラ アプリケーション名を設定する場合、環境変数を参照できます。
これらの環境変数は、コンフィギュレーション ファイルまたは上記のノード、ティア、およびアプリケーション名のエージェント環境変数で参照できます。環境変数を追加するには、他の文字と組み合わせができる %<variable>% を指定して参照します。たとえば、Web-%COMPUTERNAME% は Web-HOST23 に変換されます。