アプリケーションエージェント - IISエレメント
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-pools 要素の子要素です。アプリケーションプールのインストルメンテーションを有効にする場合は、コントローラで 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 属性の値を正規表現No Content found for /db/organizations/splunk/repositories/appdsaas-25_7_0/content/documents/http:/msdn.microsoft.com/en-us/library/hs600312(v=vs.110).ditaとして扱うには、application site-regex 属性を true に設定します。
型:ブール型
デフォルト:false
必須:いいえ
アプリケーションパス属性
application path 属性は、ルートサイトを基準としたアプリケーションのパスを示します。フォワードスラッシュを使用して、ルートサイトを示し、すべての子アプリケーションのインストルメンテーションを行います。アプリケーションへのパスを使用すると、特定のアプリケーションと子のインストルメンテーションを行うことができます。
たとえば、Site1 は 2 つのアプリケーション AppX と AppY をホストするとします。Site 1、AppY、および AppZ をインストルメント化するには、パスを「/」に設定します。AppY はインストルメント化し、AppZ はインストルメント化しない場合は、パスを /AppY に設定します。
タイプ:文字列
デフォルト:/
必須:application 要素にパスは必須。
アプリケーションポート属性
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>