.NETエージェントの構成プロパティ

このページでは、エージェントの config.xml ファイルに設定する .NET エージェントの構成プロパティについて説明します。これらのプロパティの一部は、Windows システム環境変数を使用して設定できます。詳細については、.NETエージェント環境変数を参照してください。ファイルを編集して変更を適用する方法については、「.NETエージェントの管理」を参照してください。

Environment Variables Reference

ノード、ティア、およびアプリケーション名には、エージェントの config.xml ファイルの環境変数を使用できます。環境変数を追加するには、他の文字と組み合わせができる %<variable>%, を指定して参照します。たとえば、Web-%COMPUTERNAME" は Web-HOST23 に変換されます。

Splunk AppDynamics エージェントエレメント

appdynamics-agent エレメントは、config.xml 内の構成用ルートコンテナエレメントです。

必須エレメント：

<appdynamics-agent xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">

コントローラエレメント

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

.NET Agent構成ユーティリティは、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 からのウェルカムメールを参照してください。

タイプ：文字列
デフォルト：なし
要否：要

環境変数：APPDYNAMICS.CONTROLLER.HOSTNAME

コントローラポート属性

controller port 属性ではコントローラの HTTP または HTTPS ポートを指定します。controller 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 に設定されたプロトコルを使用してコントローラへの通信を保護します。controller enable TLS 1.2 属性を true に設定して、TLS 1.2 をプロトコルリストの最初のオプションとして追加します。これはコントローラへの要求だけでなく、アプリケーションからの安全な通信すべてに影響します。

タイプ：ブール型
デフォルト：false
要否：いいえ

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

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

タイプ：ブール型
デフォルト：false
要否：いいえ

コントローラsecure属性

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

タイプ:ブール型
デフォルト:false
要否：いいえ

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

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

タイプ：ブール型
デフォルト：true
要否：いいえ

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

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

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

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

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

アプリケーション名属性

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

タイプ：文字列（環境変数も参照する場合があります）「環境変数の参照」を参照してください。
デフォルト：なし
要否：はい

環境変数：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 属性はコントローラのアカウントアクセスキーを示します。

タイプ：文字列
デフォルト：なし
要否：要

環境変数：APPDYNAMICS.AGENT.ACCOUNTACCESSKEY

プロキシエレメント

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

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

プロキシホスト属性

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

タイプ：文字列
デフォルト：なし
必須：プロキシエレメントのホストが必須

プロキシポート属性

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

タイプ：正の整数
デフォルト：なし
必須：プロキシエレメントのポートが必須

プロキシ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 属性はプロキシユーザーの名前を示します。

タイプ：文字列
デフォルト：なし
必須：認証エレメントにはユーザ名属性が必須

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

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

タイプ：文字列
デフォルト：なし
要否：いいえ

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

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

タイプ：文字列
デフォルト：なし
要否：いいえ

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

この例では、エージェントはプロキシ認証を使用して、プロキシ（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>

マシンエージェントエレメント

machine-agent エレメントは、エージェントエレメントの子エレメントです。空の machine-agent エレメントは、.NET マシンエージェントのデフォルトのインストゥルメンテーションを有効にします。「CLRのモニタリング」および「IISのモニタリング」を参照してください。

マシン エージェント エレメントの子として、オプションの追加の Microsoft パフォーマンスカウンタまたは .NET Agent instrumentor を有効にします。

必須エレメント： <machine-agent/>

マシンスナップショットエレメント

machine-snapshot エレメントは、machine-agent エレメントの子エレメントです。ご使用の環境でのマシンスナップショット用の設定を調整するのに使用します。属性を指定しない場合、エージェントはその属性用のデフォルト値を使用します。「.NETのマシンスナップショット」および「.NETのマシンスナップショットの構成」を参照してください。

任意のエレメント： <machine-snapshot enabled="true" window-size="600" samples-per-window="60" violations-per-window="6" max-percent-cpu="80" max-percent-memory="80" max-queue-item-age="100" periodic-collection="600" />

マシンスナップショットenabled属性

