トレース スコープを作成して管理する

トレース スコープを作成して管理できます。これにより、複数のプロジェクトに保存されているトレースデータを [Trace エクスプローラ] ページで検索できます。 Google Cloud プロジェクトで発生したスパンのみを表示して分析する場合は、トレース スコープを構成する必要はありません。

トレースとスパンを表示する方法については、トレースを検索して調査するをご覧ください。

トレース スコープについて

トレース スコープを使用すると、複数のプロジェクトに保存されているトレースデータの集計ビューを表示できます。これらのスコープは、ビューを一覧表示するプロジェクト レベルの永続的なリソースです。各ビューは、プロジェクトによって保存されたトレースデータへのアクセスを提供します。[Trace エクスプローラ] などのページでは、トレース スコープを使用してデータの検索場所を特定します。ただし、これらのページでは、これらのリソースに対する Identity and Access Management（IAM）ロールを使用して、検出されたデータを表示する権限があるかどうかを判断します。

トレース スコープを作成するときは、名前とプロジェクトのリストを指定します。システムは、パス _Trace/Spans/_AllSpans を持つ各プロジェクトのデフォルトのトレースビューを自動的に含めます。パスフィールド _Trace、Spans、_AllSpans は、オブザーバビリティ バケット、データを保存するデータセット、データセットのビューを参照します。_AllSpans ビューを使用すると、プロジェクトに保存されているすべてのトレースデータにアクセスできます。

[Trace エクスプローラ] ページには、トレース スコープを選択できるオプションがあります。選択すると、ページでトレース スコープにリストされているビューが検索され、表示が更新されます。

ブラウザの URL をコピーして、構成したビューを共有することもできます。URL には、選択したトレース スコープとその他のページ設定がエンコードされ、リンクを開いたユーザーのデフォルトのスコープ選択がオーバーライドされます。詳細については、トレースとスパンを共有するをご覧ください。

1 つのトレース スコープを「デフォルト」として指定できます。この指定を行うと、次のようになります。

• オブザーバビリティ スコープが更新されます。このスコープには、デフォルトのログスコープとデフォルトのトレース スコープへのポインタが含まれています。これにより、データが複数のプロジェクトに保存されている場合に、システムがログデータとトレースデータを関連付けることができます。詳細については、マルチプロジェクト クエリのオブザーバビリティ スコープを構成するをご覧ください。

• システムは、[Trace エクスプローラ] ページでトレースデータの検索に自動的に使用されるトレース スコープを更新します。ページがデフォルトのトレース スコープにアクセスできない場合、プロジェクトでトレースデータが検索されます。

作成したトレース スコープは変更および削除できます。

App Hub アプリケーションとトレーススコープ

App Hub アプリケーションは、トレースデータを複数のプロジェクトに書き込む場合があります。このデータの集計ビューを取得するには、トレース スコープを作成し、トレースデータを保存するすべてのプロジェクトのデフォルトのトレースビューを一覧表示するように構成してから、デフォルトのトレース スコープとして構成します。これらの手順を完了すると、アプリケーションによって書き込まれたデータが [Trace Explorer] ページに自動的に表示されます。このデータは、異なるプロジェクトに保存されている場合でも表示されます。

トレースデータを表示するプロジェクトにカスタム トレース スコープを作成します。このプロジェクトは、App Hub ホスト プロジェクトまたは管理プロジェクトです。たとえば、フォルダの表示名が My Folder の場合、フォルダの管理プロジェクトの表示名は My Folder-mp になります。

始める前に

プロジェクトと IAM ロールを構成し、使用するインターフェースを選択します。

プロジェクトとロールを構成する

Google Cloud アカウントにログインします。 Google Cloudを初めて使用する場合は、 アカウントを作成して、実際のシナリオでの Google プロダクトのパフォーマンスを評価してください。新規のお客様には、ワークロードの実行、テスト、デプロイができる無料クレジット $300 分を差し上げます。

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Observability API.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the API

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Observability API.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the API

