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

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

マシンエージェントエレメントの子として、オプションの追加の Microsoft パフォーマンスカウンタまたは 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 属性をに設定して、マシンスナップショットを無効にします。

型：ブール型

デフォルト：true

必須：いいえ

マシンスナップショット時間枠属性

.NET マシンエージェントがサンプルを取得するための時間枠サイズの時間範囲を秒単位で指定します。時間枠内でエージェントはサンプルを取得し、それらを違反しきい値（max percent CPU、max percent memory、max queue item age）でチェックします。

型：整数

デフォルト：600

必須：いいえ

時間枠ごとのマシンスナップショットサンプル属性

指定された時間枠内で、.NETマシンエージェントが取得するサンプルの数を指定する。たとえば、window size が 600 で samples per window が 60 の場合、エージェントは 10 秒に 1 回サンプルを取得します。

型：整数

デフォルト：60

必須：いいえ

時間枠ごとのマシンスナップショット違反属性

.NET マシンエージェントが、あるしきい値について時間枠あたりの違反数を検出すると、スナップショットが取得されます。エージェントは、違反があったしきい値について時間枠あたり 1 つのスナップショットを取得します。たとえば、violations per window が 6 に設定されていて、6 つのサンプルが 80% 以上のメモリ使用率を示している場合、エージェントはスナップショットを作成します。各しきい値のカウンタは独立しています。

型：整数

デフォルト：6

必須：いいえ

マシンスナップショット最大メモリ使用率属性

.NET マシンエージェントが、マシンで max percent memory 値以上のメモリ使用率を検出した場合、そのサンプルに違反としてフラグを立てます。最小値は 20 です。最大値は 100 です。

型：整数

デフォルト：80

必須：いいえ

マシンスナップショット最大 CPU 使用率属性

.NET マシンエージェントが、マシンで max percent cpu 値以上の CPU 使用率を検出した場合、そのサンプルに違反としてフラグを立てます。最小値は 20 です。最大値は 100 です。

型：整数

デフォルト：80

必須：いいえ

マシンスナップショットキューアイテム最大経過時間属性

.NET マシンエージェントが、IIS キューで max queue item age 値以上の最も時間が経過したアイテムを検出した場合、そのサンプルに違反としてフラグを立てます。

型：整数

デフォルト: 100

必須：いいえ

マシンスナップショット定期的収集属性

.NETマシンエージェントは、定期的な収集時間範囲毎に1つのスナップショットを取得します。値を秒単位で指定します。最小値は60秒です。

型：整数

デフォルト：600

必須：いいえ

CLRクラッシュレポートエレメント

clrcrash-reporting エレメントは、machine-agent エレメントの子エレメントです。clrcrash-reporting エレメントを使用して、.NET マシンエージェントがコントローラに CLR クラッシュイベントを報告するかどうかを制御します。CLRクラッシュのモニタリングCLRクラッシュのモニタリング

任意のエレメント： <clrcrash-reporting enabled="true"/>

CLRクラッシュレポートenabled属性

clrcrash-reporting enabled 属性をに設定して、コントローラへの CLR クラッシュイベントの報告を停止します。

型：ブール型

デフォルト：true

必須：いいえ

プロセスのモニタリングエレメント

process-monitor エレメントは、machine-agent エレメントの子エレメントです。デフォルトでは、エージェントはすべての IIS プロセスにプロセスモニタリングを有効にします。

任意のエレメント：<process-monitor report-all-iis-processes="true"/>

すべてのIISプロセスを報告するプロセスのモニタリング属性

report-all-iis-processes 属性をに設定して、インストゥルメント化された IIS プロセスについてのみプロセスモニタリングを有効にします。

型：ブール型

デフォルト：true

必須：いいえ

メトリックエレメント

エレメントは、エレメントの子エレメントです。デフォルトでは、マシンエージェントは最大 200 個のメトリックを登録します。エレメントを使用して、.NET マシンエージェントが登録できるメトリックの数を増やします。メトリックの制限

メトリック登録制限を増やす場合は注意してください。この制限を増やすと、エージェントとコントローラのリソースオーバーヘッドが増える場合があります。

任意のエレメント：<metrics max-metrics="200"/>

メトリックmax-metrics属性

.NET マシンエージェントが登録できるメトリックの最大数を指定します。

型：整数

デフォルト: 200

必須：いいえ

Perf-metricsエレメント

エレメントは、エレメントの子エレメントです。デフォルトでは、マシンエージェントによってパフォーマンスメトリックの完全なセットが収集され、報告されます。パフォーマンスメトリックの優先度レベルを変更して、エージェントが収集するメトリックを制限し、それによってエージェントのオーバーヘッドを減らすことができます。メトリックとその優先順位の完全なリストについては、「Windows 評価指標の管理」を参照してください。

任意のエレメント： <perf-metrics priority-level="3">

Perf-metrics priority-level エレメント

収集するマシンエージェントのパフォーマンスメトリックのセットを次のように指定します。

0 - メトリック収集の無効化
1 - 優先度の高いメトリックのみを収集
2 - 優先度が高～中程度のメトリックを収集
3 - すべてのメトリック（優先度が高い、中程度、低い）を収集

型：0 ～ 3 の範囲の整数

デフォルト：3

要否：perf-metrics エレメントを使用する場合は必須。

Perf-metricエレメント

エレメントは、エレメントの子エレメントです。パフォーマンスメトリックの一般的な収集を無効にするために優先度をに設定した場合、エレメントを使用して個々のパフォーマンスメトリックを有効にできます。優先度が 0 より大きい個々のメトリックは有効にできません。

任意のエレメント： <perf-metric name="<metric_path>"/>

Perf-metric名属性

パフォーマンスメトリックの完全パスを指定します。以下の % Busy メトリックと Errors Unhandled During Execution メトリックの例を参照してください。

型：文字列：メトリックパス

デフォルト：N/A

要否：perf-metric エレメントを使用する場合は必須。

各パフォーマンスメトリックを使用したマシンエージェント構成のサンプル

<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 属性は、パフォーマンスカウンタカテゴリを示します。

タイプ：文字列

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

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

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

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

タイプ：文字列

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

要否：perf-counter エレメントには名前が必要。

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

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

タイプ：文字列

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

タイプ：文字列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 エレメントの子エレメントです。これにより、追加の instrumentor（スレッド関連付け、.NET Remoting の関連付けなど）を有効にできます。

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

Instrumentor エレメント

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

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

instrumentor名属性

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

タイプ：文字列

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

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

Instrumentor enabled属性

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

型：ブール型

デフォルト：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>

追加の Instrumentor

.NETのスレッドの関連付け.NETのスレッドの関連付け
.NET Remotingの関連付けを有効化 .NET Remotingの関連付けを有効化
WCFデータサービスのインストゥルメンテーションの有効化 WCFデータサービスのインストゥルメンテーションの有効化