Creare e gestire ambiti delle tracce

Gli ambiti di traccia ti consentono di cercare e analizzare i dati di Cloud Trace in più progetti dalla pagina Esplora tracce. Se vuoi solo visualizzare e analizzare gli intervalli che hanno origine in un singolo progetto Google Cloud , non devi configurare alcun ambito di traccia. Per informazioni sulla visualizzazione di tracce e intervalli, consulta Trova ed esplora le tracce.

Informazioni sugli ambiti delle tracce

Gli ambiti di Trace ti consentono di avere una visualizzazione aggregata dei dati di traccia archiviati in più progetti. Questi ambiti sono risorse permanenti a livello di progetto che elencano le visualizzazioni. Ogni visualizzazione fornisce l'accesso ai dati di traccia archiviati da un progetto. Pagine come Esplora tracce utilizzano gli ambiti di traccia per determinare dove cercare i dati. Tuttavia, queste pagine utilizzano anche i tuoi ruoli Identity and Access Management (IAM) su queste risorse per determinare se hai l'autorizzazione per visualizzare i dati trovati.

Quando crei un ambito della traccia, fornisci un nome e un elenco di progetti. Il sistema include automaticamente la visualizzazione di traccia predefinita di ogni progetto, che ha il percorso _Trace/Spans/_AllSpans. I campi del percorso _Trace, Spans e _AllSpans fanno riferimento a un bucket di osservabilità, al set di dati che archivia i dati e a una visualizzazione del set di dati. La visualizzazione _AllSpans fornisce l'accesso a tutti i dati di traccia archiviati dal progetto.

La pagina Esplora tracce include un'opzione che consente di selezionare un ambito di traccia. Quando effettui una selezione, la pagina cerca le visualizzazioni elencate nell'ambito della traccia e aggiorna la visualizzazione.

Puoi anche condividere la visualizzazione configurata copiando l'URL del browser. L'URL codifica l'ambito della traccia selezionato e altre impostazioni della pagina, eseguendo l'override delle selezioni dell'ambito predefinito per chiunque apra il link. Per saperne di più, consulta Condividi tracce e intervalli.

Puoi designare un ambito di traccia come "predefinito". Quando effettui questa designazione, si verifica quanto segue:

  • Il sistema aggiorna l'ambito di osservabilità. Questo ambito contiene puntatori all'ambito dei log predefinito e all'ambito delle tracce predefinito, che aiutano il sistema a correlare i dati di log e di traccia quando questi dati sono archiviati in più progetti. Per saperne di più, consulta Configura gli ambiti di osservabilità per le query su più progetti.

  • Il sistema aggiorna l'ambito della traccia utilizzato automaticamente dalla pagina Esplora tracce per cercare i dati di traccia. Se la pagina non può accedere all'ambito della traccia predefinito, cerca i dati di traccia nel progetto.

Puoi modificare ed eliminare gli ambiti di traccia che crei.

Applicazioni App Hub e ambiti di traccia

Le tue applicazioni App Hub potrebbero scrivere dati di traccia in più progetti. Per ottenere una visualizzazione aggregata di questi dati, crea un ambito della traccia, configuralo in modo da elencare la visualizzazione di traccia predefinita di tutti i progetti che archiviano i dati di traccia, quindi configuralo come ambito della traccia predefinito. Al termine di questi passaggi, la pagina Trace Explorer visualizza automaticamente i dati scritti dalla tua applicazione, anche se sono archiviati in progetti diversi.

Crea l'ambito di traccia personalizzato nel progetto da cui visualizzi i dati di traccia. Questo progetto è il tuo progetto host o di gestione di App Hub. Ad esempio, se il nome visualizzato di una cartella è My Folder, il nome visualizzato del progetto di gestione della cartella è My Folder-mp.

Prima di iniziare

Configura il progetto, i ruoli IAM e seleziona l'interfaccia che prevedi di utilizzare.

