Managed Service for OpenTelemetry:コンソールでデータを表示できないのはなぜですか？

考えられる原因:

• クライアントが Managed Service for OpenTelemetry サーバーに接続できません。

• Managed Service for OpenTelemetry コンソールでレポート機能が無効になっています。

• ログサービスのデータソースへのデータの送信に失敗しました。

• HTTP 経由でのデータの送信に失敗しました。

• Google Remote Procedure Call (gRPC) 経由でのデータの送信に失敗しました。

• 監視タスクが異常な状態です。

トレースデータの例外:

• Managed Service for OpenTelemetry コンソールのトレースデータが予期したとおりではありません。

ネットワーク接続を確認する

1. コード内でデータを送信するエンドポイントがプライベートエンドポイントかパブリックエンドポイントかを確認します。プライベートエンドポイントを使用する場合は、エンドポイントがデータを送信するサーバーと同じ仮想プライベートクラウド (VPC) に属していることを確認してください。リージョンをまたいでデータを送信することはできません。

2. レポート環境で、curl または telnet コマンドを実行して、データを送信するエンドポイントとポートが使用可能かどうかを確認します。使用できない場合は、使用する Elastic Compute Service (ECS) インスタンスのセキュリティグループ設定を確認します。

telnet [endpoint] [port number]

telnet tracing-analysis-dc-hz.aliyuncs.com 8090

レポート機能が有効になっているかどうかを確認する

• Managed Service for OpenTelemetry コンソールで、すべてのアプリケーションに対してグローバルに、または特定のアプリケーションに対してレポート設定を変更できます。すべてのアプリケーションに対してグローバルに、または特定のアプリケーションに対してレポート機能が有効になっているかどうかを確認します。

• アプリケーションの送信データ量が設定済みのクォータに達しているかどうかを確認します。アプリケーションの送信データ量が設定済みのクォータに達している場合、それ以上のデータを送信することはできません。

すべてのアプリケーションに対してグローバルにレポート機能が有効になっているかどうかを確認する

Managed Service for OpenTelemetry コンソールの左側のナビゲーションペインで、[クラスタ設定] をクリックします。[クラスタ設定] タブの [データキャプチャ設定] セクションで、[すべて有効] または [デフォルトで有効] が選択されているかどうかを確認します。

クォータ設定を確認する

Managed Service for OpenTelemetry コンソールの左側のナビゲーションペインで、[クラスタ設定] をクリックします。[クラスタ設定] タブの [クォータ設定] セクションで、送信データ量が設定済みのクォータに達しているかどうかを確認します。送信データ量がクォータに達している場合は、クォータを増やします。

特定のアプリケーションに対してレポート機能が有効になっているかどうかを確認する

[アプリケーション] ページで、管理するアプリケーションの名前をクリックします。アプリケーション詳細ページの左側のナビゲーションペインで、[アプリケーション設定] をクリックします。[カスタム設定] タブの [データキャプチャ設定] セクションで、[キャプチャデータ] として [有効] または [設定しない] が選択されているかどうかを確認します。

ログサービスデータソースを確認する

Managed Service for OpenTelemetry のデータは、アカウント内のログサービスプロジェクトに保存されます。ログサービスのプロジェクト数が上限に達すると、データの送信に失敗します。

解決策:

• 使用されていないログサービスプロジェクトを解放します。

• ログサービスのプロジェクトの最大数を増やすために、チケットを送信チケットを送信します。

監視タスクのステータスを確認する

監視タスクが異常な状態であるか、有効になっていないというメッセージが表示された場合は、チケットを送信してください。

HTTP 経由でのデータの送信に失敗した場合のトラブルシューティング

返された HTTP ステータスコードに基づいてトラブルシューティングを行う

Managed Service for OpenTelemetry コンソールまたはログファイルで返された HTTP ステータスコードを確認し、それに応じて障害のトラブルシューティングを行います。

• HTTP ステータスコード 403: サーバーはリクエストの承認を拒否します。

  • 入力したエンドポイントまたはトークンが正しくありません。正しいエンドポイントとトークンを取得するには、次の操作を実行します。Managed Service for OpenTelemetry コンソールの左側のナビゲーションペインで、[クラスタ設定] をクリックします。表示されるページで、[アクセスポイント情報] タブをクリックします。

  • Zipkin クライアントに入力した URL に /v2/spans が含まれており、削除する必要があります。

• HTTP ステータスコード 405: 送信されたデータ量が指定した上限に達しています。

  [クラスタ設定] タブの [クォータ設定] セクションで上限を増やすことができます。

