.NET Framework の監視機能の追加設定

.NET Instana 上のTracing SDKを使用すると、 Instana が自動的にトレースしないコンポーネントに対して、カスタムトレースを行うことができます。

環境変数を設定することで、.NET Framework のトレース対象から特定のプロセスを除外することができます。

Windows で特定のプロセスの監視を無効にするには、以下の手順を実行してください：

1. ホストレベルで環境変数を INSTANA_REWRITER_BACKOFF 設定します。
2. 次の例に示すように、その値をセミコロンで区切られたプール名またはプロセス名のリストに設定します

   INSTANA_REWRITER_BACKOFF=my_pool_1;process_1;my_pool_2

3. IISが新しい環境を読み込めるように、次の iisreset コマンドでIISサービスを再起動してください。

Instana では、ホワイトリスト機能を使用することで、特定のプロセスのみをトレースするように設定できます。 ホワイトリストが設定されると、指定されたパターンに一致するプロセスのみがトレース対象となります。 その他のすべてのプロセスは除外されます。

ホワイトリスト機能では、大文字と小文字を区別しない正規表現を使用し、セミコロン区切り値に対応しているため、複数のパターンを定義して柔軟なプロセス照合を行うことができます。

特定のプロセスに対してホワイトリスト登録を有効にするには、以下の手順を実行してください：

1. ホストレベルで環境変数を INSTANA_NET_WHITELIST 設定します。
2. その値を、次の例に示すように、プロセス名または正規表現パターンをセミコロンで区切ったリストに設定します

   INSTANA_NET_WHITELIST="^(weBapi|cORe).*;DefaultAppPool;myApp.exe"

   ここで、それぞれ以下のとおりです。

   • ^(weBapi|cORe).* 大文字小文字を区別せずに、 core で webapi 始まるプロセスに一致します。 このパターンでは、正規表現のアンカーとワイルドカードを使用して、関連する複数のアプリケーションに一致させます。
   • DefaultAppPoolDefaultAppPool . で始まる IIS アプリケーションプールの名前に対して、大文字と小文字を区別しない検索を実行します。 DefaultAppPoolAPIたとえば、や のような DefaultAppPool IIS プールに一致します。
   • myApp.exe 特定のアプリケーションと、ファイル名およびファイル拡張子の完全な形式を照合します。
3. IISでホストされているアプリケーションの場合、環境変数が有効になるよう、次の iisreset コマンドでIISサービスを再起動してください。 IIS以外のアプリケーションの場合は、アプリケーションを再起動してください。

ホワイトリストが設定されると、プロファイラは初期化時に各プロセスをホワイトリストのパターンと照合します。 少なくとも1つのパターンに一致するプロセスに対してのみ、計測が行われます。 一致するプロセスが見つからない場合、プロファイラはプロセスにアタッチせずに終了します。

ホワイトリスト機能は、次のような環境において特に役立ちます：

• 重要なアプリケーションのみを追跡することで、オーバーヘッドを削減する
• 監視対象となる特定のサービスを切り分ける
• 本番環境以外またはテスト環境のプロセスをトレース対象から除外する

スパンフィルタリング機能を使用すると、どのスパンを収集して Instana に送信するかを制御できるため、データ量を削減し、最も関連性の高いトレースに焦点を当てることができます。 .NET センサーは、複数の設定方法を通じて柔軟なスパンフィルタリングに対応しています。

詳細については、 「スパンフィルタリング」 を参照してください。

.NET Framework をご利用のお客様は、.NET Framework 4.7.2 以降を実行するアプリケーション向けに、 AutoProfile をご利用いただけます。

AutoProfile, を有効にするには、以下の手順を実行してください：

1. エージェントの configuration.yml ファイルに以下の設定を追加してください：

   com.instana.plugin.clr:
     profiling:
       enabled: true

2. true環境変数を INSTANA_AUTO_PROFILE に設定してください。

詳細については、 「プロファイルの分析」 を参照してください。

• スパンフィルタリングの設定
• .NET Framework アプリケーションの監視
• .NET Framework のトレース設定
• .NET Framework のトレースに関するトラブルシューティング