machine-snapshot enabled 属性を false に設定して、マシンスナップショットを無効にします。

タイプ：ブール型
デフォルト：true
要否：いいえ

<machine-agent>
   <metrics>
	<!-- Disable collection of performance metrics in general. -->
     <perf-metrics priority-level="0">
       <!-- Enable collection of individual performance metrics. -->
       <perf-metric name="Hardware Resources|CPU|%Busy"/>
       <perf-metric name="ASP.NET Applications|Errors Unhandled During Execution"/>
     </perf-metrics>
   </metrics>
 </machine-agent>

パフォーマンスカウンターエレメント

perf-counters エレメントは、machine-agent エレメントの子エレメントです。パフォーマンスカウンターすべてのコンテナとなります。

任意のエレメント： <perf-counters>

パフォーマンスカウンターエレメント

perf-counter エレメントは、perf-counters エレメントの子エレメントです。有効にするパフォーマンスカウンタのリストについては、「.NET フレームワークのパフォーマンスカウンタ」を参照してください。

任意のエレメント：<perf-counter cat="category" name="name" instance="instance"/>

パフォーマンスカウンターカテゴリ属性

perf-counter cat 属性は、パフォーマンス カウンタ カテゴリを示します。

タイプ：文字列
デフォルト：なし
要否：perf-counter エレメントにカテゴリは必須

パフォーマンスカウンター名属性

perf-counter name 属性は、パフォーマンスカウンタ名を示します。

タイプ：文字列
デフォルト：なし
要否：perf-counter エレメントに名前は必須

パフォーマンスカウンターインスタンス属性

perf-counter instance 属性は、パフォーマンス カウンタ インスタンス値です。

タイプ：文字列
デフォルト：なし
要否：perf-counter エレメントにインスタンスは必須

パフォーマンスカウンターを使用したマシンエージェント構成のサンプル

  <machine-agent>
    <!-- Additional machine level Performance Counters -->
    <perf-counters>
      <perf-counter cat="Network Interface" name="Bytes Sent" instance="Local Area Connection"/>
    </perf-counters>
  </machine-agent>

インストゥルメンテーションエレメント

instrumentation エレメントは、machine-agent エレメントの子エレメントです。これにより、追加の .NET Agent instrumentor（スレッド関連付け、.NET Remoting の関連付けなど）を有効にできます。

任意のエレメント： <instrumentation>

Instrumentor エレメント

instrumentor エレメントは、instrumentation エレメントの子エレメントです。instrumentor エレメントは、導入する .NET Agent instrumentor を指定します。

任意のエレメント：<instrumentor name="instrumentor name" enabled="true"/>/>

instrumentor名属性

instrumentor name 属性は、instrumentor の名前を示します。

タイプ：文字列
デフォルト：なし
必須：Instrumentor エレメントに名前は必須。

Instrumentor enabled属性

インストゥルメンテーションを有効にするには、instrumentor enabled 属性を true に設定します。

タイプ：ブール型
デフォルト：false
要否：いいえ。

現在の構成の構文は enabled="true" です。バージョン3.7.8以前ではdisabled="false"が使用されます。

スレッド相関Instrumentorを使用したマシンエージェント構成のサンプル

 <machine-agent>
    <!--Enable thread correlation-->
    <instrumentation>
      <instrumentor name="ThreadCorrelationThreadPoolCLR2Instrumentor" enabled="true"/>
      <instrumentor name="ThreadStartCLR2Instrumentor" enabled="true"/>
      <instrumentor name="ThreadStartCLR4Instrumentor" enabled="true"/>
    </instrumentation>
  </machine-agent>

追加の .NET Agent Instrumentor

• 次を参照してください。 .NETのスレッドの関連付け
• 次を参照してください。 .NET Remotingの関連付けを有効化
• 次を参照してください。WCFデータサービスのインストゥルメンテーションの有効化

アプリケーションエージェントエレメント

app-agents エレメントは、agent エレメントの子エレメントです。IISアプリケーション、Windowsサービス、スタンドアロンアプリケーションのアプリケーションエージェント構成のコンテナです。