Configura il progetto e i ruoli

  1. 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.

    Go to project selector

  2. Verify that billing is enabled for your Google Cloud project.

  3. Enable the Observability API, if it is not already enabled.

    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

  4. Per ottenere le autorizzazioni necessarie per creare e visualizzare gli ambiti di traccia, chiedi all'amministratore di concederti il ruolo IAM Editor degli ambiti di osservabilità (roles/observability.scopesEditor) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

    Questo ruolo predefinito contiene le autorizzazioni necessarie per creare e visualizzare gli ambiti di traccia. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

    Autorizzazioni obbligatorie

    Per creare e visualizzare gli ambiti di traccia sono necessarie le seguenti autorizzazioni:

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

    Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Seleziona l'interfaccia che intendi utilizzare

Console

Quando utilizzi la console Google Cloud per accedere ai servizi e alle API Google Cloud , non devi configurare l'autenticazione.

gcloud

Installa Google Cloud CLI, quindi accedi a gcloud CLI con la tua identità federata. Dopo aver eseguito l'accesso, inizializza Google Cloud CLI eseguendo il comando seguente:

gcloud init

Terraform

Per utilizzare gli esempi di Terraform in questa pagina in un ambiente di sviluppo locale, installa e inizializza gcloud CLI, quindi configura Credenziali predefinite dell'applicazione con le tue credenziali utente.

  1. Installa Google Cloud CLI.

  2. Configura gcloud CLI per utilizzare la tua identità federata.

    Per saperne di più, consulta Accedi a gcloud CLI con la tua identità federata.

  3. Crea credenziali di autenticazione locali per il tuo account utente:

    gcloud auth application-default login

    Se viene restituito un errore di autenticazione, verifica di aver eseguito l'accesso a gcloud CLI con la tua identità federata.

Per saperne di più, consulta Configura ADC per un ambiente di sviluppo locale nella documentazione sull'autenticazione di Google Cloud .

REST

Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, utilizzi le credenziali che fornisci a gcloud CLI.

    Installa Google Cloud CLI, quindi accedi a gcloud CLI con la tua identità federata.

Per saperne di più, consulta Autenticati per usare REST nella documentazione sull'autenticazione di Google Cloud .

Elenca gli ambiti di traccia

Console

Per elencare gli ambiti di traccia, segui questi passaggi:

  1. Nella console Google Cloud , vai alla pagina  Impostazioni:

    Vai alle Impostazioni

    Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.

  2. Nella barra degli strumenti della console Google Cloud , seleziona il tuo progetto Google Cloud . Per le configurazioni di App Hub, seleziona il progetto host o il progetto di gestione di App Hub.
  3. Seleziona la scheda Ambiti di traccia.

    La finestra mostra un elenco degli ambiti di traccia. La voce che include un'icona "Predefinito", , è l'ambito di traccia predefinito.

  4. Per visualizzare i dettagli di un ambito di traccia, espandilo.

    Se espandi un ambito di traccia, puoi visualizzare l'elenco delle visualizzazioni incluse nell'ambito. Ogni riga elenca un ID progetto insieme a una voce come _Trace/Spans/_AllSpans, che identifica la posizione di archiviazione predefinita per i dati di traccia. I campi _Trace, Spans e _AllSpans fanno riferimento al bucket, al set di dati e alla visualizzazione di osservabilità per i dati di traccia. La vista _AllSpans corrisponde a ogni voce nel bucket:

    Nome Descrizione Tipo Risorse
    _Default Trace scope 1
    myscope My description Trace scope 2
      _Trace/Spans/_AllSpans myproject Trace view
      _Trace/Spans/_AllSpans project-b Trace view

gcloud

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

  • LOCATION: la località dello scope di traccia. Questo campo deve avere un valore pari a global.
  • PROJECT_ID: l'identificatore del progetto.

Esegui il comando gcloud observability trace-scopes list:

Linux, macOS o 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

I dati della risposta sono un elenco di ambiti della traccia. Per ogni ambito vengono visualizzati il nome e le informazioni pertinenti. Ad esempio, di seguito è riportato il risultato del comando list per un progetto con due ambiti di traccia:

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

Puoi utilizzare Terraform per creare e modificare un ambito di traccia. Tuttavia, non puoi utilizzare Terraform per elencare gli ambiti di traccia.

REST

Per elencare tutti gli ambiti di traccia in un progetto Google Cloud , utilizza il comando projects.locations.traceScopes.list. Devi specificare un parametro di percorso.

