このドキュメントでは、トレース スコープを作成して管理する方法について説明します。これにより、[トレース エクスプローラ] ページで、表示または分析するトレーススパンを検索できます。Google Cloud プロジェクトで発生したスパンの表示と分析のみを行う場合は、トレース スコープを構成する必要はありません。ただし、マイクロサービス アーキテクチャを使用している場合など、トレースデータが複数のプロジェクトに保存されている場合は、いくつかの構成アクティビティを実行して、単一の Google Cloud プロジェクトのすべてのスパンを表示する必要があります。
このドキュメントでは、トレースやスパンを表示する方法については説明しません。このトピックの詳細については、トレースを検索して調査するをご覧ください。
トレース スコープについて
トレース スコープは、一連の Google Cloud プロジェクトを一覧表示する永続的なプロジェクト レベルのリソースです。トレース スコープで検索するように [Trace エクスプローラ] ページを構成できます。この場合、選択したスコープにリストされているプロジェクトが検索されます。ストレージからフェッチされて表示されるデータは、検索対象プロジェクトの Identity and Access Management（IAM）ロールと期間設定によって決まります。
Google Cloud プロジェクトを作成すると、_Default という名前のトレース スコープが作成されます。このスコープには、Google Cloud プロジェクトのみが含まれます。このスコープにプロジェクトを追加したり、このスコープを削除したりすることはできません。
トレース スコープを作成できます。また、作成したトレース スコープを変更、削除することもできます。スパンデータを複数の Google Cloud プロジェクトに書き込むサービスがある場合は、トレース スコープを作成します。
トレース スコープまたはトレース ID とスパン ID を含む URL を使用して [Trace エクスプローラ] ページを開かない限り、[Trace エクスプローラ] ページは、デフォルトのトレース スコープにリストされている Google Cloud プロジェクトをトレースデータで検索します。プロジェクトを作成するときに、_Default という名前のトレース スコープがデフォルト トレース スコープとして設定されます。ただし、デフォルトのトレース スコープとして使用する別のトレース スコープを選択できます。
始める前に
トレーススコープの作成と表示、デフォルトのトレーススコープの設定に必要な権限を取得するには、次の IAM ロールを付与するよう管理者に依頼してください。
-
トレーススコープを作成して表示し、デフォルトのトレーススコープを取得する: プロジェクトに対するCloud Trace ユーザー （
roles/cloudtrace.user） -
デフォルトのトレース スコープを設定するには: プロジェクトに対するオブザーバビリティ エディタ （
roles/observability.editor）
ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。
これらの事前定義ロールには、トレース スコープの作成と表示、デフォルト トレース スコープの設定に必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。
必要な権限
トレース スコープの作成と表示、デフォルトのトレース スコープの設定には、次の権限が必要です。
-
トレース スコープを作成、管理するには:
cloudtrace.traceScopes.[create, delete, get, list, update] -
デフォルトのトレース スコープを設定するには:
observability.scopes.[get, update]
カスタムロールや他の事前定義ロールを使用して、これらの権限を取得することもできます。
トレース スコープを一覧表示する
トレーススコープを一覧表示するには、次の操作を行います。
-
Google Cloud コンソールで、[settings設定] ページに移動します。
検索バーを使用してこのページを検索する場合は、小見出しが [Monitoring] である結果を選択します。
[トレース スコープ] タブを選択します。
表にトレース スコープが一覧表示されます。Google Cloud プロジェクトを選択すると、1 つのエントリに「デフォルト」アイコン
が表示されます。これは、デフォルトのトレース スコープであることを示します。[Trace エクスプローラ] ページが開くと、デフォルトのトレース スコープにリストされているプロジェクトでトレースデータが検索されます。
トレース スコープを作成
[Trace エクスプローラ] ページに表示されるスパンは、検索されたプロジェクト、それらのプロジェクトに対する IAM ロール、期間の設定、適用するフィルタによって異なります。
プロジェクトごとに作成できるトレース スコープは 100 個です。トレース スコープには合計 20 個のプロジェクトを含めることができます。
トレース スコープを作成する手順は次のとおりです。
-
Google Cloud コンソールで、[settings設定] ページに移動します。
検索バーを使用してこのページを検索する場合は、小見出しが [Monitoring] である結果を選択します。
- [トレース スコープ] タブを選択し、[トレース スコープを作成] をクリックします。
[プロジェクトを追加] をクリックして、ダイアログを完了します。
プロジェクトを追加すると、そのプロジェクトに保存されているスパンがトレース スコープに含まれます。スコープに含めるプロジェクトがわからない場合は、以前の トレース エクスプローラ ページを使用して特定できます。詳細については、このドキュメントのトレース スコープに移行するをご覧ください。
[トレース スコープに名前を付ける] セクションで、[トレース スコープ] タブに表示する名前と説明を入力します。
トレース スコープの名前は変更できません。また、プロジェクト内で一意にする必要があります。
[Create trace scope] をクリックします。
トレース スコープに移行する
[Trace エクスプローラ] ページでは、トレースデータの検索対象となる Google Cloud プロジェクトを指定する必要があります。これは、従来の [Trace エクスプローラ] ページとは動作が異なります。以前の [Trace エクスプローラ] ページでは、組織内のすべてのプロジェクトが検索されます。これらの違いにより、[Trace エクスプローラ] ページに、従来の [Trace エクスプローラ] ページに表示されるスパンが表示されない場合があります。
以前の [Trace エクスプローラ] ページの [トレースの詳細] ペイン セクションを使用すると、トレースデータを保存する Google Cloud プロジェクトのリストを作成できます。
以前の Trace エクスプローラ ページに移動します。
トレースを選択します。
次の方法をお試しください。
- [トレース ID] フィールドに ID を入力して、トレースを表示します。
- フィルタの追加。
[トレースの詳細] ペインでトレースを選択し、[プロジェクト] タブに移動します。
このタブには、トレースのスパンを保存するプロジェクトが一覧表示されます。
表示されたプロジェクトを含むトレース スコープを作成するには、[プロジェクト] タブのツールバーに移動し、[これらのプロジェクトでスコープを作成] を選択して、ダイアログを完了します。
プロジェクトのリストがコンパイルされるまで、上記の手順を繰り返します。
プロジェクトのリストをコンパイルしたら、トレース スコープを作成します。デフォルトのトレース スコープとして設定することもできます。
デフォルトのトレース スコープを設定する
[Trace エクスプローラ] ページが開くと、デフォルトのトレース スコープにリストされているプロジェクトでトレースデータが検索されます。そのトレース スコープにアクセスできない場合は、プロジェクトでトレースデータが検索されます。
プロジェクトが作成されると、_Default という名前のトレースコープが作成され、デフォルトのトレースコープとして指定されます。ただし、独自のトレース スコープを作成して、デフォルトのトレース スコープとして指定することはできます。
デフォルトのトレース スコープを設定するには、次の操作を行います。
-
Google Cloud コンソールで、[settings設定] ページに移動します。
検索バーを使用してこのページを検索する場合は、小見出しが [Monitoring] である結果を選択します。
- [トレース スコープ] タブを選択します。
デフォルトのトレース スコープとして指定するトレース スコープを見つけて、その more_vert [その他] をクリックし、[デフォルトに設定] を選択します。
選択したトレース スコープには、デフォルト アイコン
が表示されます。
トレース スコープを変更または削除する
_Default という名前のトレース スコープを削除または変更することはできません。他のすべてのトレース スコープは変更または削除できます。
トレース スコープを変更または削除する手順は次のとおりです。
-
Google Cloud コンソールで、[settings設定] ページに移動します。
検索バーを使用してこのページを検索する場合は、小見出しが [Monitoring] である結果を選択します。
- [トレース スコープ] タブを選択します。
変更または削除するトレース スコープを見つけて、more_vert [その他] をクリックしてから、次のいずれかを行います。
- 変更するには、[スコープを編集] を選択して、ダイアログを完了します。
- 削除するには、[スコープを削除] を選択して、ダイアログを完了します。
制限事項
トレース スコープの作成や管理には、Cloud Trace API または Google Cloud CLI は使用できません。
次のステップ
Cloud Logging と Cloud Monitoring には、表示またはモニタリングできるログデータまたは指標データを制御できる同様のコンストラクトが含まれています。これらのスコープの詳細については、次のドキュメントをご覧ください。