必須エレメント： <app-agents enabled="true">

アプリケーションエージェントenabled属性

サーバーでアプリケーション モニタリングを無効にするには、app-agents enabled 属性を false に設定します。

タイプ：ブール型
デフォルト：true
要否：いいえ

デフォルトプロファイラエレメント

デフォルトの profiler エレメントは、app-agents エレメントの子エレメントです。マシン上のすべてのインストゥルメント化された .NET アプリケーション（IIS アプリケーション、アプリケーションプール、Windows サービス、スタンドアロン アプリケーション）のデフォルトプロファイラ動作のカスタマイズを定義します。

任意のエレメント：<profiler>

プロファイラ - Disabled Featuresエレメント

disabled-features エレメントは、profiler エレメントの子エレメントです。セキュリティまたはプライバシー上の理由からエージェントレベルでデータ収集メカニズムを無効化するために、このプロパティを使用します。この構成は、コントローラが設定する構成をオーバーライドします。

オプションのエレメント: <disabled-features value="NONE"/>

Disabled features値属性

disabled-features value 属性は、無効にする機能のカンマ区切りのリストです。利用可能な値は以下の通り。

• LOG_PAYLOAD：log-request-payload ノードプロパティをオーバーライドし、ロギング HTTP リクエストペイロードを抑制する。
• RAW_SQL：capture-raw-sql ノードプロパティをオーバーライドし、Raw SQL 出力のロギングを抑制する
• CUSTOM_EXIT_SNAP_DATA: カスタムイグジットポイントからのスナップショットデータを抑制する
• METHOD_INV_DATA_COLLECTOR: メソッド呼び出しデータコレクターのユーザーデータを抑制する
• HTTP_DATA_COLLECTOR: HTTPリクエストデータコレクターのユーザーデータを抑制する
• INFO_POINT：インフォメーションポイントメトリックを抑制する
• ALL: 利用可能な機能をすべて無効化する
• NONE: 機能を無効化しない

タイプ：文字列
デフォルト：なし
要否：いいえ

プロファイラ - 正常イグジットコードエレメント

successful-exit-code エレメントは、profiler エレメントの子エレメントです。デフォルトの正常イグジットコードは、WindowsサービスまたはスタンドアロンアプリケーションにとってCLR再起動イベントが正常であったかどうか、エージェントがフラグをたてる可否判断を行います。この構成は IIS には適用されません。 

任意のエレメント：<successful-exit-code value="0"/>

正常イグジットコード値属性

タイプ：整数
デフォルト：0
要否：いいえ

プロファイラ - ランタイムリインストゥルメンテーションエレメント

runtime-reinstrumentation エレメントは、profiler エレメントの子エレメントです。このプロパティを使用してランタイムリインストゥルメンテーションを構成します。次を参照してください。.NETのランタイムリインストゥルメンテーションを構成

任意のエレメント：<runtime-reinstrumentation enabled="true" interval="60000" optimize="true" />

ランタイムリインストゥルメンテーションenabled属性

ランタイム リインストゥルメンテーションを有効にするには、true に設定します。

タイプ：ブール型
デフォルト：false
要否：いいえ

ランタイムリインストゥルメンテーション間隔属性

ランタイムリインストゥルメンテーションを開始する構成の更新をエージェントが確認する頻度（ミリ秒単位）。

タイプ：整数
デフォルト：60000 ミリ秒
最小：ランタイム リインストゥルメンテーションではシステムオーバーヘッドが若干増えるため、Splunk AppDynamics では最小の間隔として 1 分または 60000 ミリ秒を推奨。
要否：いいえ

デフォルトプロファイラ構成のサンプル

<app-agents>
    <profiler>
      <disabled-features value="LOG_PAYLOAD,RAW_SQL,CUSTOM_EXIT_SNAP_DATA"/>
	  <!-- Set the successful exit code for Windows services and standalone applications to "1." -->
      <successful-exit-code value="1"/>
      <!-- Enable Runtime reinstrumentation -->
      <runtime-reinstrumentation enabled="true" interval="60000"/>
    </profiler>
