このドキュメントでは、[Trace エクスプローラ] ページで表示しているデータを他のユーザーまたはグループと共有する方法について説明します。たとえば、トレースデータにデータの異常や傾向が見られ、そのデータを別のユーザーが詳しく調査することを希望する場合などです。また、個々のトレースまたはスパンにエラーや予期しないレイテンシ値があり、調査を依頼したい場合もあります。
ベスト プラクティス
トラブルシューティングを容易にするため、プロジェクトのトレースデータを表示する必要があるすべてのユーザー、グループ、ドメインに、そのプロジェクトに対する Cloud Trace ユーザーロール（roles/cloudtrace.user）を付与することをおすすめします。このロールにより、プリンシパルにトレースデータの表示に必要な権限が付与されます。
始める前に
Google Cloud コンソールを使用してトレースデータを表示するために必要な権限を取得するには、トレースデータを保存するプロジェクトに対するCloud Trace ユーザー （roles/cloudtrace.user）IAM ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織へのアクセスを管理するをご覧ください。
必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。
トレースデータを共有する
[Trace エクスプローラ] ページを使用してトレースデータを調査すると、選択内容に応じてブラウザの URL が更新されます。たとえば、フィルタを追加したり期間を設定したりすると、ページの URL が変更されます。同様に、スパンまたはトレースを選択すると、URL が更新され、スパン ID とトレース ID が含まれるようになります。
そのため、表示しているデータを他のユーザーと共有するには、ページの URL をコピーして共有します。受信者が URL をブラウザに貼り付けると、URL に含まれる設定が [Trace Explorer] ページのデフォルト設定をオーバーライドします。表示されるデータは、URL で参照されるプロジェクトに対する受信者の IAM ロールによって異なります。
トレースデータを共有する手順は次のとおりです。
-
Google Cloud コンソールで、[Trace エクスプローラ] ページに移動します。
このページは、検索バーを使用して見つけることもできます。
共有するデータを表示するように [Trace エクスプローラ] ページを構成します。
たとえば、フィルタを追加したり、期間セレクタを更新したり、トレースデータの検索対象となるプロジェクトを制御する [スコープ] 要素を変更したりできます。
[スコープ] 要素の最初のメニューが
[プロジェクト] または 
[_デフォルト] に設定されている場合、プロジェクトでトレースデータが検索されます。それ以外の場合は、トレース スコープにリストされているプロジェクトが検索されます。詳細については、トレース スコープの作成と管理をご覧ください。トレースまたはスパンの URL を共有するには、次のいずれかの方法で、そのトレースまたはスパンの [詳細] フライアウトを開きます。
ツールバーで [pageview Search for trace] をクリックし、トレース ID を入力します。
スパンを検索して選択します。
ブラウザで URL をコピーし、その URL を共有します。
トラブルシューティング
スパンがトレースにない場合や、[Trace エクスプローラ] ページにデータが表示されない場合などの問題を解決する方法については、トラブルシューティングをご覧ください。