1. トレーススコープの作成と表示に必要な権限を取得するには、プロジェクトに対するオブザーバビリティ スコープ編集者 （roles/observability.scopesEditor）の IAM ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織に対するアクセス権の管理をご覧ください。

   この事前定義ロールには、トレーススコープの作成と表示に必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。

   必要な権限

   トレース スコープを作成して表示するには、次の権限が必要です。

   • observability.traceScopes.{create, delete, get, list, update}
   • observability.scopes.{get, update}

   カスタムロールや他の事前定義ロールを使用して、これらの権限を取得することもできます。

使用するインターフェースを選択する

コンソール

Google Cloud コンソールを使用して Google Cloud サービスと API にアクセスする場合、認証を設定する必要はありません。

gcloud

Google Cloud コンソールで Cloud Shell をアクティブにします。

Cloud Shell をアクティブにする

Google Cloud コンソールの下部にある Cloud Shell セッションが開始し、コマンドライン プロンプトが表示されます。Cloud Shell はシェル環境です。Google Cloud CLI がすでにインストールされており、現在のプロジェクトの値もすでに設定されています。セッションが初期化されるまで数秒かかることがあります。

Terraform

ローカル開発環境でこのページの Terraform サンプルを使用するには、gcloud CLI をインストールして初期化し、ユーザー認証情報を使用してアプリケーションのデフォルト認証情報を設定します。

1. Google Cloud CLI をインストールします。

2. 外部 ID プロバイダ（IdP）を使用している場合は、まず連携 ID を使用して gcloud CLI にログインする必要があります。

3. ローカルシェルを使用している場合は、ユーザー アカウントのローカル認証情報を作成します。

   gcloud auth application-default login

   Cloud Shell を使用している場合は、この操作を行う必要はありません。

   認証エラーが返され、外部 ID プロバイダ（IdP）を使用している場合は、 フェデレーション ID を使用して gcloud CLI にログインしていることを確認します。

詳細については、 Google Cloud 認証ドキュメントの ローカル開発環境の ADC の設定をご覧ください。

REST

このページの REST API サンプルをローカル開発環境で使用するには、gcloud CLI に指定した認証情報を使用します。

Google Cloud CLI をインストールします。

外部 ID プロバイダ（IdP）を使用している場合は、まず連携 ID を使用して gcloud CLI にログインする必要があります。

詳細については、 Google Cloud 認証ドキュメントの REST を使用して認証するをご覧ください。

トレース スコープを一覧表示する

コンソール

トレーススコープを一覧表示するには、次の操作を行います。

1. Google Cloud コンソールで [ 設定] ページに移動します。

   [設定] に移動

   検索バーを使用してこのページを検索する場合は、小見出しが [Monitoring] の結果を選択します。

2. Google Cloud コンソールのツールバーで、 Google Cloud プロジェクトを選択します。App Hub の構成には、App Hub ホスト プロジェクトまたは管理プロジェクトを選択します。

3. [トレース スコープ] タブを選択します。

   ウィンドウにトレース スコープのリストが表示されます。「デフォルト」アイコン が含まれているエントリがデフォルトのトレース スコープです。

4. トレース スコープの詳細を表示するには、トレース スコープを開きます。

   トレース スコープを展開すると、そのスコープに含まれるビューのリストが表示されます。各行には、プロジェクト ID と _Trace/Spans/_AllSpans などのエントリが一覧表示されます。これは、トレースデータのデフォルトの保存場所を識別します。_Trace、Spans、_AllSpans の各フィールドは、トレースデータのオブザーバビリティ バケット、データセット、ビューを参照します。_AllSpans ビューは、バケット内のすべてのエントリに対応します。

   名前	説明	タイプ	リソース
   _Default		Trace scope	1
   myscope	My description	Trace scope	2
   _Trace/Spans/_AllSpans	myproject	Trace view
   _Trace/Spans/_AllSpans	project-b	Trace view

