このトピックでは、オープンソースクライアントからレポートされたデータが Managed Service for OpenTelemetry コンソールに表示されない場合、またはコンソールやログファイルにエラーログが表示される場合に、問題の診断と解決を行う方法について説明します。
データが表示されない問題は、次の2つのカテゴリのいずれかに該当します：
データがサーバーに到達していない：ネットワークの問題、データインジェスト設定の無効化、クォータ超過、またはプロトコルレベルのエラー (HTTP または gRPC) が原因です。
データは到達しているが想定どおりに表示されない：トレースの分断、スパンの欠落、またはエージェントの設定不備が原因です。
ネットワーク接続性の確認
クライアントから Managed Service for OpenTelemetry のエンドポイントに到達できることを確認します。
コード内のエンドポイントが プライベートエンドポイント か パブリックエンドポイント かを判別します。
プライベートエンドポイントは、サーバーと同一の Virtual Private Cloud (VPC) に属している必要があります。クロスリージョンでのレポートはサポートされていません。
レポート環境から
curlまたはtelnetコマンドを実行し、エンドポイントとポートをテストします。エンドポイントに接続できない場合は、Elastic Compute Service (ECS) インスタンスのセキュリティグループ設定を確認します。中国 (杭州) リージョンの gRPC エンドポイントの例：telnet <endpoint> <port>telnet tracing-analysis-dc-hz.aliyuncs.com 8090結果を確認します。次の出力は接続成功を示します。次の出力は接続失敗を示します。
結果 意味 次のステップ 接続が確立される (ターミナルに Connected to ...が表示される)クライアントからサーバーに到達できます。 データインジェスト設定の確認 に進みます。 Trying <IP>...で停止する、またはUnable to connect to remote hostが返るクライアントからサーバーに到達できません。 ECS インスタンスのセキュリティグループルールと VPC のネットワーク設定を確認します。詳細については、「Managed Service for OpenTelemetry への接続とクライアント認証」および「セキュリティグループ」をご参照ください。 ~ → telnet tracing-analysis-dc-hz.aliyuncs.com 8090 Trying xxx.67.89... Connected to tracing-analysis-dc-hz.aliyuncs.com. Escape character is '^]'.telnet tracing-analysis-dc-hz-internal.aliyuncs.com 8090 Trying xxx.80.178... telnet: connect to address xxx.80.178: Operation timed out Trying xxx.7.123... telnet: connect to address xxx.7.123: Operation timed out telnet: Unable to connect to remote host
データインジェスト設定の確認
データインジェストは、グローバル (すべてのアプリケーション) またはアプリケーション単位で制御できます。また、クォータの上限によりインジェストがブロックされる場合もあります。
グローバル設定
Managed Service for OpenTelemetry コンソールの左側メニューで、[Cluster Configurations] をクリックします。
[Data Capturing Settings] セクションで、[Enable All] または [Enable by Default] が選択されていることを確認します。
アプリケーション単位の設定
[Applications] ページで、対象のアプリケーション名をクリックします。
左側メニューで、[Application Settings] をクリックします。
[Custom Configuration] タブの [Data Capturing Settings] セクションで、[Capture Data] が [Enable] または [Don't Set] に設定されていることを確認します。
グローバル設定が [Enable All] または [Disable All] の場合、アプリケーション単位の設定は有効になりません。常にグローバル設定が優先されます。アプリケーションで [Don't Set] を選択した場合、そのアプリケーションはクラスターレベルの設定を継承します。
クォータ
[Cluster Configurations] ページで、[Quota configuration] セクションを確認します。
レポートされたデータ量が設定済みのクォータに達している場合は、クォータを引き上げます。クォータに達すると、それ以降の追加データは受け付けられなくなります。
Simple Log Service データソースの確認
Managed Service for OpenTelemetry は、アカウント内の Simple Log Service (SLS) プロジェクトにデータを格納します。SLS プロジェクト数がアカウント上限に達すると、データのレポートが失敗します。
この問題を解決するには：
未使用の SLS プロジェクトを解放して容量を確保します。
チケットを送信することで、プロジェクト上限の引き上げを依頼してください。
監視タスクステータスの確認
コンソールで監視タスクが異常、または有効化されていないと表示される場合は、チケットを送信して Alibaba Cloud サポートへお問い合わせください。
HTTP レポートエラーのトラブルシューティング
コンソールまたはログファイルで HTTP ステータスコードを確認し、以下の原因と解決策に照らし合わせます。
| HTTP ステータスコード | 原因 | 解決策 |
|---|---|---|
| 403 | サーバーが認可に失敗したため、リクエストを拒否しました。 | エンドポイントとトークンを確認してください。正しい値を取得するには、[Cluster Configurations] > [Access point information] に移動してください。Zipkin クライアントの場合は、URL に /v2/spans が含まれている場合、それも削除してください。 |
| 405 | レポートされたデータ量が設定済みのクォータに達しています。 | [Cluster Configurations] ページの [Quota configuration] セクションでクォータを引き上げてください。 |
| 406 | クラスターレベルのデータ収集が無効になっています。 | [Cluster Configurations] ページの [Ingestion Configuration] セクションで収集を有効にしてください。 |
| 400 | リクエストボディにサポートされていないデータ形式が含まれています。 | Content-Type ヘッダーを application/json または application/x-thrift に設定してください。タグのキーと値が文字列 (JSON 配列ではない) であること、またスパンが JSON オブジェクトではなく JSON 配列として送信されていることを確認してください。 |
APISIX 固有のエラー
次のエラーが表示される場合：
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 ステータスコードの一覧については、「Status codes and their use in 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 リクエストヘッダーの authorization フィールドが、Managed Service for OpenTelemetry コンソールに表示されているトークンと一致していることを確認してください。トークンを確認するには、[Cluster Configurations] > [Access point information] に移動してください。
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 クライアント設定でメトリックのレポートを無効化してください。
想定外のトレースデータのトラブルシューティング
データがコンソールに到達しているにもかかわらず、トレースが分断されている、または想定と異なる場合は、使用しているエージェントまたは SDK に応じて次のガイダンスを参照してください。
SkyWalking エージェントまたは SDK
フレームワークまたはミドルウェアのイベントの欠落
SkyWalking エージェントのプラグインディレクトリを確認します。SkyWalking v8 以降の場合、デフォルトパスは次のとおりです：
${agent-path}/agent-8.x/pluginsプラグインのバージョンが、アプリケーションで使用しているフレームワークのバージョンと一致していることを確認してください。必要なプラグインが不足している場合は、
bootstrap-pluginsまたはoptional-pluginsディレクトリからコピーするか、SkyWalking community からダウンロードしてください。アプリケーションにアタッチされているエージェントが 1 つだけであることを確認してください。複数のエージェントはインストルメンテーションの競合を引き起こす可能性があります。
トレースの分断
アプリケーションが非同期処理を使用しているかどうかを確認してください。非同期シナリオでは、トレースコンテキストが自動的に伝播しない場合があります。解決策については、SkyWalking ドキュメントの「Trace Cross Thread」をご参照ください。
想定より短いトレース
SkyWalking エージェントがレポートできるスパンの最大数を増やすには、次のファイル内の agent.span_limit を変更してください：
${agent-path}/agent-8.x/config/agent.configOpenTelemetry エージェントまたは SDK
トレースの分断
アプリケーションが非同期処理を使用しているかどうかを確認してください。非同期シナリオでトレースの分断を解決するには：
OpenTelemetry を最新バージョンに更新してください。
SpanLinks API を使用して、関連するスパンをリンクしてください。
親スパンを明示的に指定し、処理の関連付けを行ってください。
コンテキスト伝播 により、トレースコンテキストをダウンストリームサービスへ渡してください。