Linux または Alpine Linux における「.NET 」トレースのトラブルシューティング

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

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

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

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

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

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

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

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

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

   • .NET Core 動作環境： 5.0 以降
2. ログコレクター を使用するか、 手動でログを収集して、ログを収集します。
3. アプリケーションのクラッシュダンプを収集してください。

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

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

1. Log Collector を使用するか、 手動でログを収集して、 Instana のエージェントログを収集します。
2. Instana エージェントが管理者として実行されていることを確認してください。
3. Instana エージェントに、アプリケーションを監視する権限があることを確認してください。

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

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

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

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

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

1. 原因を特定する：システムモニターを確認し、問題がアプリケーションに関連しているかどうかを判断します。

2. アプリケーションのメモリ使用量が急増している場合：

   • .NET のログを確認し /var/log 、メモリ関連の例外がないか確認してください。
   • この問題が Instana の計測機能に起因するものかどうかを確認してください。
   • 詳細な分析のために、.NET のダンプファイルをリクエストしてください。

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

• Instana UI
• コンソール

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

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

あるいは、ログコレクターを使用せずに、手動でログを収集することもできます。 以下のステップを実行します。

1. デバッグログを有効にする：システムレベルで以下の環境変数を手動で設定し、アプリケーションを再起動してください：

   export INSTANA_NET_LOG_PATH="<Log_path>"
   export INSTANA_NET_LOG_LEVEL=DEBUG
   export INSTANA_NET_CORE_LOG_LEVEL=DEBUG
   export INSTANA_TRACER_ENTEREXIT_LOGGING=1
   export INSTANA_EXTENDED_DEBUG=1
   export INSTANA_CLRLOG_PATH=/var/tmp/clr_

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

   1. エージェントを停止します。

      sudo systemctl stop instana-agent.service

   2. ログを消去する：ディレクトリ内の logs すべてのファイルを削除して、一からやり直す：

      sudo rm -rf <instana_install_dir>/data/logs/*

   3. ログレベルを「debug」に設定します：設定ファイルでログレベルの深刻度を変更します：

      log4j2.logger.instana.level=DEBUG設定ファイルの <instanaAgentDir>/etc/org.ops4j.pax.logging.cfg ログレベルを から log4j2.logger.instana.level=INFO に変更する。

      重要： 行末に空白が含まれていないことを確認してください。

   4. 以下の方法でエージェントを開始します。

      sudo systemctl start instana-agent.service

   5. ログフォルダ内のログを確認し、ログを収集してください。提出用にディレクトリを logs 圧縮してください：

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