IIS における「.NET 」トレースのトラブルシューティング

症状： アプリケーションにメトリクスは表示されるがトレースが表示されない、一部のサービスではレポートされるが他のサービスでは表示されない、あるいはデプロイや更新後にトレースが停止する。

トラブルシューティングの手順

1. .NET 版アプリケーションがサポートされていることを確認してください：

   • .NET Core 動作環境： 5.0 以降
2. エージェント configuration.yaml ファイルでトレースが有効になっていることを確認してください。
3. Log Collector を使用して、 または手動でログを収集して、トレースログを取得します。

4. Instana のトレースログを確認してください：

   • ログが空であるか、トレースが表示されない場合は、アプリケーションがスパンを生成していないことを意味します。
   • ログにトレースは記録されているものの、情報（ホスト名など）が欠落している場合は、.NET のトレース層に問題があります。
   • ログにトレースが記録されており、そのトレースにUIには表示されていない情報が含まれている場合、問題は Instana のバックエンドまたはエージェントのいずれかで発生したことになります。

症状：Instana エージェントが実行されている場合、アプリケーションの起動に失敗する。

トラブルシューティングの手順

1. .NET 版アプリケーションがサポートされていることを確認してください：

   • .NET Core 動作環境： 5.0 以降
2. ログコレクター を使用するか、 手動でログを収集して、イベントビューアのログを取得します。

3. Instana のイベント ビューアーのログを確認してください：

   • ログにエラーや警告が表示されているかどうかを確認してください。 イベントには、問題の診断に役立つタイムスタンプやエラーコードなどの詳細情報が含まれています。
   • 「」を示す InstanaPCP.exe エラーが表示された場合、 InstanaPCP が失敗したことを意味します。 その前のイベントを確認し、問題をさらに詳しく調査してください。
4. アプリケーションのクラッシュダンプを取得してください。

症状：.NET アプリケーションが Instana エージェントによって監視されておらず、UIに表示されません。

トラブルシューティングの手順

1. Instana エージェントが管理者として実行されていることを確認してください。
2. Instana エージェントがアプリケーションへのアクセス権限を持っていることを確認してください。

3. Instana のPCPが実行されていることを確認してください：

   • InstanaPCPWindows でタスクマネージャーを開き、. を検索します。

4. Log Collector を使用するか、 手動でログを収集して、 Instana のエージェントログを収集します。

   • Instana のエージェントログに、次の行が含まれている必要があります：

     com.instana.agent-process-handling - <version> |  | InstanaPCP.exe passed early window; marked RUNNING

5. エージェントのログで、センサーが正常に有効化されていることを確認してください：

   com.instana.sensor-clr - <version> |  | Activated Sensor

6. 「 Instana 」エージェントの起動後に、「.NET 」プロセスが起動していることを確認してください。

症状：InstanaPCP または.NET アプリケーションで、トレースを有効にした後、CPU使用率が異常に高くなる。

トラブルシューティングの手順

1. タスクマネージャーを確認し、問題がアプリケーションに起因するものか、それとも InstanaPCP に起因するものかを特定してください。

2. 問題が InstanaPCP: にある場合

   • InstanaPCP のデバッグログを有効にする。 「ログの収集」 を参照してください。
   • パフォーマンスカウンターが見つからないというメッセージや例外が発生しているかどうか、ログを確認してください。

3. 問題がアプリケーションのメモリ使用量の急増である場合：

   • Log Collector を使用するか、 手動でログを収集して、イベントログおよび.NET のログを収集します。
   • イベントログおよび.NET のログを確認し、メモリ関連の例外がないか確認してください。
   • この問題が Instana の計測機能に起因するものかどうかを確認してください。
   • 詳細な分析のために、.NET のダンプファイルを取得してください。 Go タスクマネージャーを開き、そのプロセスを右クリックして、ダンプファイルを作成します。

Log Collectorは、 Instana からログを収集するためのスタンドアロンアプリケーションです。 以下の場所からログコレクターを起動できます：

• Instana UI
• コンソール

ログコレクターは、以下のログを収集します：

• アプリケーションのトレースログ
• Instana PCPログ
• CLRデバッグログ
• イベント ビューアのログ
• Instana エージェントのデバッグログ
• Instana エージェントがログを追跡する

あるいは、IISでホストされているアプリケーションについては、手動でログを収集することもできます。 以下のステップを実行します。

