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

症状： トレースが生成されない、あるいは一部のサービスではトレースが報告されるが、他のサービスでは報告されない。

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

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

   • .NET Core 動作環境： 5.0 以降
2. Instana SDK または OpenTelemetry SDK を使用して、手動による計測が正しく実装されていることを確認してください。

3. SDKパッケージが正しくインストールされているか確認してください：

   • Instana SDK については： Instana.Tracing.Core.Sdk
   • OpenTelemetry.Extensions.HostingOpenTelemetry SDK については： OpenTelemetry.Exporter.OpenTelemetryProtocol
4. アプリケーションのコード内でカスタムスパンが作成されていることを確認してください。
5. Instana のエージェントログを確認し、接続に関する問題がないか確認してください。
6. OpenTelemetry SDK を使用している場合は、 OTLP エクスポーターのエンドポイントが正しく設定されていることを確認してください（デフォルト： http://localhost:4317gRPC ）。
7. configuration.yamlInstana エージェントで、com.instana.plugin.opentelemetryOpenTelemetry プラグインが有効になっているかどうかを確認してください。
8. Instana のトレースログを収集する。

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

   • ログが空であるか、ログにトレースが表示されない場合は、アプリケーションコード内でスパンが正しく作成されていない可能性があります。
   • ログにトレースが記録されており、その中にUIには表示されていなかった情報が含まれている場合、問題はバックエンドまたはエージェントのいずれかで発生したことになります。

症状：Instana SDKまたは OpenTelemetry SDKを統合した場合、アプリケーションの起動に失敗する。

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

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

   • .NET Core 動作環境： 5.0 以降
2. SDKパッケージが.NET ランタイムのバージョンと互換性があることを確認してください。
3. アプリケーションのログを確認し、SDKの初期化エラーがないか確認してください。
4. telnet localhost 42699（例：）を使用して telnet agent_host agent_port 、 z/OS 環境から Instana エージェントのエンドポイントにアクセスできることを確認してください。
5. 可能であれば、問題のアプリケーションのクラッシュダンプを取得してください。

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

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

1. z/OS 上で Instana エージェントが実行されていることを確認してください。
2. Instana エージェントがアプリケーションにアクセスする権限を持っていることを確認してください。

3. エージェントの設定ファイル（*instanaAgentDir*/etc/instana/configuration.yaml）で、.NET Core のトレースが有効になっていることを確認してください：

   com.instana.plugin.netcore:
     tracing:
       enabled: true

   注： 設定ファイルを変更した後は、 Instana エージェントを再起動する必要があります。

4. OpenTelemetry SDK を使用している場合は、 OpenTelemetry プラグインが有効になっていることを確認してください：

   com.instana.plugin.opentelemetry:
     grpc:
       enabled: true
     http:
       enabled: true

   注： 設定ファイルを変更した後は、 Instana エージェントを再起動する必要があります。
5. SDK を使用して、アプリケーションがスパンを作成していることを確認してください。
6. SDKの初期設定において、サービス名が正しく設定されているか確認してください。

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

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

1. 情報源を特定する：

   • z/OS のシステム監視ツールを確認し、問題がアプリケーションに関連しているかどうかを判断してください。

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

   • アプリケーションのログを確認し、メモリ関連の例外やパフォーマンスの問題がないか確認してください。
   • この問題が、アプリケーションコード内でのスパン作成の過剰な使用に起因するかどうかを確認してください。
   • `statement` を使用 using するか、明示的な破棄を行うことで、スパンが適切に閉じられているか、または破棄されているかを確認してください。
   • 作成されるカスタムスパンの頻度と量を検証してください。
   • 詳細な分析のため、アプリケーションログとメモリダンプの提出をお願いします。

症状： SDKが統合されているにもかかわらず、 Instana のUIにトレースが表示されない。

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

1. アプリケーションの起動コード内で、SDKが正しく初期化されていることを確認してください。

   • Instana SDK については：

     • スパンが適切な SpanType (ENTRY, INTERMEDIATE, および EXIT) で作成されていることを確認してください。
     • `statement` を使用して using 、スパンが適切に処理されるようにしてください。

   • OpenTelemetry SDK については：

     • サービス設定で が呼び出されていることを AddOpenTelemetry() 確認してください。
     • http://localhost:4317OTLP エクスポーターのエンドポイントが正しく設定されているか確認してください（デフォルト：）。
     • が正しく登録され、使用されていることを ActivitySource 確認してください。
     • リソースビルダーでサービス名が正しく設定されていることを確認してください。

2. アプリケーションと Instana エージェント間のネットワーク接続を確認してください：

   • 接続を確認するには、（例： telnet localhost 42699Instana SDKの場合は、 telnet localhost 4317OpenTelemetry SDK（ gRPC 対応）の場合は）を使用 telnet agent_host agent_port してください。
   • Instana のエージェントログを確認し、接続の試行やエラーがないか確認してください。
   • z/OS のネットワーク設定およびセキュリティポリシーを確認してください。

3. 必要なポートでの通信がファイアウォールルールで許可されているか確認してください：

   • 42699 : Instana エージェントのデフォルトポート（ Instana SDK用）
   • 4317 : gRPC OTLP エンドポイント（ OpenTelemetry SDK用）
   • 4318 : HTTP OTLP エンドポイント（ OpenTelemetry SDK用。 gRPC の代わりに HTTP を使用している場合）