Windows での.NET トレースの設定

オンラインで編集

Windows で .NET のトレースを設定するには、 Instana AutoTrace を使用するか、環境変数を手動で設定してください。 .NET Tracerは、コンテナを除く Windows システムにおけるホストの自動トレースに対応しています。

.NET の監視機能の詳細については、「.NET の監視機能の仕組み」を参照してください。

始めに
.NET のトレース機能を有効にする
次のタスク

準備

オンラインで編集

Windows で .NET Core のトレースを設定するには、以下の手順を実行してください：

ホストマシン上で Instana エージェントが実行されていることを確認してください。「 Windows へのエージェントのインストール」を参照してください
ホストマシン上で Instana のPCPが実行されていることを確認してください。 Instana PCPにより、 Instana エージェントが.NET アプリケーションと通信できるようになります。 Instana のPCPが実行されているかどうかを確認するには、 Windows でタスクマネージャーを開き、「 Instana PCP」を探してください。
.NET Core センサー（ 1.0.56 以降）をインストールしてください。
サポート情報を確認してください。

.NET のトレース機能を有効にする

オンラインで編集

以下のいずれかの方法を使用して、 Windows で.NET のトレースを有効にします

AutoTrace
手書きトレース

方法 1: 自動トレースを有効にする

オンラインで編集

Instana を使用すると、 AutoTrace, および Instana がアプリケーションを自動的に検出して、計測コードを挿入します。コードを変更する必要はありません。

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

エージェント configuration.yaml ファイル（*instanaAgentDir*/etc/instana/configuration.yaml）のセクションを .NET Core 次のように変更してください：
```
# netcore Tracing
com.instana.plugin.netcore:
  tracing:
    enabled: true
```
アプリケーションを開始します。

ディスカバリーの起動中に、 Instana エージェントがアプリケーションを自動的に検出し、トレースを開始します。コードの変更は必要ありません。

トレースが正常に機能しているか確認するには、 Instana のダッシュボードにログインしてください。痕跡が現れてくるのがわかります。

方法 2: トレースを手動で有効にする

オンラインで編集

より詳細な制御が必要な場合や、 AutoTrace が環境に適合しない場合は、この方法を使用してください。この方法では、アプリケーションに NuGet パッケージを追加する必要があります。

.NET Core アプリケーションで手動トレースを有効にするには、以下の手順を実行してください：

以下の NuGet パッケージをインストールしてください：
- Instana.Tracing.Core
- Instana.Tracing.Core.Rewriter.Windows
パッケージが NuGet.org を通じて配布されている場合、アプリケーションを再コンパイルすることなくインストールできます。以下の方法の 1 つを使用します。
- nuget.exe 利用可能：計測対象のプロジェクトをコンパイルせずに、を使用して nuget.exe パッケージを復元します。
- nuget.exe 利用不可：パッケージを直接ダウンロードし、解凍した後、次の手順に従って、解凍したファイルが格納されている場所を指すように環境変数を設定してください。
注：このパッケージを Instana.Tracing.Core.Rewriter.Windows プロジェクトに追加するか、公開前に追加することができます。

システムレベルまたはアプリケーションレベルで、以下の環境変数を設定してください：

CORECLR_ENABLE_PROFILING=1
CORECLR_PROFILER={FA8F1DFF-0B62-4F84-887F-ECAC69A65DD3}
CORECLR_PROFILER_PATH_64=[Path_to_your_app]/instana_tracing/CoreRewriter_x64.dll
CORECLR_PROFILER_PATH_32=[Path_to_your_app]/instana_tracing/CoreRewriter_x86.dll
DOTNET_STARTUP_HOOKS=[Path_to_your_app]/Instana.Tracing.Core.dll

を、アプリケーションディレクトリの実際のパスに置き換えて [Path_to_your_app] ください。

1. アプリケーションが Windows サービスとして実行されている場合、 Windows レジストリを通じてトレーシングを設定できます：
  1. レジストリエディタを開き、次の場所へ移動します：
```
HKLM\System\CurrentControlSet\Services\
 
```
  2. 「Environment」 の値として「a MULTI_SZ 」を追加してください。「 Environment 」という名前の変数が存在しない場合は、以下の変数をそのファイルにコピーしてください：
    - CORECLR_ENABLE_PROFILING=1
    - CORECLR_PROFILER={FA8F1DFF-0B62-4F84-887F-ECAC69A65DD3}
  3. 値 MULTI_SZ の内容を設定するには、次の例のように、1行につき1つのキーと値のペアを入力してください：
```
CORECLR_ENABLE_PROFILING=1
CORECLR_PROFILER={FA8F1DFF-0B62-4F84-887F-ECAC69A65DD3}
CORECLR_PROFILER_PATH_64=[Path_to_your_app]/instana_tracing/CoreRewriter_x64.dll
CORECLR_PROFILER_PATH_32=[Path_to_your_app]/instana_tracing/CoreRewriter_x86.dll
DOTNET_STARTUP_HOOKS=[Path_to_your_app]/Instana.Tracing.Core.dll
 
```
  4. 最後の行を入力したら、Enterキー を押して値を保存してください。
環境変数を反映させるには、アプリケーションを再起動してください。

次のタスク

オンラインで編集