.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>

Configure Runtime Reinstrumentation for .NET

Configure all instrumentation settings for the .NET Agent in the config.xml file:

  1. Open the config.xml file for editing as an administrator. See Administer the .NET Agent.
  2. Copy the code block below to a child element of the app-agentsFor example:Default Profiler Element. 
    <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. If appropriate configure the runtime-reinstrumentation options:

    • enabled: Set to true to enable runtime reinstrumentation. Default: false

    • interval: The frequency the agent checks for configuration updates in milliseconds. Default: 60000.

      注: Because runtime reinstrumentation adds a small amount of system overhead, Cisco AppDynamicsrecommends a minimum interval of 1 minute or 60000 milliseconds.The .NET Agent checks for configuration updates every minute, so it may take up to 2 minutes for reinstrumentation to take effect with the default setting of 60000 milliseconds.
  4. Save the config.xml file.
  5. Restart the AppDynamics.Agent.Coordinator service.
  6. Restart instrumented applications for your changes to take effect.