Il parametro di percorso per questo endpoint ha la seguente sintassi:

projects/PROJECT_ID/locations/LOCATION_ID/traceScopes

I campi nell'espressione precedente hanno il seguente significato:

  • PROJECT_ID: l'identificatore del progetto. Per le configurazioni di App Hub, seleziona il progetto host o il progetto di gestione di App Hub.
  • LOCATION_ID deve essere impostato su global.

La risposta è un array di oggetti TraceScope. Ogni oggetto include un nome e un elenco di risorse.

Per ottenere informazioni su un ambito di traccia specifico, utilizza il comando projects.locations.traceScopes.get.

Crea un ambito della traccia

Gli intervalli visualizzati nella pagina Esplora tracce dipendono dalle visualizzazioni cercate, dai tuoi ruoli IAM su queste visualizzazioni, dall'impostazione dell'intervallo di tempo e dai filtri applicati.

Puoi creare 100 ambiti di traccia per progetto. Un ambito della traccia può includere un totale di 200 visualizzazioni. Se crei un ambito di traccia che elenca più di 10 visualizzazioni, potresti riscontrare problemi di prestazioni.

Console

Per creare un ambito di traccia, segui questi passaggi:

  1. Nella console Google Cloud , vai alla pagina  Impostazioni:

    Vai alle Impostazioni

    Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.

  2. Nella barra degli strumenti della console Google Cloud , seleziona il tuo progetto Google Cloud . Per le configurazioni di App Hub, seleziona il progetto host o il progetto di gestione di App Hub.
  3. Seleziona la scheda Ambiti di traccia e poi fai clic su Crea ambito di traccia.
  4. Fai clic su Aggiungi progetti e completa la finestra di dialogo.

  5. Nella sezione Assegna un nome all'ambito di traccia, inserisci il nome e la descrizione che vuoi visualizzare nella scheda Ambiti di traccia.

    Il nome di un ambito di traccia non può essere modificato e deve essere univoco all'interno del progetto.

  6. Fai clic su Crea ambito di traccia.

    Per impostazione predefinita, la tabella Ambiti di traccia elenca gli ambiti di traccia in un formato compresso. Per ogni ambito, la tabella elenca un nome, una descrizione, un tipo e un numero di risorse.

    Se espandi un ambito di traccia, puoi visualizzare l'elenco delle visualizzazioni incluse nell'ambito. Ogni riga elenca un ID progetto insieme a una voce come _Trace/Spans/_AllSpans, che identifica la posizione di archiviazione predefinita per i dati di traccia. I campi _Trace, Spans e _AllSpans fanno riferimento al bucket, al set di dati e alla visualizzazione di osservabilità per i dati di traccia. La vista _AllSpans corrisponde a ogni voce nel bucket:

    Nome Descrizione Tipo Risorse
    _Default Trace scope 1
    myscope My description Trace scope 2
      _Trace/Spans/_AllSpans myproject Trace view
      _Trace/Spans/_AllSpans project-b Trace view

gcloud

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

  • TRACE_SCOPE_NAME: il nome di un ambito di traccia. Ad esempio, my-trace-scope.
  • DESCRIPTION: (Facoltativo) La descrizione dell'ambito della traccia. Formatta la descrizione come stringa.
  • RESOURCE_NAMES: un elenco separato da virgole dei nomi completi dei progetti. Ad esempio, projects/my-project.
  • LOCATION: la località dello scope di traccia. Questo campo deve avere un valore pari a global.
  • PROJECT_ID: l'identificatore del progetto.

Esegui il comando gcloud observability trace-scopes create:

Linux, macOS o 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

In caso di esito positivo, la risposta del comando create include il nome del nuovo ambito di traccia:

Created traceScope [my-test-scope].

Terraform

Per informazioni su come applicare o rimuovere una configurazione Terraform, consulta Comandi Terraform di base. Per saperne di più, consulta la documentazione di riferimento del provider Terraform.

Per creare un ambito di traccia in un progetto utilizzando Terraform, utilizza la risorsa Terraform google_observability_trace_scope.