gcloud

注: gcloud CLI バージョン 563.0.0 以降を使用する必要があります。

後述のコマンドデータを使用する前に、次のように置き換えます。

• LOCATION: トレーススコープのロケーション。このフィールドの値は global である必要があります。
• PROJECT_ID: プロジェクトの ID。

gcloud observability trace-scopes list コマンドを実行します。

Linux、macOS、Cloud Shell

gcloud observability trace-scopes list \
 --location=LOCATION --project=PROJECT_ID

Windows（PowerShell）

gcloud observability trace-scopes list `
 --location=LOCATION --project=PROJECT_ID

Windows（cmd.exe）

gcloud observability trace-scopes list ^
 --location=LOCATION --project=PROJECT_ID

レスポンス データはトレース スコープのリストです。各スコープの名前と関連情報が表示されます。たとえば、次の図は、2 つのトレース スコープを持つプロジェクトの list コマンドの結果を示しています。

name: projects/my-project/locations/global/traceScopes/_Default
resourceNames:
- projects/my-project
---
createTime: '2026-03-26T13:43:54.772326947Z'
description: a test
name: projects/my-project/locations/global/traceScopes/my-test-scope
resourceNames:
- projects/another-project
- projects/my-project
updateTime: '2026-03-26T13:43:54.772326947Z'

Terraform

Terraform を使用してトレーススコープの作成と変更を行うことができます。ただし、Terraform を使用してトレーススコープを一覧表示することはできません。

REST

Google Cloud プロジェクト内のすべてのトレーススコープを一覧表示するには、projects.locations.traceScopes.list コマンドを使用します。パスパラメータを指定する必要があります。

このエンドポイントのパスパラメータの構文は次のとおりです。

projects/PROJECT_ID/locations/LOCATION_ID/traceScopes

前の式のフィールドの意味は次のとおりです。

• PROJECT_ID: プロジェクトの ID。App Hub の構成には、App Hub ホスト プロジェクトまたは管理プロジェクトを選択します。
• LOCATION_ID は global に設定する必要があります。

レスポンスは TraceScope オブジェクトの配列です。各オブジェクトには、名前とリソースのリストが含まれます。

特定のトレース スコープに関する情報を取得するには、projects.locations.traceScopes.get コマンドを使用します。

トレース スコープを作成する

[Trace エクスプローラ] ページに表示されるスパンは、検索されたビュー、それらのビューに対する IAM ロール、期間の設定、適用するフィルタによって異なります。

警告: トレース スコープにリストされているすべてのビューが、同じロケーションにトレースデータを保存していることを確認してください。システムは、トレースデータを _Trace という名前のオブザーバビリティ バケットに保存します。トレースデータが保存されている場所を表示する方法については、オブザーバビリティ バケットを一覧表示するをご覧ください。

プロジェクトごとに作成できるトレース スコープは 100 個までです。トレース スコープに含めることができるビューは合計 20 個です。

コンソール

トレース スコープを作成する手順は次のとおりです。

1. Google Cloud コンソールで [ 設定] ページに移動します。

   [設定] に移動

   検索バーを使用してこのページを検索する場合は、小見出しが [Monitoring] の結果を選択します。

2. Google Cloud コンソールのツールバーで、 Google Cloud プロジェクトを選択します。App Hub の構成には、App Hub ホスト プロジェクトまたは管理プロジェクトを選択します。
3. [トレースのスコープ] タブを選択し、[トレースのスコープを作成] をクリックします。

4. [プロジェクトを追加] をクリックして、ダイアログを完了します。

   注: プロジェクトを選択すると、プロジェクトのデフォルトのトレースビューがスコープに追加されます。

5. [トレース スコープの指定] セクションで、[トレース スコープ] タブに表示する名前と説明を入力します。

   トレース スコープの名前は変更できません。また、プロジェクト内で一意にする必要があります。

6. [トレーススコープを作成] をクリックします。

   デフォルトでは、[トレース スコープ] テーブルにトレース スコープが折りたたまれた形式で一覧表示されます。各スコープについて、テーブルには名前、説明、タイプ、リソースの数が表示されます。

   トレース スコープを展開すると、そのスコープに含まれるビューのリストが表示されます。各行には、プロジェクト ID と _Trace/Spans/_AllSpans などのエントリが一覧表示されます。このエントリは、トレースデータのデフォルトの保存場所を識別します。_Trace、Spans、_AllSpans の各フィールドは、トレースデータのオブザーバビリティ バケット、データセット、ビューを参照します。_AllSpans ビューは、バケット内のすべてのエントリに対応します。

   名前	説明	タイプ	リソース
   _Default		Trace scope	1
   myscope	My description	Trace scope	2
   _Trace/Spans/_AllSpans	myproject	Trace view
   _Trace/Spans/_AllSpans	project-b	Trace view

gcloud

注: gcloud CLI バージョン 563.0.0 以降を使用する必要があります。

後述のコマンドデータを使用する前に、次のように置き換えます。

• TRACE_SCOPE_NAME: トレース スコープの名前。例: my-trace-scope
• DESCRIPTION: 省略可。トレース スコープの説明。説明を文字列としてフォーマットします。
• RESOURCE_NAMES: プロジェクトの完全修飾名のカンマ区切りのリスト。例: projects/my-project
• LOCATION: トレーススコープのロケーション。このフィールドの値は global である必要があります。
• PROJECT_ID: プロジェクトの ID。

gcloud observability trace-scopes create コマンドを実行します。

Linux、macOS、Cloud Shell

gcloud observability trace-scopes create TRACE_SCOPE_NAME \
 --description=DESCRIPTION \
 --resource-names=RESOURCE_NAMES \
 --location=LOCATION --project=PROJECT_ID

Windows（PowerShell）

gcloud observability trace-scopes create TRACE_SCOPE_NAME `
 --description=DESCRIPTION `
 --resource-names=RESOURCE_NAMES `
 --location=LOCATION --project=PROJECT_ID

