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

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

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

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

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

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

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

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

タイプ：boolean

デフォルト：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 でのアプリケーションプールの管理」を参照してください。

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

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

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

タイプ：文字列

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

必須：application-pool エレメントに名前は必須。

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

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

型：ブール型

デフォルト：[None]。指定されていない場合、デフォルトの true に設定されます。

必須：いいえ

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

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

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

ティア名属性

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

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

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

要否: 要

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 に設定します。

タイプ：文字列

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

必須：アプリケーションエレメントにサイトは必須。

アプリケーション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 属性を設定してサイトを区別します。

タイプ：正の整数

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

必須：いいえ

アプリケーションenabled属性

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

型：ブール型

デフォルト：true

必須：いいえ

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

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

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

ティア名属性

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

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

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

要否: 要

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>