.NET Agent for Linux の環境変数

このトピックは、システム環境変数を使用して設定できる .NET Agent for Linux の構成プロパティの参考資料です。 

エージェントのアカウント名

SaaSまたはマルチテナントコントローラのアカウント名を指定します。

エージェントのアプリケーション名

コントローラで使用するビジネスアプリケーションを指定します。アプリケーション名が存在しない場合、エージェントが登録された時にコントローラがそれを作成します。次を参照してください。アプリケーションモニタリングの概要

エージェントアカウントのパスワード  

コントローラのアカウントアクセスキーを指定します。 

エージェントのノード名

ノードの名前。

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

エージェントの再利用ノード名

この環境変数をtrueに設定し、AppDynamicsでノード名を再利用する。プロパティが true の場合、ノード名を指定する必要はありませんが、APPDYNAMICS_AGENT_REUSE_NODE_NAME_PREFIX を使用してノード名プレフィックスを指定する必要があります。

このプロパティは、寿命が短い CLR が多数ある環境のモニタリングに役立ちます。true の場合、AppDynamics は新しい CLR の過去の CLR のノード名を再利用します。ノード名を再利用すると、本質的には同一プロセスのノードが異なる時間で実行される場合に、AppDynamics 内で別の名前が付いたノードが時間の経過とともに急増するのを回避できます。 

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

.NET Agent for Linux は起動時に、コントローラに登録され、コントローラがノード名を生成するまで、出力をコンソールに記録します。 

コントローラはノード名を node.retention.period プロパティに基づいて再利用します。「履歴ノードと切断ノード」を参照してください。

エージェントの再利用ノード名プレフィックス

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

エージェントのティア名

この .NET ノードが属するティアの名前を指定します。これはアプリケーションサーバ上のデプロイメント名ではないことにご注意ください。

分析 SSL の有効化

.NET Agent for Linux が SSL 経由で Analytics エージェントにデフォルトのトランザクションデータを送信するかどうかを指定します。

分析ホスト名

分析ホスト名のホスト名または IP アドレスを指定します。

分析ポート

分析ポートのポート番号を指定します。

コントローラのホスト名

AppDynamics コントローラのホスト名または IP アドレスを指定します。オンプレミスのコントローラの場合、コントローラをインストールした時に構成したアプリケーションサーバーホスト名の値を使用します。AppDynamics SaaS コントローラを使用する場合は、コントローラの名前について、AppDynamics からの Welcome メールを参照してください。 

コントローラのポート番号

AppDynamics コントローラの HTTP ポートを指定します。APPDYNAMICS.CONTROLLER.SSL.ENABLED 環境変数が true に設定されている場合は、コントローラの HTTPS ポートを指定します。それ以外の場合は、HTTP ポートを指定します。 

コントローラSSL対応 

true に設定すると、エージェントとコントローラ間で SSL による暗号化が可能になります。

コントローラ SSL Certfile

SSL 対応コントローラへの接続に使用される証明書ファイルを含むフォルダへのパス。

コントローラ SSL Certdirectory

SSL 対応コントローラへの接続に使用される証明書ディレクトリを含むフォルダへのパス。

証明書ディレクトリの値は、証明書ファイル（APPDYNAMICS_CONTROLLER_SSL_CERTFILE）を入力しない場合にのみ有効です。 

HTTP プロキシ ホスト（HTTP Proxy Host）

プロキシホストの名前。

HTTP プロキシ ポート（HTTP Proxy Port）

プロキシのポート番号。

HTTP プロキシユーザ

プロキシに接続するユーザの名前。

HTTP プロキシパスワード

プロキシに接続するユーザのパスワード。

エージェント構成ファイルのサンプル

以下の環境変数は、AppDynamicsConfig.json ファイルで設定できます。

• APPDYNAMICS_CONTROLLER_HOST_NAME
• APPDYNAMICS_CONTROLLER_PORT
• APPDYNAMICS_CONTROLLER_SSL_ENABLED
• APPDYNAMICS_CONTROLLER_SSL_CERTFILE
• APPDYNAMICS_CONTROLLER_SSL_CERTDIR

次のサンプルファイルに、これらの変数の設定方法を示します。

"controller":
{
   "host": "ControllerHost",
    "port": 8181,
     "account": "customer1",
      "password": "test",
       "ssl": true,
       "certdir": "/opt/appdynamics/dotnet/conf/",
       "certfile": "/opt/appdynamics/dotnet/conf/cacerts.pem",
        "enable_tls12": true,
        "proxy":
		{
			"host" : "proxy",
			"port" :900,
			"authentication" :
			{
				"username" : "user",
				"domain"  : "domainname",
				"password" :"pwd"
			}
		}
}