Windows（cmd.exe）

gcloud observability trace-scopes create TRACE_SCOPE_NAME ^
 --description=DESCRIPTION ^
 --resource-names=RESOURCE_NAMES ^
 --location=LOCATION --project=PROJECT_ID

成功すると、create コマンドのレスポンスに新しいトレース スコープの名前が含まれます。

Created traceScope [my-test-scope].

Terraform

Terraform 構成を適用または削除する方法については、基本的な Terraform コマンドをご覧ください。詳細については、Terraform プロバイダのリファレンス ドキュメントをご覧ください。

Terraform を使用してプロジェクトにトレーススコープを作成するには、Terraform リソース google_observability_trace_scope を使用します。

コマンドで、次のフィールドを設定します。

• project: プロジェクト、フォルダ、または組織の名前。例: my-projectApp Hub の構成には、App Hub ホスト プロジェクトまたは管理プロジェクトを選択します。

  注: システムはプロジェクトをスコープに追加しません。代わりに、プロジェクトの Spans データセットに _AllSpans ビューが追加されます。

• trace_scope_id: スコープ ID に設定します。例: my-trace-scope

• location: "global" に設定します。

• resource_names: プロジェクトの配列。各プロジェクトは完全修飾名で指定します。

• description: 簡単な説明。たとえば、「本番環境リソースのスコープ」などです。

REST

トレース スコープを作成するには、projects.locations.traceScopes.create コマンドを使用します。パスパラメータを指定し、TraceScope オブジェクトを指定する必要があります。レスポンスは TraceScope オブジェクトです。

このエンドポイントのパスパラメータの構文は次のとおりです。

projects/PROJECT_ID/locations/LOCATION_ID/traceScopes

前の式のフィールドの意味は次のとおりです。

• PROJECT_ID: プロジェクトの ID。App Hub の構成には、App Hub ホスト プロジェクトまたは管理プロジェクトを選択します。
• LOCATION_ID は global に設定する必要があります。

