.NET Framework ベースのアプリケーションの監視

センサーおよびトレース機能は、デフォルトで有効になっています。 エージェントが起動されると、 InstanaPCP はトレース有効化のプロセスに関する情報を記録します。

次の例は、.NET Framework トレースが有効になっているエージェントファイルを示しています configuration.yaml ：

# .NET Full Framework tracing
com.instana.plugin.clr:
#  # Tracing for .NET Full Framework CLR. Enabled by default
  tracing:
#    # Enabling tracing will instruct the agent to register the IL-rewriting components for .NET
#    # alongside with the instrumentation-libraries.
#    # It will also set the environment-variables for any IIS hosted .NET applications.
#    # Non-IIS hosted applications which you want to trace need these env-vars to be set
#    # manually before starting the actual process
#    # (see the docs here: https://docs.instana.io/ecosystem/dot-net/#enabling-tracing-for-non-iis-hosted-applications)
    enabled: true
  instrumentation:
    suppressions:
#    # The absolute path to a batch-file that should be executed when the tracing-components for
#    # NET Full Framework (Windows) have been updated. You can use this script to automate tasks
#    # that should be executed when new tracing-components get installed. This usually will be
#    # process-restarts or issuing an iisreset command, so that the processes can pickup the new components.
#    # The commands issued in the script should be executed asynchronously (start /b <cmd>) in order to not
#    # slow down the startup-time of InstanaPCP. In case of long-running synchronous tasks (like iisreset) you might
#    # see warnings in the log concerning the unavailability of InstanaPCP for the duration of the execution.
#    update_script: <absolute_path_to_batchfile>
#  # Memory-limits for InstanaPCP.
#  # You can specify these limits to account for high expected load and/or a lot of
#  # infrastructure-components being monitored. Values are in mega-bytes.
#  pcp_warn_limit: 150
#  pcp_stop_limit: 250

ご自身の導入環境に合ったガイドを選択してください：

すべての設定オプションの詳細については、 「.NET Framework のトレース設定」 を参照してください。

基本的な監視設定が完了したら、以下のオプション機能を設定して、.NET Framework の監視機能を強化することができます：

• カスタムトレース ：.NET SDK を使用してカスタムスパンを追加します。
• プロセスの除外 ：環境変数を設定することで、.NET のトレース対象から特定のプロセスを除外します。
• プロセスのホワイトリスト登録 ：特定のプロセスのみを追跡します。
• スパンフィルタリング ：特定のスパンをフィルタリングすることで、データ量を削減します。
• AutoProfile ：パフォーマンスの最適化のために、継続的なプロファイリングを有効にします。

詳細な設定手順については、 「追加機能の設定」 を参照してください。

Instana 受信したメトリクスに対してヘルスシグネチャを継続的に評価し、ユーザーへの影響度に基づいて問題やインシデントを通知します。

組み込みイベントは、エンティティのヘルスシグネチャの異常に基づいて課題やインシデントをトリガーし、 カスタムイベントは、特定のエンティティの個々のメトリクスのしきい値に基づいて課題やインシデントをトリガーします。

.NET Framework の組み込みイベントに関する詳細については、 「組み込みイベントのリファレンス」 を参照してください。

InstanaPCP およびパフォーマンス・カウンターの詳細については、 InstanaPCP および Windows performance counters を参照してください。

Instana CLRセンサー 1.1.148 および .NET トレーサー・フレームワーク 1.315.1 のリリース（2026年3月13日）では、トレ ース対象となるライブラリが「トレース対象のライブラリおよびフレームワーク」セクションに明示的に記載されているものに限定されます。 サポート対象外のバージョンには計測機能が実装されていません。

引き続きサポートを受けるためには、 サポート対象のバージョンにアップグレードしてください。 詳細および回避策については、 テクニカルノートをご覧ください。

もともと.NET Framework 上で構築されたアプリケーションを、.NET 5以降（.NET 6、7、8およびそれ以降を含む）に移行し、IIS上でホストする場合、アプリケーションプールを.NET Framework 4. No Managed Code0で実行するように構成する必要があります。 このモードでは、 Instana はIISレベルのメトリクスを収集できません。

IIS アプリケーション プールが に設定されている No Managed Code場合、 Instana は以下の IIS レベルのメトリクスを収集できません：

• アプリケーションプールの名前
• w3wp.exe プロセス指標
• ワーカープロセスレベルの監視データ

この制限は、IISが.NET 5以降のアプリケーションをホストする方法に起因するものです。 アプリケーションレベルの計測とトレースは引き続き正常に動作していますが、IISレベルのメトリクスは利用できません。

IISレベルのメトリクスが必要な場合は、マネージドコードのアプリケーションプールをサポートする.NET Framework 4 またはそれ以前のアプリケーションの使用をご検討ください。

multi-AppDomain アプリケーション（ SharePoint など）に計測機能を組み込む際、は System.dll 複数の AppDomains、または共有のに読み込まれます。 System.dllしかし、 Instana がクラス System.Net.HttpWebRequest `class` をインストルメントしようとすると、メインのアプリドメイン内でのみメソッドが書き換えられ、その結果、次のエラーが発生します：

Loading this assembly would produce a different grant set from other instances.

このエラーが発生した場合は、以下の環境変数を設定してください：

INSTANA_REWRITER_SUPPRESSION=System.Net.HttpWebRequest
INSTANA_TRACER_SUPPRESSION_ENABLED=1

System.Net.HttpWebRequestこの設定を行うと、の書き換えはスキップされ、その他のインスツルメンテーションは期待どおりに動作します。

Instana のUIにトレースやメトリクスが表示されない場合は、以下の一般的なトラブルシューティング手順を実行してください：

1. 前提条件を確認してください：
   • お使いの.NET Framework ランタイムのバージョンがサポート対象であることを確認してください（.NET Framework 4.5.2 以降）
   • Instana エージェントが実行中であり、アクセス可能であることを確認してください
   • InstanaPCP.exeInstanaPCP が実行されていることを確認してください（タスクマネージャーで確認してください）
   • アプリケーションとエージェント間のネットワーク接続を確認してください
2. 環境変数を確認してください：
   • 必要な環境変数がすべて正しく設定されていることを確認してください
   • パスが有効で、アクセス可能であることを確認してください
   • 変数名のスペルが正しいことを確認してください
3. トレース設定の確認：
   • エージェント configuration.yaml ファイルでトレースが有効になっていることを確認してください
   • 設定変更後、エージェントとアプリケーションを再起動してください
   • IIS アプリケーションの場合、設定変更後は以下を実行 iisreset してください
4. 競合するAPMツールがないか確認してください：
   • 他のAPMツールが同じプロファイリングフックを使用していないことを確認してください
   • 他のAPMエージェントが存在する場合は無効にしてください

プラットフォームごとの詳細なトラブルシューティングのシナリオと解決策については、次のセクションにある該当するトラブルシューティングガイドを参照してください。

すべてのトラブルシューティング方法の概要については、 「.NET Framework のトレースのトラブルシューティング」 を参照してください。