.NETエージェント環境変数
このページでは、Windows システム環境変数を使用して設定できる .NET 構成プロパティについて説明します。
エージェントのアカウント名
SaaSまたはマルチテナントコントローラのアカウント名を指定します。
環境変数:APPDYNAMICS.AGENT.ACCOUNTNAME
型:文字列
デフォルト:シングルテナント コントローラの場合、アカウント名を指定しないと、エージェントはデフォルトの「customer1」と見なします。
必須:SaaS コントローラまたはマルチテナントコントローラの場合のみ。
Agent Application Name
Specifies the business application you use in the Controller. If the application name does not exist, the Controller will create it when the agent registers. See Overview of Application Monitoring.
Environment Variable: APPDYNAMICS.AGENT.APPLICATIONNAME
Type: String
Default: None
Required: Yes
エージェントアカウントのパスワード
コントローラのアカウントアクセスキーを指定します。
環境変数:APPDYNAMICS.AGENT.ACCOUNTACCESSKEY
型:文字列
デフォルト:なし
必須:はい
エージェントのノード名
ノードの名前。
一般的に、ノード名はビジネスアプリケーションおよび物理的なホスト内で一意でなければなりません。同じ物理マシン上で複数のノードに同じノード名を使用したい場合は、ユニークホストIDのプロパティを使って複数の仮想ホストを作成します。「ユニークホスト ID」を参照してください。
環境変数:APPDYNAMICS_AGENT_NODE_NAME
型:文字列
デフォルト:なし
必須:はい
Agent Reuse Node Name
Set this environment variable to true to reuse node names in AppDynamics. When you set the property to true, you don't need to supply a node name, but you do need to provide a node name prefix using appdynamics.agent.reuse.nodeName.prefix.
This property is useful for monitoring environments where there are many CLRs with short life spans. When true, Splunk AppDynamics reuses the node names of historical CLRs for new CLRs. This avoids a proliferation of differently named nodes in Splunk AppDynamics over time, particularly when the nodes are essentially identical processes that run over different times.
Splunk AppDynamics generates a node name with App, Tier, and Sequence number. The node names are pooled. For example, the sequence numbers are reused when the nodes are purged (based on the node lifetime).
When the .NET Agent starts up, it logs output to the console until it registers with the Controller and the Controller generates the node name.
The Controller reuses node names based on the node.retention.period property.
Environment Variable: appdynamics.agent.reuse.nodeName
Type: Boolean
Default: False
Required: No
Example: Using the following environmental variable specifications, the Controller generates a node name with the prefix "reportGen". Node names will have suffixes --1, --2, and so on, depending on the number of nodes are running in parallel. The name of a node that is shut down and qualifies as a historical node may be reused by a new node.
appdynamics.agent.reuse.nodeName=true
appdynamics.agent.reuse.nodeName.prefix=reportGen
エージェントの再利用ノード名プレフィックス
環境変数:appdynamics.agent.reuse.nodeName.prefix
型:文字列
デフォルト:なし
必須:appdynamics.agent.reuse.nodeName=true の場合
例:次の環境変数の仕様を使用して、エージェントはコントローラに対して、プレフィックス「reportGen」を含むノード名を生成するように指示します。並列して実行しているノード数に応じて、ノード名には--1、 --2、などのサフィックスが付きます。
appdynamics.agent.reuse.nodeName=true
appdynamics.agent.reuse.nodeName.prefix=reportGen
エージェントのティア名
環境変数:APPDYNAMICS_AGENT_TIER_NAME
型:文字列
デフォルト:なし
必須:はい
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.
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 を設定します。
環境変数:APPDYNAMICS.AWS.INSTANCE.ENABLED
型:boolean
デフォルト:false
必須:いいえ
コントローラのホスト名
環境変数:APPDYNAMICS.CONTROLLER.HOSTNAME
型:文字列
デフォルト:なし
要否:必須。エージェントの config.xml ファイルまたはエージェント構成ユーティリティを使用して設定することもできます。
コントローラのポート番号
コントローラの HTTP(S)ポートを指定します。APPDYNAMICS.CONTROLLER.SSL.ENABLED 環境変数を true に設定した場合は、コントローラの HTTPS ポートを指定します。それ以外の場合は、HTTP ポートを指定します。
環境変数:APPDYNAMICS.CONTROLLER.PORT
タイプ:正の整数
デフォルト:8090
- オンプレミスのインストールの場合、HTTPのデフォルトはポート8090、HTTPSのデフォルトはポート8181です。
- SaaSコントローラの場合、HTTPに80またはHTTPSに443を使用。
要否:必須。エージェントの config.xml ファイルまたはエージェント構成ユーティリティを使用して設定することもできます。
コントローラSSL対応
「true」に設定すると、エージェントとコントローラ間で SSL による暗号化が可能になります。
環境変数:APPDYNAMICS.CONTROLLER.SSL.ENABLED
型:boolean
デフォルト:false
要否:オプション。エージェントの 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 に変換されます。