トレース スコープを変更する

_Default という名前のトレース スコープは変更できません。他のすべてのトレース スコープは変更できます。

コンソール

トレース スコープを変更するには、次の操作を行います。

1. Google Cloud コンソールで [ 設定] ページに移動します。

   [設定] に移動

   検索バーを使用してこのページを検索する場合は、小見出しが [Monitoring] の結果を選択します。

2. Google Cloud コンソールのツールバーで、 Google Cloud プロジェクトを選択します。App Hub の構成には、App Hub ホスト プロジェクトまたは管理プロジェクトを選択します。
3. [トレース スコープ] タブを選択します。
4. 変更するトレース スコープを見つけて、 [その他] をクリックし、[スコープを編集] を選択して、ダイアログを完了します。

gcloud

注: gcloud CLI バージョン 563.0.0 以降を使用する必要があります。

後述のコマンドデータを使用する前に、次のように置き換えます。

• TRACE_SCOPE_NAME: トレース スコープの名前。例: my-trace-scope
• DESCRIPTION: 省略可。トレース スコープの説明。説明を文字列としてフォーマットします。
• RESOURCE_NAMES: プロジェクトの完全修飾名のカンマ区切りのリスト。たとえば、projects/my-project などです。
• LOCATION: トレーススコープのロケーション。このフィールドの値は global である必要があります。
• PROJECT_ID: プロジェクトの ID。

gcloud observability trace-scopes update コマンドを実行します。

Linux、macOS、Cloud Shell

gcloud observability trace-scopes update TRACE_SCOPE_NAME \
 --description=DESCRIPTION \
 --resource-names=RESOURCE_NAMES \
 --location=LOCATION --project=PROJECT_ID

Windows（PowerShell）

gcloud observability trace-scopes update TRACE_SCOPE_NAME `
 --description=DESCRIPTION `
 --resource-names=RESOURCE_NAMES `
 --location=LOCATION --project=PROJECT_ID

Windows（cmd.exe）

gcloud observability trace-scopes update TRACE_SCOPE_NAME ^
 --description=DESCRIPTION ^
 --resource-names=RESOURCE_NAMES ^
 --location=LOCATION --project=PROJECT_ID

成功すると、update コマンドのレスポンス データに更新されたトレース スコープが表示されます。

Updated traceScope [my-test-scope].
createTime: '2026-03-26T13:43:54.772326947Z'
description: A scope for testing
name: projects/my-project/locations/global/traceScopes/my-test-scope
resourceNames:
- projects/another-project
- projects/my-project
updateTime: '2026-03-26T13:48:05.262142872Z'

Terraform

Terraform 構成を適用または削除する方法については、基本的な Terraform コマンドをご覧ください。詳細については、Terraform プロバイダのリファレンス ドキュメントをご覧ください。

Terraform を使用してプロジェクトのトレース スコープを変更するには、Terraform リソース google_observability_trace_scope を使用します。

REST

トレース スコープを変更するには、projects.locations.traceScopes.patch コマンドを使用します。パスパラメータとクエリ パラメータを指定し、TraceScope オブジェクトを指定する必要があります。クエリ パラメータは、変更されるフィールドを特定します。レスポンスは TraceScope オブジェクトです。

このエンドポイントのパスパラメータの構文は次のとおりです。

projects/PROJECT_ID/locations/LOCATION_ID/traceScopes/TRACE_SCOPE_NAME

前の式のフィールドの意味は次のとおりです。

• PROJECT_ID: プロジェクトの ID。App Hub の構成には、App Hub ホスト プロジェクトまたは管理プロジェクトを選択します。
• LOCATION_ID は global に設定する必要があります。
• TRACE_SCOPE_NAME: トレース スコープの名前。例: my-trace-scope

トレース スコープを削除する

_Default という名前のトレーススコープは削除できません。他のトレース スコープはすべて削除できます。

コンソール

トレース スコープを削除するには、次の操作を行います。

1. Google Cloud コンソールで [ 設定] ページに移動します。

   [設定] に移動

   検索バーを使用してこのページを検索する場合は、小見出しが [Monitoring] の結果を選択します。

2. Google Cloud コンソールのツールバーで、 Google Cloud プロジェクトを選択します。App Hub の構成には、App Hub ホスト プロジェクトまたは管理プロジェクトを選択します。
3. [トレース スコープ] タブを選択します。
4. 削除するトレース スコープを見つけて、 [その他] をクリックし、[スコープの削除] を選択して、ダイアログを完了します。

gcloud

注: gcloud CLI バージョン 563.0.0 以降を使用する必要があります。

後述のコマンドデータを使用する前に、次のように置き換えます。

• TRACE_SCOPE_NAME: トレース スコープの名前。例: my-trace-scope
• LOCATION: トレーススコープのロケーション。このフィールドの値は global である必要があります。
• PROJECT_ID: プロジェクトの ID。

gcloud observability trace-scopes delete コマンドを実行します。

Linux、macOS、Cloud Shell

gcloud observability trace-scopes delete TRACE_SCOPE_NAME \
 --location=LOCATION --project=PROJECT_ID

Windows（PowerShell）

gcloud observability trace-scopes delete TRACE_SCOPE_NAME `
 --location=LOCATION --project=PROJECT_ID

