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
-
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 theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Verify that billing is enabled for your Google Cloud project.
Enable the Observability API, if it is not already enabled.
Roles required to enable APIs
To enable APIs, you need the
serviceusage.services.enablepermission. 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.-
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 initTerraform
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.
-
Installa Google Cloud CLI.
-
Configura gcloud CLI per utilizzare la tua identità federata.
Per saperne di più, consulta Accedi a gcloud CLI con la tua identità federata.
-
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:
-
Nella console Google Cloud , vai alla pagina settings Impostazioni:
Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.
- 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.
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.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,Spanse_AllSpansfanno riferimento al bucket, al set di dati e alla visualizzazione di osservabilità per i dati di traccia. La vista_AllSpanscorrisponde a ogni voce nel bucket:Nome Descrizione Tipo Risorse arrow_right _DefaultTrace scope1arrow_drop_down myscopeMy descriptionTrace scope2_Trace/Spans/_AllSpansmyprojectTrace view_Trace/Spans/_AllSpansproject-bTrace 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:
-
Nella console Google Cloud , vai alla pagina settings Impostazioni:
Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.
- 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.
- Seleziona la scheda Ambiti di traccia e poi fai clic su Crea ambito di traccia.
Fai clic su Aggiungi progetti e completa la finestra di dialogo.
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.
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,Spanse_AllSpansfanno riferimento al bucket, al set di dati e alla visualizzazione di osservabilità per i dati di traccia. La vista_AllSpanscorrisponde a ogni voce nel bucket:Nome Descrizione Tipo Risorse arrow_right _DefaultTrace scope1arrow_drop_down myscopeMy descriptionTrace scope2_Trace/Spans/_AllSpansmyprojectTrace view_Trace/Spans/_AllSpansproject-bTrace 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:
-
Nella console Google Cloud , vai alla pagina settings Impostazioni:
Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.
- 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.
- Seleziona la scheda Ambiti di traccia.
- Trova l'ambito di traccia che vuoi modificare, fai clic su more_vert 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:
-
Nella console Google Cloud , vai alla pagina settings Impostazioni:
Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.
- 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.
- Seleziona la scheda Ambiti di traccia.
- Trova l'ambito di traccia che vuoi eliminare, fai clic su more_vert 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:
-
Nella console Google Cloud , vai alla pagina settings Impostazioni:
Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.
- 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.
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.Per modificare l'ambito di traccia predefinito, individua l'ambito di traccia che vuoi designare come predefinito, fai clic su more_vert 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:
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
- OBSERVABILITY_SCOPE_ID: il nome di un oggetto
Per aggiornare l'ambito di osservabilità, esegui il comando
gcloud observability scopes update. Nel comandoupdate, puoi includere il flag--log-scope, il flag--trace-scopeo 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-scopee 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
- OBSERVABILITY_SCOPE_ID: il nome di un oggetto
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 oggettoScope, 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 oggettoScope. I parametri di ricerca identificano i campi modificati. La risposta è un oggettoScope.
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'oggettoScopecon 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:
- Fai clic su
projects.locations.scopes.get. - Nel widget Prova questo metodo, inserisci quanto segue nel campo name:
projects/PROJECT_ID/locations/global/scopes/_DefaultPrima di copiare il campo precedente, sostituisci PROJECT_ID con il nome del progetto.
- Seleziona Esegui.
- 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
Cloud Logging e Cloud Monitoring contengono costrutti simili che ti consentono di controllare i dati di log o delle metriche che puoi visualizzare o monitorare. Per informazioni su questi ambiti, consulta i seguenti documenti: