コントローラエレメント

controller エレメントは appdynamics-agent エレメントの子エレメントです。これにより、コントローラの接続情報を指定します。

注: .NET エージェント構成ユーティリティは、1 台のサーバーにつき 1 つのコントローラの構成のみをサポートしています。

必須エレメント：

<controller host="mycontroller.mycompany.com" port="8090" ssl="false" enable_tls12="false" high_availability="false" secure="false" enable_config_deployment="true"

コントローラホスト属性

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

タイプ：文字列

デフォルト：[なし（None）]

要否: 要

環境変数：APPDYNAMICS.CONTROLLER.HOSTNAME

コントローラポート属性

controller port 属性ではコントローラの HTTP または HTTPS ポートを指定します。コントローラ の ssl 属性が true に設定されている場合は、コントローラの HTTPS ポートを指定します。それ以外の場合は HTTP ポートを指定します。

タイプ：正の整数

デフォルト：8090

  • オンプレミスのインストールの場合、HTTPのデフォルトはポート8090、HTTPSのデフォルトはポート8181です。
  • SaaSコントローラの場合、HTTPに80またはHTTPSに443を使用。

要否: 要

環境変数：APPDYNAMICS.CONTROLLER.PORT

コントローラSSL属性

エージェントとコントローラ間で SSL による暗号化を有効にするには、コントローラ ssl 属性を true に設定します。

型：ブール型

デフォルト：false

必須：いいえ

環境変数：APPDYNAMICS.CONTROLLER.SSL.ENABLED

コントローラ enable TLS 1.2 属性

SSL を有効化すると、エージェントはアプリケーションで ServicePointManager.SecurityProtocol に設定されたプロトコルを使用してコントローラへの通信を保護します。コントローラ enable TLS 1.2 属性を true に設定して、TLS 1.2 をプロトコルリストの最初のオプションとして追加します。これはコントローラへの要求だけでなく、アプリケーションからの安全な通信すべてに影響します。

型：ブール型

デフォルト：false

必須：いいえ

コントローラ高可用性属性

高可用性（HA）に対応してコントローラを設定している場合は、コントローラの high availability 属性を true に設定します。

型：ブール型

デフォルト：false

必須：いいえ

コントローラsecure属性

ログイン情報を暗号化するように .NET エージェントを設定した場合、MSI インストーラパッケージは controller secure 属性を自動的に true に設定します。controller secure が true の場合、.NET エージェントは Account エレメントまたは Proxy エレメントのログイン情報を無視し、Windows Credential Store のログイン情報を使用します。「.NETエージェント構成の認証情報の暗号化」を参照してください。

型：ブール型

デフォルト：false

必須：いいえ

コントローラが有効にする構成デプロイメント属性

デフォルトでは、.NET エージェントによりコントローラからの config.xml に対する構成の更新がチェックされます。コントローラの config.xml 構成ファイルでエージェントを無効にする場合は、controller enable config deployment 属性を false に設定します。.NET構成の管理 .NET構成の管理

型：ブール型

デフォルト：true

必須：いいえ

コントローラアプリケーションエレメント

controller application エレメントは、controller エレメントの子エレメントです。コントローラ インターフェイス内に表示される論理ビジネスアプリケーションの名前を示しています。

.NET エージェント構成ユーティリティは、1 つのサーバーにつき 1 つのビジネスアプリケーションをサポートしています。複数のアプリケーションをサポートするには、次のいずれかの方法を使用します。

  • ティアを使用して単一サーバーでインストゥルメント化するさまざまなアプリケーションを整理する。
  • または、複数のビジネスアプリケーションのサポートを手動で構成します。 「.NETの複数ビジネス アプリケーション サポートの構成」を参照してください。
    注: 複数のアプリケーションサポートには、<applications> コンテナエレメントを含むさまざまな構成エレメントが必要です。

必須エレメント：<application name="MyDotNetApplication"/>

アプリケーション名属性

application name 属性をコントローラのビジネスアプリケーション名に設定します。アプリケーション名が存在しない場合、エージェントが登録された時にコントローラがそれを作成します。config.xml 内のインストゥルメント化されたすべてのアプリケーションは、コントローラで同じビジネスアプリケーションに登録されます。「アプリケーションモニタリングの概要」を参照してください。

タイプ：文字列（環境変数も参照する場合があります）「環境変数の参照」を参照してください。

デフォルト：[なし（None）]

要否: 要

環境変数： APPDYNAMICS.AGENT.APPLICATIONNAME

注: アプリケーション エージェント エレメントの個々のアプリケーションにティアを指定します。

アカウントエレメント

account エレメントは、controller エレメントの子エレメントです。コントローラをマルチテナントモードで実行する場合、または SaaS コントローラを使用する場合は、アカウント名を指定します。シングルテナントアカウントの場合、デフォルトのアカウント名は customer1 です。SaaS コントローラを使用する場合、アカウント名は Splunk AppDynamics からのウェルカムメールで通知されます。

エージェントは、コントローラで認証するパスワードとしてアカウントアクセスキーを使用する必要があります。シングルテナントアカウントの場合、コントローラの [設定（Settings）] > [ライセンス（License）] でアクセスキーを確認できます。SaaS コントローラを使用する場合、アカウントアクセスキーは Splunk AppDynamics からのウェルカムメールで通知されます。

必須エレメント：<account name="mycompany" password="myaccesskey"/>

アカウント名属性

account name 属性は SaaS またはマルチテナントコントローラのアカウント名を示します。

タイプ：文字列

デフォルト：シングルテナント コントローラの場合、アカウント名を指定しないと、エージェントはデフォルトの「customer1」と見なします。

必須：SaaS コントローラまたはマルチテナントコントローラの場合のみ。

環境変数：APPDYNAMICS.AGENT.ACCOUNTNAME

アカウントパスワード属性

account password 属性はコントローラのアカウントアクセスキーを示します。

タイプ：文字列

デフォルト：[なし（None）]

要否: 要

環境変数：APPDYNAMICS.AGENT.ACCOUNTACCESSKEY

プロキシエレメント

proxy エレメントは、controller エレメントの子エレメントです。これを使用して、プロキシサーバー経由でコントローラへの認証なしの接続を構成します。

任意のエレメント：<proxy host="proxy-name" port="3128" enabled="true"/>

プロキシホスト属性

proxy host 属性はプロキシサーバーのホスト名または IP アドレスを示します。

タイプ：文字列

デフォルト：[なし（None）]

必須：proxy エレメントにはホストが必要。

プロキシポート属性

proxy port 属性はプロキシサーバーポートを示します。

タイプ：正の整数

デフォルト：[なし（None）]

必須：proxy エレメントにはポートが必要。

プロキシenabled属性

プロキシサーバーを介したコントローラアクセスを有効にするには、proxy enabled 属性を true に設定します。

型：ブール型

デフォルト：true

必須：いいえ

プロキシ - 認証エレメント

authentication エレメントは、proxy エレメントの子エレメントです。authentication エレメントを使用して、プロキシ認証を有効にし、プロキシサーバーのログイン情報を指定します。セキュリティポリシーがディスクに保存されたログイン情報を保護するよう要求する環境では、ログイン情報を暗号化し、Windows 資格情報マネージャに保存できます。

任意のエレメント：<authentication enabled="true" user_name="my_proxy_user" password="password" domain="my_windows_domain"/>

プロキシ認証enabled属性

proxy authentication enabled 属性を true に設定して、エージェントがログイン情報をプロキシサーバーに送信するように設定します。

型：ブール型

デフォルト：false

必須：いいえ

プロキシ認証ユーザー名属性

proxy authentication username 属性はプロキシユーザーの名前を示します。

タイプ：文字列

デフォルト：[なし（None）]

必須：authentication エレメントには username 属性が必須

プロキシ認証パスワード属性

proxy authentication password 属性は、プロキシユーザーのパスワードを示します。

タイプ：文字列

デフォルト：[なし（None）]

必須：いいえ

プロキシ認証ドメイン属性

proxy authentication domain 属性でユーザー名を認識するドメインまたはレルムを指定します。ホストコンピュータ名、Active Directory ドメイン、または DNS ドメインを指定できます。

タイプ：文字列

デフォルト：[なし（None）]

必須：いいえ

プロキシ認証が有効なコントローラの構成例

この例では、エージェントはプロキシ認証を使用して、プロキシ（myproxy.example.com）経由でコントローラにアクセスします。.NET エージェントは、ログイン情報 MyProxyUser@mydomain.com とパスワード password を使用してプロキシサーバーにアクセスします。

  <controller host="mycontroller.example.com">
    <application name="MyDotNetApplicaition" />
    <proxy host="myproxy.example.com" port="3128" enabled="true">
       <authentication enabled="true" user_name="MyProxyUser" password="password" domain="mydomain.com"/>
    </proxy>
  </controller>