1. デバッグ・ログを有効にします。

   1. 次のいずれかのオプションを使用して、環境変数を追加します：

      パスが有効であり、プロセスまたはアプリケーションからアクセス可能で、かつ正しいものであることを確認してください。 {: note}

      • システムレベルで、以下の環境変数を手動で設定してください：

        INSTANA_NET_LOG_PATH: "C:\dc_net_log"
        INSTANA_NET_LOG_LEVEL: DEBUG
        INSTANA_NET_CORE_LOG_LEVEL: DEBUG
        INSTANA_NET_PCP_LOG_LEVEL: DEBUG
        INSTANA_TRACER_ENTEREXIT_LOGGING: 1
        INSTANA_EXTENDED_DEBUG: 1

      • 管理者としてコマンドプロンプトを開き、次のコマンドを実行して環境変数を追加します：

        setx INSTANA_NET_LOG_PATH "C:\dc_net_log" /M
        setx INSTANA_NET_LOG_LEVEL "DEBUG" /M
        setx INSTANA_NET_CORE_LOG_LEVEL "DEBUG" /M
        setx INSTANA_NET_PCP_LOG_LEVEL "DEBUG" /M
        setx INSTANA_TRACER_ENTEREXIT_LOGGING "1" /M
        setx INSTANA_EXTENDED_DEBUG "1" /M

   2. 次の「 Windows 」レジストリキーを設定します：

      CLRDebugLog: "C:\dc_clr_debug_log\clr_"

   3. 変更を適用するには、以下を実行 iisreset してください：

      iisreset

   4. アプリケーションを再起動します。

2. Instana エージェントのログを収集する：

   1. エージェント <instana_install_dir>/bin/stop.sh を停止する。または、エージェントがサービスとして起動されている場合は、そのサービスを停止する。

   2. ログを削除する：以下のコマンドを実行して、ログディレクトリ内のすべてのファイルを削除し、状態をリセットします

      rm -rf <instana_install_dir>/data/log/*

   3. ログレベルを「Debug」に設定する：エージェント configuration.yaml ファイルでログレベルの深刻度を変更します。 詳細については、 「エージェント設定ファイルの設定」 を参照してください。

   4. エージェント <instana_install_dir>/bin/start.sh を起動するか、サービスを起動してください。

   5. 問題の再現手順：問題が発生する状態にし、エージェントを約15分間実行してください。

   6. ログの収集：提出用にログディレクトリを圧縮するには、次のコマンドを実行してください：

      cd <instana_install_dir>/data/logs
      zip -r instana_agent_debug_logs.zip *
       

3. Instana のトレースログを収集する：

   1. com.instana.agent.main.sender.File.cfgGo …に [agent-dir]\etc\instana アクセスして、ファイルを開きます。

   2. ファイルに次の行を追加してください：

      prefix=instanaTraces
      type=traces

      instanaTracesこの設定では、すべてのトレースが記録されたログファイルが提供され、そのファイル名は「.」で [agent-dir]/data/log 始まります。

   3. instana エージェントを再始動します。

   4. 変更を適用するには、以下を実行 iisreset してください：

      iisreset

   5. アプリケーションを約15分間実行してください。

   6. 以下のパスからログを収集してください：

      • 変数で指定されたパス INSTANA_NET_LOG_PATH
      • instana-agent-installation-folder/data/log

4. CLR デバッグログを収集する：

   1. 「 Windows 」のレジストリ エディタを開きます。

   2. Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Instana\ に移動する

   3. C:\temp\clr_レジストリキー CLRDebugLog を、値を持つ文字列として追加します。例：

   4. あるいは、管理者としてコマンドプロンプトを開き、次のコマンドを実行してください：

      reg add "HKLM\SOFTWARE\Instana" /v CLRDebugLog /t REG_SZ /d "C:\temp\clr_" /f

5. Windows のイベントビューアーのログを収集する：

   1. イベント ビューアーを開く：
      1. Win キーと R キーを同時に押します。
      2. eventvwr.msc と入力します。
      3. Enterキー を押してください。
   2. Go エクスポートしたいログに対して：
      • Windows ログ： Windows のログ > アプリケーション
      • アプリケーションおよびサービスのログ
   3. 「アクション 」パネルで、 「すべてのイベントを別名で保存 」を選択します。
   4. .evtx場所を選んで、.として保存してください。