...
</app-agents>

アプリケーションエージェント - IISエレメント

IIS エレメントは、app-agents エレメントの子エレメントです。IISアプリケーションの構成には3つのオプションがあります。

• 自動構成
• アプリケーションプール構成
• アプリケーション構成

アプリケーションプールの設定は、各アプリケーションが固有の構成を持っていない限り、アプリケーションプール内のアプリケーションすべてに適用されます。

明示的な子レベルの構成は親レベルの構成をオーバーライドします。それ以外は、子が親の構成を引き継ぎます。

任意のエレメント： <IIS>

子アプリケーションの除外属性

デフォルトでは、IIS アプリケーションをインストゥルメント化すると、.NET エージェントは子アプリケーションをインストゥルメント化し、親と同じティアに割り当てます。エージェントが子アプリケーションを自動的にインストゥルメント化しないようにするには、exclude-child-applications を true に設定します。例：<IIS exclude-child-applications="true">

子アプリケーションのインストゥルメンテーションを全体的に無効化している場合は、IIS アプリケーションエレメントを使用して特定の子アプリケーションのインストゥルメント化を実行できます。

タイプ：ブール型
デフォルト：false
要否：いいえ

IIS自動インストゥルメンテーションエレメント

automatic エレメントは、IIS エレメントの子エレメントです。automatic エレメントを使用して、すべての IIS アプリケーションの自動インストゥルメンテーションを有効または無効にします。自動インストゥルメンテーションと手動インストゥルメンテーションの両方を構成できます。手動構成は自動構成をオーバーライドします。

任意のエレメント： <automatic enabled="false" />

自動enabled属性

すべての IIS アプリケーションのインストゥルメンテーションを有効にするには、automatic enabled 属性を true に設定します。これは、.NET エージェント構成ユーティリティの自動構成オプションを使用する場合のデフォルト設定です。すべての IIS アプリケーションの自動インストゥルメンテーションを無効にするには、値を false に設定します。

タイプ：ブール型
デフォルト：true
要否：いいえ

IISアプリケーション名enabled属性

デフォルトでは、エージェントは IIS アプリケーション名を報告しません。CLR メタデータ内の IIS アプリケーション名を表示するには、iis-application-name-enabled 属性を true に設定します。たとえば、<automatic iis-application-name-enabled="true" /> のようになります。有効にすると、名前が CLR メタデータの  iis-application-name 値として表示されます。

タイプ：ブール型
デフォルト：false
要否：いいえ

IISアプリケーションプールエレメント

IIS application pools エレメントは、IIS エレメントの子エレメントです。インストゥルメンテーションのために構成するIISアプリケーションプールすべてのコンテナエレメントです。
任意のエレメント：<application-pools>

IISアプリケーションプールエレメント

application-pool エレメントは、application-pools エレメントの子エレメントです。名前属性で区別される複数のアプリケーションプールエレメントが存在する場合があります。アプリケーションプールエレメントを使用して、アプリケーションプール内の全アプリケーションのアプリケーションエージェントを構成します。IIS アプリケーションプールの詳細については、「IIS でのアプリケーションプールの管理」を参照してください。

IISアプリケーションエレメントのアプリケーション固有の構成は、アプリケーションプール構成をオーバーライドします。

任意のエレメント： <application-pool name="DefaultAppPool" enabled="false">

アプリケーションプール名属性

application-pool name 属性は、IIS アプリケーションプールの名前を示します。

タイプ：文字列
デフォルト：なし
必須：application-pool エレメントに名前は必須。

アプリケーションプールenabled属性

アプリケーションプール内のすべてのアプリケーションのインストゥルメンテーションを無効にするには、application-pool enabled 属性を false に設定します。アプリケーション プール内のすべてのアプリケーションをインストゥルメント化するには、値を true に設定します。

タイプ：ブール型
デフォルト：なし。指定されていない場合、デフォルトは true です。
要否：いいえ

アプリケーションプール ティア エレメント

