.NET および.NET Core を基盤とするアプリケーションの監視

環境に応じて、.NET アプリケーションのトレース設定を自動または手動で行うことができます。

お使いの環境が AutoTrace, に対応している場合、 Instana は.NET アプリケーションに自動的に計測機能を追加します。 ただし、 AutoTrace がサポートされていない場合は、手動でのトレースを行う必要があります。

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

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

• Kafka トレース相関ヘッダー ： Kafka のトレース用ヘッダー形式を設定します。
• プロセスの除外 ：ホワイトリストまたはブラックリストを使用して、監視対象のプロセスを制御します。
• プロセスのホワイトリスト登録 ：特定のプロセスのみを追跡します。
• スパンフィルタリング ：特定のスパンをフィルタリングすることで、データ量を削減します。
• AutoProfile ：パフォーマンスの最適化のために、継続的なプロファイリングを有効にします。
• カスタムトレース ：.NET SDK を使用して、カスタムスパンを追加します。
• イベント駆動型計測 ： ActivitySource イベントを通じてテレメトリデータを取得します。

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

Instana.Tracing.CoreLinux では、 NuGet パッケージ（ 1.1.34 以降）を使用してアプリケーションをデプロイしてください。 次の環境変数を設定してください：

DOTNET_STARTUP_HOOKS=[path-to-your-app]/Instana.Tracing.Core.dll
 

パッケージが正常に読み込まれたことを確認するには、アプリケーションの出力から次の行を探してください：

INSTANA Agent for .NET Core applications installed. Running on 
 

同じパッケージをトレースに使用できます。

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

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

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

ASP.NET Core 向けの Application Insights にはいくつかの制限があるため、 Instana .NET Core の監視が並行して実行されている場合、Application Insights 上でデータが不完全だったり欠落していたりすることがあります。

Application Insightsと Instana を同時に使用したい場合は、 Instana による W3C ヘッダーの挿入を無効にし、 W3C のトレースコンテキストの伝播を無効にする必要があります。

Instana による W3C ヘッダーの挿入を無効にするには、次の環境変数を設定してください：

INSTANA_W3C_DISABLE_INJECT_HEADERS=1
 

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

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

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

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

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

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

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

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

1. 前提条件を確認してください：

   • お使いの.NET ランタイムのバージョンがサポート対象であることを確認してください（.NET 5.0 以降）
   • Instana エージェントが実行中であり、アクセス可能であることを確認してください
   • アプリケーションとエージェント間のネットワーク接続を確認してください

2. 環境変数を確認してください：

   • 必要な環境変数がすべて正しく設定されていることを確認してください
   • パスが有効で、アクセス可能であることを確認してください
   • 変数名のスペルが正しいことを確認してください

3. IL-Rewriterの初期化を確認してください：

   • アプリケーションログを確認し、IL-Rewriterの初期化メッセージを探してください
   • CORECLR_PROFILER_PATHCORECLR_ENABLE_PROFILING、、および CORECLR_PROFILER が正しく設定されていることを確認してください

4. 診断機能を有効にする：

   • Instana のILリライターを利用したトレースを使用する場合は、と COMPlus_EnableDiagnostics を DOTNET_EnableDiagnostics 1
   • 診断機能が有効になっていない場合、IL-Rewriterはプロセスに接続できません

5. トレース設定の確認：

   • エージェント configuration.yaml ファイルでトレースが有効になっていることを確認してください
   • 設定変更後、エージェントとアプリケーションを再起動してください

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