Windows（cmd.exe）

gcloud observability trace-scopes delete TRACE_SCOPE_NAME ^
 --location=LOCATION --project=PROJECT_ID

delete コマンドを発行すると、アクションの確認を求めるプロンプトが表示されます。実行例を次に示します。

You are about to delete traceScope [my-test-scope]

Do you want to continue (Y/n)?  Y

Deleted traceScope [my-test-scope].

Terraform

Terraform 構成を適用または削除する方法については、基本的な Terraform コマンドをご覧ください。詳細については、Terraform プロバイダのリファレンス ドキュメントをご覧ください。

Terraform を使用してプロジェクトのトレース スコープを削除するには、Terraform リソース google_observability_trace_scope を使用します。

REST

トレース スコープを削除するには、projects.locations.traceScopes.delete コマンドを使用します。パスパラメータを指定する必要があります。

このエンドポイントのパスパラメータの構文は次のとおりです。

projects/PROJECT_ID/locations/LOCATION_ID/traceScopes/TRACE_SCOPE_NAME

前の式のフィールドの意味は次のとおりです。

• PROJECT_ID: プロジェクトの ID。App Hub の構成には、App Hub ホスト プロジェクトまたは管理プロジェクトを選択します。
• LOCATION_ID は global に設定する必要があります。
• TRACE_SCOPE_NAME: トレース スコープの名前。例: my-trace-scope

デフォルトのトレース スコープを構成する

[Trace エクスプローラ] ページが開くと、デフォルトのトレース スコープにリストされているビューでトレースデータが検索されます。デフォルトのスコープにアクセスできない場合、このページではプロジェクトでトレースデータが検索されます。この検索は、デフォルトのデータセットでプロジェクトの _AllSpans ビューをクエリするのと同等です。

プロジェクトが作成されると、_Default という名前のトレース スコープが作成され、デフォルトのトレース スコープとして指定されます。ただし、独自のトレース スコープを作成して、デフォルトのトレース スコープとして指定することはできます。

コンソール

デフォルトのトレース スコープを設定するには、次の操作を行います。

1. Google Cloud コンソールで [ 設定] ページに移動します。

   [設定] に移動

   検索バーを使用してこのページを検索する場合は、小見出しが [Monitoring] の結果を選択します。

2. Google Cloud コンソールのツールバーで、 Google Cloud プロジェクトを選択します。App Hub の構成には、App Hub ホスト プロジェクトまたは管理プロジェクトを選択します。