tier エレメントは、application-pool エレメントの子エレメントです。アプリケーションプールのインストゥルメンテーションを有効にする場合は、コントローラで tier エレメントを使用して、プールのアプリケーションをティアに割り当てる必要があります。「アプリケーションモニタリングの概要」を参照してください。

必須エレメント： <tier name="Inventory" />

ティア名属性

tier name 属性を使用してティアを指定します。

タイプ：文字列（環境変数も参照する場合があります）「環境変数の参照」を参照してください。
デフォルト：なし
要否：はい

IISアプリケーションエレメント

IIS applications エレメントは、IIS エレメントの子エレメントです。インストゥルメンテーション用に構成するIISアプリケーションすべてのコンテナエレメントです。
任意のエレメント： <applications>

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

application エレメントは、applications エレメントの子エレメントです。複数のアプリケーションエレメントを使用して様々なサイトやアプリケーションをインストゥルメント化します。IIS サイトやアプリケーションについては、「IIS 7 以降のサイト、アプリケーション、仮想ディレクトリについて」を参照してください。

任意のエレメント： <application path="/" site="FirstSite" port="8008"site-regex="false">

アプリケーションサイト属性

application site 属性は、アプリケーションの IIS 内のルートサイトを示します。Windows Azure でサイト名の一部しかわからない場合、サイト名には正規表現を使用できます。正規表現を使用する場合は、Application site-regex 属性を true に設定します。

タイプ：文字列
デフォルト：なし
必須：アプリケーションエレメントにサイトは必須。

アプリケーションsite-regex属性

Application site 属性の値を正規表現として扱うには、application site-regex 属性を true に設定します。

タイプ：ブール型
デフォルト：false
要否：いいえ

アプリケーションパス属性

application path 属性は、ルートサイトを基準としたアプリケーションのパスを示します。フォワードスラッシュを使用して、ルートサイトを示し、すべての子アプリケーションのインストゥルメンテーションを行います。アプリケーションへのパスを使用すると、特定のアプリケーションと子のインストゥルメンテーションを行うことができます。

たとえば、Site1 は 2 つのアプリケーション AppX と AppY をホストするとします。Site 1、AppY および AppZ をインストゥルメント化するには、パスを「/」に設定します。AppY はインストゥルメント化し、AppZ はインストゥルメント化しない場合は、パスを /AppY に設定します。

タイプ：文字列
デフォルト：/
必須：application エレメントに path は必須。

アプリケーションポート属性

IIS 6 の 2 つ以上のサイトに同じサイト名がある場合は、site port 属性を設定してサイトを区別します。

タイプ：正の整数
デフォルト:なし
要否：いいえ

アプリケーションenabled属性

親アプリケーションのインストゥルメンテーションは有効にしても、子アプリケーションについては、無効にする必要がある場合があります。この場合、無効にする子アプリケーションの application エレメントを作成し、application enabled 属性を false に設定します。

タイプ：ブール型
デフォルト：true
要否：いいえ

アプリケーション ティア エレメント

tier エレメントは、application エレメントの子エレメントです。アプリケーションのインストゥルメンテーションを有効にする場合は、コントローラで tier エレメントを使用して、アプリケーションをティアに割り当てる必要があります。「アプリケーションモニタリングの概要」を参照してください。

必須エレメント： <tier name="Consumer" />

ティア名属性

tier name 属性は、ビジネス アプリケーション ティアを示します。

タイプ：文字列（環境変数も参照する場合があります）「環境変数の参照」を参照してください。
デフォルト：なし
要否：はい