• HTTP ステータスコード 406: クラスタ収集機能が無効になっています。

  [クラスタ設定] タブの [収集設定] セクションでクラスタ収集を有効にできます。

• HTTP ステータスコード 400: データ形式がサポートされていません。

  Content-Type ヘッダーの値は、application/json、application/x-thrift、または Bad Request のみ可能です。

  例:

  • タグのキーと値はどちらも文字列形式である必要がありますが、送信された値は JSON 配列です。

  • スパンは JSON 配列形式である必要がありますが、送信されたデータは JSON オブジェクトです。

返された HTTP エラーメッセージに基づいてトラブルシューティングを行う

次のメッセージが表示された場合、APISIX は OpenTelemetry を使用してデータを送信できません。

The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.

APISIX は、OpenTelemetry を使用して Managed Service for OpenTelemetry に直接データを送信できません。OpenTelemetry Collector を使用して Managed Service for OpenTelemetry にデータを転送する必要があります。

gRPC 経由でのデータの送信に失敗した場合のトラブルシューティング

gRPC 経由でデータを送信する場合、Managed Service for OpenTelemetry コンソールまたはログファイルで返された gRPC ステータスコードを確認できます。gRPC ステータスコードの詳細については、「ステータスコードと gRPC での使用方法」を参照してください。

このセクションでは、一般的な gRPC 関連の問題のトラブルシューティング方法について説明します。

レポートがタイムアウトする

エラーメッセージ:

Failed to export spans. The request could not be executed. Full error message: timeout

トラブルシューティング:

1. ネットワーク接続を確認します。

2. ビジネス要件に基づいて、SDK またはエージェントを使用してデータを送信するためのタイムアウト期間を増やします。

権限検証に失敗する

エラーメッセージ:

Failed to export spans. Server responded with gRPC status code 7. Error message:

トラブルシューティング:

gRPC リクエストヘッダーの [認証] フィールドの値が、Managed Service for OpenTelemetry コンソールの認証トークンと一致するかどうかを確認します。

SkyWalking クライアントの MeterSender がエラーを報告する

エラーメッセージ:

MeterSender : Send meters to collector fail with a grpc internal exception. org.apache.skywalking.apm.dependencies.io.grpc.StatusRuntimeException: UNIMPLEMENTED: Method not found: skywalking.v3.MeterReportService/collect

原因: SkyWalking クライアントがメトリクスを Managed Service for OpenTelemetry サーバーに送信します。

解決策: SkyWalking クライアントがメトリクスを報告しないように無効にします。

コンソールのトレースデータが予期したとおりでない場合のトラブルシューティング

SkyWalking のエージェントまたは SDK を使用してデータを送信する

• アプリケーションの一部のフレームワークとミドルウェアのイベントが追跡されないのはなぜですか？

  1. SkyWalking エージェントのプラグインパスにあるフレームワークプラグインの一部が追跡されていないかどうかを確認します。これらのプラグインのバージョンが、アプリケーションで使用されているフレームワークのバージョンと同じかどうかを確認します。

     たとえば、SkyWalking v8 以降のプラグインパスは ${agent-path}/agent-8.x/plugins です。plugins ディレクトリにプラグインがない場合は、bootstrap-plugins または optional-plugins フォルダにある必要なプラグインを plugins ディレクトリにコピーするか、コミュニティで必要なプラグインをダウンロードできます。

  2. アプリケーションに SkyWalking エージェントのみが追加されているかどうかを確認します。アプリケーションに複数のエージェントを追加すると、インストゥルメンテーションロジックで競合が発生する可能性があります。

• トレースが途切れているのはなぜですか？

  非同期トレースが使用されているかどうかを確認します。非同期トレースで途切れたトレースを解決する方法の詳細については、「スレッド間のトレース」を参照してください。

• トレース全体の長さが予想よりも短いのはなぜですか？

  ${agent-path}/agent-8.x/config/agent.config ファイルの collector.agent.service_graph.batch_size の値を変更することで、SkyWalking エージェントが送信できるスパンの最大数を増やすことができます。

OpenTelemetry のエージェントまたは SDK を使用してデータを送信する

トレースが途切れているのはなぜですか？

非同期トレースが使用されているかどうかを確認します。非同期トレースで途切れたトレースを解決するには、OpenTelemetry のバージョンを更新するか、OpenTelemetry の SpanLinks API を使用することをお勧めします。スパンを別のスパンの親スパンとして指定して 2 つのスパンを関連付けるか、コンテキスト伝播に基づいてトレースコンテキストを別のアプリケーションに明示的に渡すことができます。