Nel comando, imposta i seguenti campi:

  • project: il nome del progetto, della cartella o dell'organizzazione. Ad esempio, my-project. Per le configurazioni di App Hub, seleziona il progetto host o il progetto di gestione di App Hub.

  • trace_scope_id: imposta un ID ambito. Ad esempio, my-trace-scope.

  • location: impostato su "global".

  • resource_names: un array di progetti, in cui ogni progetto è specificato utilizzando il nome completo.

  • description: una breve descrizione. Ad esempio, "Ambito per le risorse di produzione".

REST

Per creare un ambito di traccia, utilizza il comando projects.locations.traceScopes.create. Devi specificare un parametro di percorso e fornire un oggetto TraceScope. La risposta è un oggetto TraceScope.

Il parametro di percorso per questo endpoint ha la seguente sintassi:

projects/PROJECT_ID/locations/LOCATION_ID/traceScopes

I campi nell'espressione precedente hanno il seguente significato:

  • PROJECT_ID: l'identificatore del progetto. Per le configurazioni di App Hub, seleziona il progetto host o il progetto di gestione di App Hub.
  • LOCATION_ID deve essere impostato su global.

Modifica un ambito di traccia

Non puoi modificare l'ambito della traccia denominato _Default. Puoi modificare tutti gli altri ambiti di traccia.

Console

Per modificare un ambito di traccia:

  1. Nella console Google Cloud , vai alla pagina  Impostazioni:

    Vai alle Impostazioni

    Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.

  2. Nella barra degli strumenti della console Google Cloud , seleziona il tuo progetto Google Cloud . Per le configurazioni di App Hub, seleziona il progetto host o il progetto di gestione di App Hub.
  3. Seleziona la scheda Ambiti di traccia.
  4. Trova l'ambito di traccia che vuoi modificare, fai clic su  Altro, seleziona Modifica ambito e completa la finestra di dialogo.

gcloud

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

  • TRACE_SCOPE_NAME: il nome di un ambito di traccia. Ad esempio, my-trace-scope.
  • DESCRIPTION: (Facoltativo) La descrizione dell'ambito della traccia. Formatta la descrizione come stringa.
  • RESOURCE_NAMES: un elenco separato da virgole dei nomi completi dei progetti. Ad esempio, projects/my-project.
  • LOCATION: la località dello scope di traccia. Questo campo deve avere un valore pari a global.
  • PROJECT_ID: l'identificatore del progetto.

Esegui il comando gcloud observability trace-scopes update:

Linux, macOS o 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

In caso di esito positivo, i dati della risposta di un comando update mostrano l'ambito di traccia aggiornato:

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

Per informazioni su come applicare o rimuovere una configurazione Terraform, consulta Comandi Terraform di base. Per saperne di più, consulta la documentazione di riferimento del provider Terraform.

Per modificare un ambito di traccia in un progetto utilizzando Terraform, utilizza la risorsa Terraform google_observability_trace_scope.

REST

Per modificare un ambito di traccia, utilizza il comando projects.locations.traceScopes.patch. Devi specificare un parametro di percorso, parametri di ricerca e fornire un oggetto TraceScope. I parametri di ricerca identificano i campi modificati. La risposta è un oggetto TraceScope.

Il parametro di percorso per questo endpoint ha la seguente sintassi:

projects/PROJECT_ID/locations/LOCATION_ID/traceScopes/TRACE_SCOPE_NAME

I campi nell'espressione precedente hanno il seguente significato:

  • PROJECT_ID: l'identificatore del progetto. Per le configurazioni di App Hub, seleziona il progetto host o il progetto di gestione di App Hub.
  • LOCATION_ID deve essere impostato su global.
  • TRACE_SCOPE_NAME: il nome di un ambito di traccia. Ad esempio, my-trace-scope.

Elimina un ambito di traccia

Non puoi eliminare l'ambito di traccia denominato _Default. Puoi eliminare tutti gli altri ambiti di traccia.

Console

Per eliminare un ambito di traccia, segui questi passaggi:

  1. Nella console Google Cloud , vai alla pagina  Impostazioni:

    Vai alle Impostazioni

    Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.

  2. Nella barra degli strumenti della console Google Cloud , seleziona il tuo progetto Google Cloud . Per le configurazioni di App Hub, seleziona il progetto host o il progetto di gestione di App Hub.
  3. Seleziona la scheda Ambiti di traccia.
  4. Trova l'ambito di traccia che vuoi eliminare, fai clic su  Altro, seleziona Elimina ambito e completa la finestra di dialogo.