IISアプリケーション構成のサンプル

    <IIS>
      <!-- Automatic instruments all IIS applications when enabled. -->
      <automatic enabled="false"/>

      <!-- Application Pool agent configurations -->
      <application-pools>
        <!-- Do not instrument applications in DefaultAppPool when "enabled" attribute is set to false. -->
        <application-pool name="DefaultAppPool" enabled="false">
          <tier name="Tier Name"/>
        </application-pool>

        <!-- Instrument applications in the OtherAppPpool and assign them to the Inventory tier. -->
        <application-pool name="OtherAppPool">
          <tier name="Inventory"/>
        </application-pool>
      </application-pools>
      <applications>
        <!-- Instrument all applications in the First Site. -->
        <application path="/" site="FirstSite">
          <tier name="Order"/>
        </application>
        <!-- Instrument the /app application and child apps in the Second Site -->
        <!-- but not the root Second Site application. -->
        <application path="/app" site="SecondSite">
          <tier name="Consumer"/>
        </application>
        <!-- Regular expression for site name -->
        <!-- assigns all sites beginning with "MyRole" to the Credit Services tier. -->
        <application path="/" site="MyRole_\w+" site-regex="true">
            <tier name="Credit Services"/>
        </application>
        
      </applications>
    </IIS>

アプリケーションエージェント - スタンドアロンアプリケーションエレメント

standalone-applications エレメントは、app-agents エレメントの子エレメントです。インストゥルメンテーション用に構成する Windows サービスおよびスタンドアロン アプリケーションのコンテナエレメントです。次を参照してください。 Windowsサービスとスタンドアロンアプリケーションの.NETエージェントの構成

任意のエレメント： <standalone-applications>

スタンドアロンアプリケーションエレメント

standalone-application エレメントは、standalone-applications エレメントの子エレメントです。インストゥルメンテーションを行うWindowsサービスまたはスタンドアロンアプリケーションを指定します。

任意のエレメント： <standalone-application executable="MyWindowsApplication.exe" command-line="">

スタンドアロンアプリケーション実行ファイル属性

standalone-application executable 属性でインストゥルメント化する Windows アプリケーションのファイル名を指定します。スタンドアロン アプリケーション エレメントの実行可能属性を次のいずれかに設定します。

• 実行可能ファイル名：MyStandaloneApp.exe や MyWindowsService.exe など。ファイル拡張子はオプションであるため MyStandaloneApp も同様に機能します。

• 実行可能ファイルへのフルパス：C:\Program Files\MyApplication\MyStandaloneApp.exe など
• 実行可能ファイルへの部分パス：MyApplication\MyStandaloneApp.exe など。異なるパスから実行している同じ実行可能ファイルのインスタンスごとに異なるティアを割り当てる場合は、実行可能ファイルへの完全パスまたは部分的なパスを使用。

タイプ：文字列
デフォルト：なし
要否：要

スタンドアロンアプリケーションコマンドライン属性

同じ実行可能ファイルの 2 つのインスタンスを区別するには、standalone-application command-line 属性でアプリケーションのコマンドラインの独自の部分（引数など）を指定します。

タイプ：文字列
デフォルト：なし
要否：いいえ 

スタンドアロンアプリケーションapp-domain-name属性

複数のアプリケーションドメインを持つアプリケーションの場合、app-domain-name 属性を使用してインストゥルメンテーションを特定のアプリケーションドメインに制限できます。次を参照してください。 アプリケーションドメインモニタリングの構成

タイプ：文字列
デフォルト：なし
要否：いいえ

スタンドアロンアプリケーション ティア エレメント

tier エレメントは、standalone-application エレメントの子エレメントです。アプリケーションのインストゥルメンテーションを有効にする場合は、コントローラで tier エレメントを使用して、アプリケーションをティアに割り当てる必要があります。「アプリケーションモニタリングの概要」を参照してください。

必須エレメント： <tier name="Consumer" />

ティア名属性

tier name 属性は、ビジネス アプリケーション ティアを示します。

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

環境変数：APPDYNAMICS.AGENT.TIERNAME

Windowsサービスとスタンドアロンアプリケーション構成のサンプル

    <standalone-applications>
      <standalone-application executable="ExampleApplication.exe">
        <tier name="Standalone Application Tier"/>
      </standalone-application>
      <!-- Instrument a Windows service using arguments. -->
      <!-- The following example matches the command "MyWindowsService.exe -d -x -r". -->
      <standalone-application executable="MyWindowsService.exe" command-line="-x">
        <tier name="Windows Service Tier"/>
      </standalone-application>
    </standalone-applications>