3. [トレース スコープ] タブを選択します。

   このタブには、トレース スコープが表示され、カスタム トレース スコープを作成するためのボタンが含まれています。「デフォルト」アイコン が表示されているトレース スコープが、現在のデフォルトのトレース スコープです。

4. デフォルトのトレース スコープを変更するには、デフォルトのトレース スコープとして指定するトレース スコープを見つけて、その  [その他] をクリックし、[デフォルトに設定] を選択します。

   選択したトレース スコープにデフォルト アイコン が表示されます。

gcloud

注: gcloud CLI バージョン 563.0.0 以降を使用する必要があります。

オブザーバビリティ スコープを表示して更新するには、次の操作を行います。

1. オブザーバビリティ スコープの設定を表示するには、gcloud observability scopes describe コマンドを実行します。

   後述のコマンドデータを使用する前に、次のように置き換えます。

   • OBSERVABILITY_SCOPE_ID: Scope オブジェクトの名前。この値は _Default に設定する必要があります。
   • LOCATION: ロケーション フィールドは global に設定する必要があります。
   • PROJECT_ID: プロジェクトの ID。

   gcloud observability scopes describe コマンドを実行します。

   Linux、macOS、Cloud Shell

   gcloud observability scopes describe OBSERVABILITY_SCOPE_ID \
      --location=LOCATION\
      --project=PROJECT_ID

   Windows（PowerShell）

   gcloud observability scopes describe OBSERVABILITY_SCOPE_ID `
      --location=LOCATION`
      --project=PROJECT_ID

   Windows（cmd.exe）

   gcloud observability scopes describe OBSERVABILITY_SCOPE_ID ^
      --location=LOCATION^
      --project=PROJECT_ID

   コマンドに対するレスポンスは次のようになります。

   logScope: logging.googleapis.com/projects/my-project/locations/global/logScopes/_Default
   traceScope: projects/my-project/locations/global/traceScopes/_Default
   name: projects/my-project/locations/global/scopes/_Default
   

2. オブザーバビリティ スコープを更新するには、gcloud observability scopes update コマンドを実行します。update コマンドでは、--log-scope フラグ、--trace-scope フラグ、または両方のフラグを指定できます。

   後述のコマンドデータを使用する前に、次のように置き換えます。

   • OBSERVABILITY_SCOPE_ID: Scope オブジェクトの名前。この値は _Default に設定する必要があります。
   • LOG_SCOPE_FQN_ID: ログスコープの完全修飾リソース名。このフィールドの形式は次のとおりです。

     logging.googleapis.com/projects/PROJECT_ID/locations/LOCATION/logScopes/LOG_SCOPE_ID

     上記の式で、LOG_SCOPE_ID はログスコープの ID です。例: my-scope。

   • TRACE_SCOPE_FQN_ID: トレーススコープの完全修飾リソース名。このフィールドの形式は次のとおりです。

     projects/PROJECT_ID/locations/LOCATION/traceScopes/TRACE_SCOPE_NAME

     上記の式で、TRACE_SCOPE_NAME はトレース スコープの名前です。例: my-trace-scope

   • LOCATION: ロケーション フィールドは global に設定する必要があります。
   • PROJECT_ID: プロジェクトの ID。

   gcloud observability scopes update コマンドを実行します。

   Linux、macOS、Cloud Shell

   gcloud observability scopes update OBSERVABILITY_SCOPE_ID \
      --log-scope=LOG_SCOPE_FQN_ID\
      --trace-scope=TRACE_SCOPE_FQN_ID\
      --location=LOCATION\
      --project=PROJECT_ID

   Windows（PowerShell）

   gcloud observability scopes update OBSERVABILITY_SCOPE_ID `
      --log-scope=LOG_SCOPE_FQN_ID`
      --trace-scope=TRACE_SCOPE_FQN_ID`
      --location=LOCATION`
      --project=PROJECT_ID

   Windows（cmd.exe）

   gcloud observability scopes update OBSERVABILITY_SCOPE_ID ^
      --log-scope=LOG_SCOPE_FQN_ID^
      --trace-scope=TRACE_SCOPE_FQN_ID^
      --location=LOCATION^
      --project=PROJECT_ID

   たとえば、LOG_SCOPE_ID の値が my-log-scope で、TRACE_SCOPE_NAME の値が my-trace-scope の場合、レスポンスは次のようになります。

   Updated scope [_Default].
   logScope: logging.googleapis.com/projects/my-project/locations/global/logScopes/my-log-scope
   traceScope: projects/my-project/locations/global/traceScopes/my-trace-scope
   name: projects/my-project/locations/global/scopes/_Default
   

