.NETのランタイムリインストルメンテーションを構成

デフォルトで、次を作成または更新した後にはモニター対象のアプリケーションを再起動する必要があります。

  • POCOトランザクション検出エントリポイント
  • POCOサービスエンドポイント
  • カスタムイグジットポイント
  • メソッド呼び出しおよび HTTP データコレクタ
  • インフォメーションポイント

ランタイムのリインストルメンテーションを有効化すると、.NET エージェントはインストルメンテーション変更のタイプを検出し、CLR が影響を受けるコードを再コンパイルすることを自動的に要求します。ランタイムのリインストルメンテーションを有効にすると、インストルメンテーションの変更を適用する場合に、アプリケーションを再起動する必要がありません。「.NETエージェントの管理」を参照してください。

要件

ランタイムのリインストルメンテーションは、.NET Framework 4.5.2 以降で動作します。アプリケーションの web.config ファイルでフレームワークバージョンを確認する場合は、次のように入力します。

<system.web>
<compilation targetFramework="4.5.2" />
<httpRuntime targetFramework="4.5.2" />
</system.web>

.NETのランタイムリインストルメンテーションを構成

config.xml ファイルで .NET エージェントのすべてのインストルメンテーション設定を構成します。

  1. config.xml ファイルを開き、管理者として編集します。「.NETエージェントの管理」を参照してください。
  2. 以下のコードブロックを app-agents エレメントの子エレメントにコピーします。例：デフォルトのプロファイラエレメント 
    <profiler>
<runtime-reinstrumentation enabled="true" interval="60000" />
</profiler>
    <?xml version="1.0" encoding="utf-8"?>
<appdynamics-agent xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
...
<app-agents>
<profiler>
<!-- Enable runtime reinstrumentation -->
<runtime-reinstrumentation enabled="true" interval="60000"/>
</profiler>
...
</app-agents>
</appdynamics-agent>
  3. 必要に応じて、runtime-reinstrumentation オプションを構成します。

    • eneabled：ランタイム リインストルメンテーションを有効にするには、true に設定します。デフォルト：false

    • interval：エージェントが構成の更新を確認する周波数（ミリ秒単位）。デフォルトは 60000 です。

      注: ランタイム再インストルメンテーションでは少量のシステムオーバーヘッドが追加されるため、Cisco AppDynamicsでは最小間隔として 1 分または 60000 ミリ秒が推奨されます。.NET エージェントは設定の更新があるかどうかを毎分確認するため、デフォル設定の 60000 ミリ秒では、再インストルメンテーションが有効になるのに最大 2 分かかる場合があります。
  4. config.xml ファイルを保存します。
  5. AppDynamics.Agent.Coordinator サービスを再起動します。
  6. インストゥルメント化されたアプリケーションを再起動して、変更を適用。