Windows での .NET Framework トレースの設定
Windows システムでは、環境変数を手動で設定することで、スタンドアロンアプリケーション、プロセス、および Windows サービスに対して.NET Framework トレースを設定できます。 この方法は、IIS以外でホストされているアプリケーションに必要です。
このトピックでは、以下の内容を取り上げます:
準備
Windows で「.NET Framework 」のトレースを設定するには、以下の手順を実行してください:
- ホストマシン上で Instana エージェントが実行されていることを確認してください。 「 Windows へのエージェントのインストール 」を参照してください。
- ホストマシン上で InstanaPCP が実行されていることを確認してください。 InstanaPCP これにより、 Instana エージェントが.NET Framework アプリケーションと通信できるようになります。
InstanaPCP.exeInstanaPCP が実行されているかどうかを確認するには、 Windows でタスクマネージャーを開き、. を探してください。 - お使いのアプリケーションが、.NET Framework 4.5.2 以降で動作することを確認してください。
- サポート情報を確認してください。
スタンドアロンアプリケーションでのトレース機能を有効にする
Instana エージェントは、.NET を基盤とするすべてのアプリケーションに対して、自動的にトレース機能を有効にするわけではありません。 たとえば、 Windows のシステムアプリケーションやスタンドアロンプロセスは、明示的に設定されていない限り除外されます。
IISおよび WebSphere Application Server は、適切な環境変数を設定することで、プロファイラを自動的に接続するように構成されています。 ただし、スタンドアロンのプロセスは手動で設定する必要があります。
プロセスのトレースを有効にするには、以下の環境変数を設定してください:
注:
- アプリケーションの実行に特定のユーザーを使用する場合は、ユーザーレベルで環境変数を設定してください。
- プロセスを開始する前に、環境変数を設定してください。
SET COR_ENABLE_PROFILING=1
SET COR_PROFILER={FA8F1DFF-0B62-4F84-887F-ECAC69A65DD3}
これらの設定を、環境変数を設定してからプロセスを起動するバッチスクリプトやシェルスクリプトに組み込むことができます。
Windows サービスのトレース機能を有効にする
Windows Services を実行している場合、サービスごとにレジストリに環境変数の設定を追加することができます。 これらの設定を追加することで、トレース対象のサービスをより細かく制御できるようになります。
Windows Services の環境変数を設定するには、以下の手順を実行してください:
HKLM\System\CurrentControlSet\Services\serviceNameGo ディレクトリ内のレジストリエディタへ。Environment名前が「」のMULTI_SZ値を追加します。- が存在しない場合は
MULTI_SZ、変数 COR_ENABLE_PROFILING、 COR_PROFILER、および INSTANA_ALLOW_ROOT_EXIT_SPAN の値をその変数にコピーしてください。 - 値
MULTI_SZの内容を設定するには、次の例のように、1行につき1つのキーと値のペアを追加しますCOR_ENABLE_PROFILING=1 COR_PROFILER={FA8F1DFF-0B62-4F84-887F-ECAC69A65DD3} INSTANA_ALLOW_ROOT_EXIT_SPAN=1 - 最後の行を入力したら、Enterキーを押してください。
- 変更を反映させるには、 Windows サービスを再起動してください。