トラブルシューティング

このページには、Trace のトラブルシューティング情報が記載されています。

Trace インターフェースにデータがない

トレースデータがあるはずなのに Google Cloud プロジェクトでトレースを表示できない場合は、次の手順をお試しください。

Google Cloud コンソールのナビゲーションパネルで [API とサービス] を選択し、[API とサービスを有効化] をクリックして、Cloud Trace API を有効にします。
[Cloud Trace API の設定] に移動
[API が有効です] が表示されている場合、API はすでに有効になっています。そうでない場合は、[有効にする] ボタンをクリックします。

注: 組織のポリシーによって Cloud Trace API が無効になっている場合があります。これらのポリシーにより、API は有効にできません。
Google Cloud コンソールのナビゲーションパネルで、[API とサービス] を選択し、[Cloud Trace API]　というラベルの付いた行を見つけます。

[API とサービス] 設定に移動

次のようにしてください。
- [リクエスト] というラベルが付いた列に数値情報が表示されていない場合、Google Cloud プロジェクトにトレースデータが送信されていません。
  
  この問題を解決するには、アプリケーションとプロキシが正しいプロジェクトにトレースを送信するように構成されていることを確認します。
- [Cloud Trace API] を選択し、[指標] タブを選択して、[API メソッド別のエラー数] というラベルが付いたグラフを見つけます。
  - 書き込みが失敗した場合は、認証情報を提供するサービスアカウントに Cloud Trace エージェント（roles/cloudtrace.agent）のロールを付与します。このロールには、権限 cloudtrace.traces.patch が含まれています。この権限により、アプリケーションがスパンデータを Google Cloud プロジェクトに書き込むことができます。
    
    詳しくは、Cloud Trace IAM のロールをご覧ください。
  - 読み取りが失敗した場合は、Google Cloud プロジェクトの IAM ロールに Cloud Trace ユーザー（roles/cloutrace.user）のロールの権限が含まれていることを確認します。このロールの権限の一覧については、Cloud Trace の IAM ロールをご覧ください。

OpenTelemetry を使用するように Go アプリを更新した後のトレースデータがない

アプリケーションはクライアントライブラリを使用してトレースをキャプチャします。OpenTelemetry を使用するようにアプリケーションを更新すると、Cloud Trace データが表示されなくなります。

一部の Go 用 Google クライアントライブラリは OpenCensus と統合されているため、OpenCensus ブリッジを使用する必要があります。このブリッジによって解決される問題については、OpenCensus Bridge をご覧ください。

Go 用 Google クライアントライブラリの更新については、Issue #4237 をご覧ください。

デプロイされたアプリのトレースデータがない

Cloud Trace API を使用して Google Cloud プロジェクトにデータを送信するアプリをデプロイしましたが、トレースデータは収集されません。

次のようにしてください。

Google Cloud コンソールの [Trace エクスプローラ] ページをにデータが表示されない場合は、Trace インターフェースにデータがないというタイトルのセクションの手順に沿って作業します。
アプリが Google Cloud にデプロイされていない場合や、サービスアカウントを使用して認証情報を提供する場合は、サービスアカウントに Cloud Trace エージェント（roles/cloudtrace.agent）のロールが付与されていることを確認してください。

このロールには、アプリケーションがスパンデータを Google Cloud プロジェクトに書き込むための権限 cloudtrace.traces.patch が含まれています。
アプリが OpenTelemetry を使用している場合は、次のようにします。
- ルートサービスの場合、OpenTelemetry がサンプリングレート 0.5 で traceidratio サンプラーを使用するように、環境変数の更新を試みます。
```
export OTEL_TRACES_SAMPLER="traceidratio"
export OTEL_TRACES_SAMPLER_ARG="0.5"
```
- 他のすべてのサービスでは、OTEL_TRACES_SAMPLER 環境変数を設定せずに、デフォルトのサンプラー（parentbased_always_on）を使用します。デフォルト設定では、スパンのサンプリング決定が親スパンから継承されます（そのようなスパンが存在する場合）。親スパンが存在しない場合は、スパンがサンプリングされます。
アプリケーションが常にすべてのスパンをサンプリングしない限り、一般に、リクエストをエンドツーエンドでトレースすることはできません。それは、エンドツーエンドリクエストの各コンポーネントはサンプリングの決定を独自に行うためです。ただし、トレースヘッダーに sampled フラグを追加して、このフラグを true に設定することで、決定に影響を与えることができます。この設定は、子コンポーネントがリクエストをサンプリングするヒントです。トレースヘッダーの詳細については、コンテキスト伝播用のプロトコルをご覧ください。

トレースにスパン ID メッセージが見つからない

トレースに「スパン ID が見つかりません」というメッセージが含まれています。

分散トレースシステムでは、不完全なトレースが想定されます。サンプリングされたスパンに、受信されていない別のスパンへの参照が含まれている場合、トレースは不完全です。未解決の参照は、次の理由により発生する可能性があります。

参照されたスパンがサンプリングされませんでした。
参照されたスパンがサンプリングされましたが、Cloud Trace でまだ受信されていないか、スパンを受信したが保存されていません。

不完全なトレースを表示すると、Cloud Trace のトレースの詳細ペインに「スパン ID がありません」というメッセージが表示されます。

「スパン ID がありません」というメッセージが常に表示される場合は、次のことをお試しください。

管理するコンポーネントについて、このフィールドが存在する場合は、ヘッダーの sampled フラグフラグを尊重して伝播するようにします。この設定は、子コンポーネントがリクエストをサンプリングするためのヒントです。トレースヘッダーの詳細については、コンテキスト伝播用のプロトコルをご覧ください。

通常、Google Cloud サービスでは、このヒントが尊重されます。ただし、トレースデータを書き込むレートも制限されます。
Anthos Service Mesh を使用している場合は、それらの構成におけるトレースコンテキストの伝播についてのガイダンスに従ってください。Anthos Service Mesh のガイダンスについては、トレースコンテキストの伝播をご覧ください。