gcloud

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

  • TRACE_SCOPE_NAME: il nome di un ambito di traccia. Ad esempio, my-trace-scope.
  • LOCATION: la località dello scope di traccia. Questo campo deve avere un valore pari a global.
  • PROJECT_ID: l'identificatore del progetto.

Esegui il comando gcloud observability trace-scopes delete:

Linux, macOS o 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

Se esegui un comando delete, ti verrà chiesto di confermare l'azione. Di seguito è riportato un esempio di esecuzione:

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

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

Deleted traceScope [my-test-scope].

Terraform

Per informazioni su come applicare o rimuovere una configurazione Terraform, consulta Comandi Terraform di base. Per saperne di più, consulta la documentazione di riferimento del provider Terraform.

Per eliminare un ambito di traccia in un progetto utilizzando Terraform, utilizza la risorsa Terraform google_observability_trace_scope.

REST

Per eliminare un ambito di traccia, utilizza il comando projects.locations.traceScopes.delete. Devi specificare un parametro di percorso.

Il parametro di percorso per questo endpoint ha la seguente sintassi:

projects/PROJECT_ID/locations/LOCATION_ID/traceScopes/TRACE_SCOPE_NAME

I campi nell'espressione precedente hanno il seguente significato:

  • PROJECT_ID: l'identificatore del progetto. Per le configurazioni di App Hub, seleziona il progetto host o il progetto di gestione di App Hub.
  • LOCATION_ID deve essere impostato su global.
  • TRACE_SCOPE_NAME: il nome di un ambito di traccia. Ad esempio, my-trace-scope.

Configura l'ambito di traccia predefinito

Quando si apre la pagina Esplora tracce, vengono cercate le visualizzazioni elencate nell'ambito della traccia predefinito per i dati di traccia. Se l'ambito predefinito non è accessibile, la pagina cerca i dati di traccia nel progetto. Questa ricerca equivale a eseguire una query sulla vista _AllSpans del progetto nel set di dati predefinito.

Quando vengono creati i progetti, viene creato l'ambito della traccia denominato _Default, che viene designato come ambito della traccia predefinito. Tuttavia, puoi creare il tuo scope di traccia e designarlo come scope di traccia predefinito.

Console

Per impostare l'ambito di traccia predefinito, segui questi passaggi:

  1. Nella console Google Cloud , vai alla pagina  Impostazioni:

    Vai alle Impostazioni

    Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.

  2. Nella barra degli strumenti della console Google Cloud , seleziona il tuo progetto Google Cloud . Per le configurazioni di App Hub, seleziona il progetto host o il progetto di gestione di App Hub.
  3. Seleziona la scheda Ambiti di traccia.

    La scheda mostra gli scope di traccia e include un pulsante per crearne uno personalizzato. L'ambito della traccia mostrato con un'icona "Predefinito", , è l'ambito della traccia predefinito corrente.

  4. Per modificare l'ambito di traccia predefinito, individua l'ambito di traccia che vuoi designare come predefinito, fai clic su  Altro, quindi seleziona Imposta come predefinito.

    L'ambito di traccia selezionato viene visualizzato con un'icona "Predefinito", .

gcloud

