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