Terraform

Terraform を使用してトレーススコープの作成と変更を行うことができます。ただし、Terraform を使用してデフォルトのトレース スコープを設定することはできません。

REST

API 呼び出しを使用してデフォルトのログスコープまたはデフォルトのトレース スコープを取得して設定するには、オブザーバビリティ スコープを構成します。オブザーバビリティ スコープには、デフォルトのログスコープとデフォルトのトレース スコープがリストで示されます。

• プロジェクトのデフォルトのオブザーバビリティ スコープを取得するには、projects.locations.scopes.get エンドポイントにリクエストを送信します。パスパラメータを指定する必要があります。レスポンスは、デフォルトのログスコープとデフォルトのトレース スコープをリストで示す Scope オブジェクトです。
• プロジェクトのデフォルトのオブザーバビリティ スコープを更新するには、projects.locations.scopes.patch エンドポイントにリクエストを送信します。パスパラメータとクエリ パラメータを指定し、Scope オブジェクトを指定する必要があります。クエリ パラメータは、変更されるフィールドを特定します。レスポンスは Scope オブジェクトです。

どちらのエンドポイントのパスパラメータも次の形式になります。

projects/PROJECT_ID/locations/LOCATION/scopes/OBSERVABILITY_SCOPE_ID

前の式のフィールドの意味は次のとおりです。

• PROJECT_ID: プロジェクトの ID。App Hub の構成には、App Hub ホスト プロジェクトまたは管理プロジェクトを選択します。
• LOCATION: ロケーション フィールドは global に設定する必要があります。
• OBSERVABILITY_SCOPE_ID: Scope オブジェクトの名前。このフィールドは _Default に設定する必要があります。_Default という名前の Scope オブジェクト（自動的に作成される）に、デフォルトのログスコープとデフォルトのトレース スコープに関する情報が格納されます。

API エンドポイントにコマンドを送信するには、API Explorer を使用します。API Explorer を使用すると、リファレンス ページからコマンドを実行できます。たとえば、現在のデフォルト スコープを取得するには、次の操作を行います。

1. projects.locations.scopes.get をクリックします。
2. [この方法を試す] ウィジェットの [名前] フィールドに、次のように入力します。

       projects/PROJECT_ID/locations/global/scopes/_Default
       

   前のフィールドをコピーする前に、PROJECT_ID をプロジェクトの名前に置き換えます。

3. [Execute] を選択します。
4. 承認ダイアログで、必要な手順を完了します。

   レスポンスは次の例のようになります。

       {
       "name": "projects/my-project/locations/global/scopes/_Default",
       "logScope": "logging.googleapis.com/projects/my-project/locations/global/logScopes/_Default"
       "traceScope": "projects/my-project/locations/global/traceScopes/_Default"
       }
       

トレース スコープの上限

トレース スコープの上限	値
プロジェクトあたりのトレース スコープの最大数	100
トレース スコープあたりの最大ビュー数	20

次のステップ

• トレースの検索と調査

• Cloud Logging と Cloud Monitoring には、表示またはモニタリングできるログデータまたは指標データを制御できる同様の構成が含まれています。これらのスコープについては、次のドキュメントをご覧ください。

  • オブザーバビリティ スコープの概要
  • ログスコープを作成して管理する
  • 指標スコープの概要