Per visualizzare e aggiornare l'ambito di osservabilità, segui questi passaggi:

  1. Per visualizzare le impostazioni per l'ambito di osservabilità, esegui il comando gcloud observability scopes describe.

    Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

    • OBSERVABILITY_SCOPE_ID: il nome di un oggetto Scope. Questo valore deve essere impostato su _Default.
    • LOCATION: il campo della località deve essere impostato su global.
    • PROJECT_ID: l'identificatore del progetto.

    Esegui il comando gcloud observability scopes describe:

    Linux, macOS o 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

    La risposta al comando è simile alla seguente:

    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. Per aggiornare l'ambito di osservabilità, esegui il comando gcloud observability scopes update. Nel comando update, puoi includere il flag --log-scope, il flag --trace-scope o entrambi.

    Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

    • OBSERVABILITY_SCOPE_ID: il nome di un oggetto Scope. Questo valore deve essere impostato su _Default.
    • LOG_SCOPE_FQN_ID: il nome completo della risorsa dell'ambito dei log. Questo campo ha il seguente formato:
      logging.googleapis.com/projects/PROJECT_ID/locations/LOCATION/logScopes/LOG_SCOPE_ID

      Nell'espressione precedente, LOG_SCOPE_ID è l'ID dell'ambito dei log. Ad esempio, my-scope.

    • TRACE_SCOPE_FQN_ID: il nome completo della risorsa dell'ambito di traccia. Questo campo ha il seguente formato:
      projects/PROJECT_ID/locations/LOCATION/traceScopes/TRACE_SCOPE_NAME

      Nell'espressione precedente, TRACE_SCOPE_NAME è il nome dell'ambito della traccia. Ad esempio, my-trace-scope.

    • LOCATION: il campo della località deve essere impostato su global.
    • PROJECT_ID: l'identificatore del progetto.

    Esegui il comando gcloud observability scopes update:

    Linux, macOS o 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

    Ad esempio, se il valore di LOG_SCOPE_ID è my-log-scope e il valore di TRACE_SCOPE_NAME è my-trace-scope, la risposta è simile alla seguente:

    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

Puoi utilizzare Terraform per creare e modificare un ambito di traccia. Tuttavia, non puoi utilizzare Terraform per impostare l'ambito di traccia predefinito.

REST

Per ottenere e impostare l'ambito dei log predefinito o l'ambito delle tracce predefinito utilizzando una chiamata API, configura l'ambito di osservabilità. L'ambito di osservabilità elenca l'ambito dei log predefinito e l'ambito della traccia predefinito:

  • Per ottenere l'ambito di osservabilità predefinito per un progetto, invia una richiesta all'endpoint projects.locations.scopes.get. Devi specificare un parametro di percorso. La risposta è un oggetto Scope, che elenca l'ambito di log predefinito e l'ambito di traccia predefinito.
  • Per aggiornare l'ambito di osservabilità predefinito per un progetto, invia una richiesta all'endpoint projects.locations.scopes.patch. Devi specificare un parametro di percorso, parametri di ricerca e fornire un oggetto Scope. I parametri di ricerca identificano i campi modificati. La risposta è un oggetto Scope.

Il parametro di percorso per entrambi gli endpoint ha il seguente formato:

projects/PROJECT_ID/locations/LOCATION/scopes/OBSERVABILITY_SCOPE_ID

I campi nell'espressione precedente hanno il seguente significato:

  • PROJECT_ID: l'identificatore del progetto. Per le configurazioni di App Hub, seleziona il progetto host o il progetto di gestione di App Hub.
  • LOCATION: il campo della località deve essere impostato su global.
  • OBSERVABILITY_SCOPE_ID: il nome di un oggetto Scope. Questo campo deve essere impostato su _Default. L'oggetto Scope con il nome _Default, creato automaticamente, memorizza le informazioni sull'ambito dei log predefinito e sull'ambito delle tracce predefinito.

Per inviare un comando a un endpoint API, puoi utilizzare Explorer API, che ti consente di inviare un comando da una pagina di riferimento. Ad esempio, per ottenere l'ambito predefinito corrente, puoi procedere nel seguente modo:

  1. Fai clic su projects.locations.scopes.get.
  2. Nel widget Prova questo metodo, inserisci quanto segue nel campo name:
        projects/PROJECT_ID/locations/global/scopes/_Default
        

    Prima di copiare il campo precedente, sostituisci PROJECT_ID con il nome del progetto.

  3. Seleziona Esegui.
  4. Nella finestra di dialogo di autorizzazione, completa i passaggi richiesti.

    La risposta è simile alla seguente:

        {
        "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"
        }
        

Limiti per gli ambiti di traccia

Limiti per gli ambiti di traccia Valore
Numero massimo di ambiti di traccia per progetto 100
Numero massimo di visualizzazioni per ambito della traccia 200

Per prestazioni ottimali, limita il numero di visualizzazioni in un ambito di traccia a 10.

Passaggi successivi