オープンソースクライアントからデータをレポートした後、Managed Service for OpenTelemetry コンソールにデータが表示されない場合は、以下のセクションを順番に確認してください。各セクションは、データが失われる可能性のあるデータパイプラインのステージに対応しています。
データは、コンソールに表示される前に、以下のステージを通過します：
クライアント SDK またはエージェントが HTTP または gRPC 経由でテレメトリを送信します。
ネットワークがリクエストをエンドポイントに転送します。
取り込みエンドポイントがリクエストを受け入れるか拒否します。
ストレージバックエンド (Simple Log Service) がデータを永続化します。
コンソールがデータを表示します。
いずれかのステージで障害が発生すると、データは表示されません。まずネットワーク接続を確認し、次に取り込み設定、ストレージ、プロトコル固有のエラーを確認してください。
ネットワーク接続の確認
ご利用のコードがプライベートエンドポイントとパブリックエンドポイントのどちらを使用しているかを確認します。プライベートエンドポイントは、データをレポートするサーバーと同じ Virtual Private Cloud (VPC) に属している必要があります。リージョン間のレポートはサポートされていません。
レポート環境から
curlまたはtelnetを実行して、エンドポイントとポートに到達可能であることを確認します。中国 (杭州) リージョンの gRPC エンドポイントの例：接続に失敗した場合は、ご利用の Elastic Compute Service (ECS) のセキュリティグループ設定を確認してください。詳細については、「Managed Service for OpenTelemetry の使用準備」および「セキュリティグループの概要」をご参照ください。成功：ターミナルに
Connectedメッセージが表示されます。
失敗：ターミナルが
Trying [IP]のままであるか、Unable to connect to remote hostを返します。
telnet <endpoint> <port>telnet tracing-analysis-dc-hz.aliyuncs.com 8090
取り込み設定の確認
データの取り込みは、クラスターレベル、アプリケーションレベル、またはその両方で無効にすることができます。また、レポートされたデータ量が設定されたクォータに達すると、取り込みは停止します。
グローバル取り込み設定
Managed Service for OpenTelemetry コンソールの左側のナビゲーションウィンドウで、[システム設定] > [クラスター設定] を選択します。[取り込み設定] セクションで、[すべて有効] または [デフォルトで有効] が選択されていることを確認します。
クォータ
同じ [クラスター設定] ページで、[クォータ設定] セクションまでスクロールします。レポートされたデータ量が設定されたクォータに達していないことを確認します。達している場合は、クォータを増やしてください。
アプリケーションレベルのデータキャプチャ設定
[アプリケーション] ページで、管理したいアプリケーションの名前をクリックします。アプリケーション詳細ページの左側のナビゲーションウィンドウで、[アプリケーション設定] をクリックします。[カスタム設定] タブの [データキャプチャ設定] セクションで、[データキャプチャ] として [有効] または [設定しない] が選択されているかどうかを確認します。
グローバルの [取り込み設定] で [すべて有効] または [すべて無効] が選択されている場合、アプリケーションレベルの設定は有効になりません。グローバル設定が優先されます。アプリケーションに対して [設定しない] が選択されている場合、そのアプリケーションはクラスターレベルの設定を継承します。
Simple Log Service データソースの確認
Managed Service for OpenTelemetry は、ご利用のアカウント内の Simple Log Service プロジェクトにデータを保存します。Simple Log Service プロジェクトの数が上限に達すると、データのレポートは失敗します。
この問題を解決するには：
使用されなくなった Simple Log Service プロジェクトをリリースします。
プロジェクトの上限を引き上げるためにチケットを送信します。
監視タスクのステータスの確認
コンソールで監視タスクが異常であるか、有効になっていないことが示された場合は、チケットを送信してください。
HTTP レポートの失敗のトラブルシューティング
HTTP ステータスコード
コンソールまたはログファイルで返された HTTP ステータスコードを確認し、対応する解決策に従ってください。
| ステータスコード | 意味 | 原因 | 解決方法 |
|---|---|---|---|
| 400 | サポートされていないデータ形式 | Content-Type ヘッダーの値は application/json、application/x-thrift、または Bad Request である必要があります。タグ値が文字列ではなく JSON 配列である、またはスパンが JSON 配列ではなく JSON オブジェクトとして送信されている、などが一般的な原因です。 | リクエストボディを必要な形式に修正します。 |
| 403 | 認可拒否 | (1) エンドポイントまたはトークンが正しくありません。(2) Zipkin クライアントの URL に /v2/spans が含まれています。 | (1) Managed Service for OpenTelemetry コンソールの [クラスター設定] で正しいエンドポイントとトークンを確認します。(2) URL から /v2/spans を削除します。 |
| 405 | データクォータを超えました | レポートされたデータ量が設定された上限に達しました。 | [クラスター設定] ページの [クォータ設定] セクションで上限を引き上げます。 |
| 406 | クラスターの収集が無効です | クラスターのデータ収集が無効になっています。 | [クラスター設定] ページの [取り込み設定] セクションで有効にします。 |
APISIX レポートの失敗
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 を使用してデータを転送してください。
gRPC レポートの失敗のトラブルシューティング
コンソールまたはログファイルで返された gRPC ステータスコードを確認してください。ステータスコードの完全なリストについては、「gRPC ステータスコード」をご参照ください。
タイムアウト
エラーメッセージ：
Failed to export spans. The request could not be executed. Full error message: timeout解決策：
ネットワーク接続を確認します (「ネットワーク接続の確認」をご参照ください)。
ご利用の SDK またはエージェントの設定で、データレポートのタイムアウト期間を延長します。
認証失敗 (gRPC ステータスコード 7)
エラーメッセージ：
Failed to export spans. Server responded with gRPC status code 7. Error message:gRPC リクエストヘッダーの [Authentication] フィールドの値が、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/collectSkyWalking クライアントがメトリクスを Managed Service for OpenTelemetry サーバーに送信していますが、これはサポートされていません。SkyWalking クライアントでメトリクスのレポートを無効にしてください。
予期しないトレースデータのトラブルシューティング
SkyWalking エージェントまたは SDK
フレームワークまたはミドルウェアイベントの欠落
SkyWalking エージェントのプラグインパス
${agent-path}/agent-8.x/pluginsを確認します。プラグインのバージョンが、ご利用のアプリケーションで使用されているフレームワークのバージョンと一致することを確認します。必要なプラグインがpluginsディレクトリにない場合は、bootstrap-pluginsまたはoptional-pluginsフォルダーからコピーするか、SkyWalking コミュニティからダウンロードしてください。アプリケーションにアタッチされている SkyWalking エージェントが 1 つだけであることを確認します。複数のエージェントがあると、インストルメンテーションの競合が発生する可能性があります。
途切れたトレース
非同期トレースが使用されているかどうかを確認します。非同期トレースで途切れたトレースを解決する方法については、「Trace Cross Thread」をご参照ください。
予期したよりも短いトレース
${agent-path}/agent-8.x/config/agent.config ファイルの collector.agent.service_graph.batch_size の値を変更して、SkyWalking エージェントがレポートできるスパンの最大数を増やします。
OpenTelemetry エージェントまたは SDK
途切れたトレース
非同期トレースが使用されているかどうかを確認します。非同期トレースで途切れたトレースを解決するには：
OpenTelemetry のバージョンを更新します。
SpanLinks API を使用して、トレース間でスパンを関連付けます。
あるスパンを別のスパンの親スパンとして指定します。
コンテキスト伝播を介してトレースコンテキストを明示的に渡します。