.NET Agent for Linux の環境変数

これは、システム環境変数を使用して設定できる .NET Agent for Linux の構成プロパティのリファレンスページです。 

Linux 環境変数では大文字と小文字が区別されますが、Windows 環境変数では区別されません。

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

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

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

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

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

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

エージェントのノード名

ノードの名前。

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

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

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

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

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

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

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

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

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

エージェントのティア名

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

分析 SSL の有効化

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

分析ホスト名

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

分析ポート

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

コンソールロガー

コンソールロガーのロギングモードを指定します。 

コントローラのホスト名

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

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

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

コントローラSSL対応 

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

コントローラ SSL Certfile

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

コントローラ SSL Certdirectory

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

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

コントローラ TLS 1.2 対応

true に設定すると、エージェントとコントローラ間で暗号化された SSL 接続のための TLS 1.2 プロトコルが有効になります。このプロパティは、「コントローラ SSL 対応」も有効になっている場合に有効になります。 

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"
			}
		}
}