Questo documento descrive come creare e gestire un ambito della traccia, che consente alla pagina Esplora tracce di trovare gli intervalli di traccia che vuoi visualizzare o analizzare. Se vuoi solo visualizzare e analizzare gli span che hanno origine nel tuo progetto Google Cloud , non devi configurare alcun ambito di traccia. Tuttavia, se i dati di traccia sono archiviati in più progetti, come potrebbe accadere quando utilizzi un'architettura di microservizi, devi eseguire alcune attività di configurazione per visualizzare tutti gli span di un singolo progetto Google Cloud .
Questo documento non descrive come visualizzare le tracce e gli intervalli. Per informazioni su questo argomento, vedi Trovare ed esplorare le tracce.
Questa funzionalità è supportata solo per i progetti Google Cloud . Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione della cartella app.
Informazioni sugli ambiti delle tracce
Gli ambiti Trace sono risorse permanenti a livello di progetto che elencano un insieme di progetti. Google Cloud Puoi configurare la pagina Esplora tracce per eseguire ricerche in base all'ambito della traccia, il che significa che la pagina esegue ricerche nei progetti elencati nell'ambito selezionato. I tuoi ruoli IAM (Identity and Access Management) nei progetti cercati e l'impostazione dell'intervallo di tempo determinano quali dati vengono recuperati dallo spazio di archiviazione e poi visualizzati.
Quando crei un progetto Google Cloud , viene creato un ambito della traccia denominato _Default. Questo ambito include solo il progetto Google Cloud . Non puoi aggiungere
progetti a questo ambito o eliminarlo.
Puoi creare ambiti di traccia, nonché modificare ed eliminare quelli che crei. Vuoi creare un ambito della traccia quando hai un servizio che scrive dati span in più progetti Google Cloud .
A meno che tu non apra la pagina Esplora tracce con un URL che include un ambito della traccia o un ID traccia e span, la pagina Esplora tracce cerca i dati di traccia nei progettiGoogle Cloud elencati nell'ambito della traccia predefinito.
Quando crei il progetto, l'ambito della traccia denominato _Default viene
impostato come ambito della traccia predefinito. Tuttavia, puoi selezionare un ambito della traccia diverso da utilizzare come ambito della traccia predefinito.
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 tutti i progetti che archiviano i tuoi dati di traccia e poi configuralo come ambito della traccia predefinito. Una volta completati questi passaggi, la pagina Esplora tracce mostra automaticamente i dati scritti dalla tua applicazione, anche se sono archiviati in progetti diversi.
Crea l'ambito di traccia personalizzato nel progetto da cui visualizzerai
i dati dei log. Questo progetto è il progetto host di App Hub o il progetto di gestione della cartella abilitata per le app.
Ad esempio, se il nome visualizzato della cartella è
My Folder, il nome visualizzato del progetto di gestione è
My Folder-mp.
Prima di iniziare
Per ottenere le autorizzazioni
necessarie per creare e visualizzare gli ambiti di traccia,
chiedi all'amministratore di concederti il
ruolo IAM Utente Cloud Trace (roles/cloudtrace.user)
sul 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:
-
Per creare e gestire gli ambiti della traccia:
cloudtrace.traceScopes.{create, delete, get, list, update}
Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.
Sono richieste autorizzazioni aggiuntive per impostare l'ambito di traccia predefinito. Queste autorizzazioni sono descritte nella sezione Configurare l'ambito di traccia predefinito di questo documento.
Elenca ambiti della 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 Google Cloud progetto. Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione della cartella app.
Seleziona la scheda Ambiti di traccia.
La tabella elenca gli ambiti di traccia. Quando selezioni un Google Cloud progetto, viene visualizzata una voce con un'icona "Predefinito",
,
che indica che si tratta dell'ambito della traccia predefinito.
La pagina Esplora tracce cerca i dati di traccia nei progetti elencati nell'ambito della traccia predefinito quando la pagina si apre.
Creare un ambito della traccia
Gli span visualizzati dalla pagina Esplora tracce dipendono dai progetti cercati, dai tuoi ruoli IAM in questi progetti, dall'intervallo di tempo e dai filtri che applichi.
Puoi creare 100 ambiti della traccia per progetto. Un ambito della traccia può includere un totale di 20 progetti.
Console
Per creare 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 Google Cloud progetto. Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione della cartella app.
- 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.
Quando aggiungi un progetto, gli span archiviati in quel progetto vengono inclusi nell'ambito della traccia. Se non sai quali progetti includere in un ambito, puoi utilizzare la pagina Esplora tracce legacy per identificarli. Per ulteriori informazioni, consulta la sezione Eseguire la migrazione agli ambiti di traccia di questo documento.
Nella sezione Ambito della traccia del nome, inserisci il nome e la descrizione che vuoi visualizzare nella scheda Ambiti della traccia.
Il nome di un ambito della traccia non può essere modificato e deve essere univoco all'interno del progetto.
Fai clic su Crea ambito di traccia.
Esegui la migrazione agli ambiti delle tracce
La pagina Esplora tracce richiede di specificare i progettiGoogle Cloud in cui cercare i dati di traccia, il che rappresenta un cambiamento nel comportamento rispetto alla pagina Esplora tracce precedente. La pagina Esplora tracce precedente esegue ricerche in tutti i progetti di un'organizzazione. A causa di queste differenze, la pagina Esplora tracce potrebbe non mostrare gli intervalli visualizzati nelle pagine Esplora tracce legacy.
Puoi utilizzare la sezione del riquadro Dettagli traccia della pagina Esplora tracce legacy per compilare un elenco di progettiGoogle Cloud che archiviano i dati di traccia:
Vai alla pagina Esplora tracce precedente:
Nella barra degli strumenti della console Google Cloud , seleziona il tuo Google Cloud progetto. Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione della cartella app.
Seleziona una traccia.
Puoi provare a:
- Visualizzare una traccia inserendo il relativo ID nel campo ID traccia.
- Aggiunta di filtri.
Nel riquadro Dettagli su Trace, seleziona la traccia e poi vai alla scheda Progetti.
Questa scheda elenca i progetti che archiviano gli span per la traccia.
Per creare un ambito della traccia che contenga i progetti elencati, vai alla barra degli strumenti della scheda Progetti e seleziona Crea ambito con questi progetti, quindi completa la finestra di dialogo.
Ripeti i passaggi precedenti finché non hai compilato un elenco di progetti.
Dopo aver compilato un elenco di progetti, crea un ambito della traccia. Puoi anche impostarlo come ambito della traccia predefinito.
Modificare o eliminare un ambito di traccia
Non puoi eliminare o modificare
l'ambito della traccia denominato _Default. Puoi modificare o eliminare tutti gli altri
ambiti di traccia.
Console
Per modificare o eliminare 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 Google Cloud progetto. Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione della cartella app.
- Seleziona la scheda Ambiti di traccia.
Individua l'ambito della traccia che vuoi modificare o eliminare, fai clic su more_vert Altro e poi esegui una delle seguenti operazioni:
- Per modificarlo, seleziona Modifica ambito e poi completa la finestra di dialogo.
- Per eliminare, seleziona Elimina ambito e completa la finestra di dialogo.
Configurare l'ambito della traccia predefinito
Quando si apre la pagina Esplora tracce, vengono cercati i dati di traccia nei progetti elencati nell'ambito della traccia predefinito. Se l'ambito della traccia non è accessibile, i dati di traccia vengono cercati nel progetto.
Quando vengono creati i progetti, viene creato l'ambito della traccia denominato _Default
e viene designato come ambito della traccia predefinito. Tuttavia, puoi creare
il tuo ambito di traccia e designarlo come ambito di traccia
predefinito.
Prima di iniziare
-
Enable the Observability API.
Prima di attivare l'API, assicurati di aver selezionato il progetto corretto. Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione della cartella app.
-
Per ottenere le autorizzazioni necessarie per creare e visualizzare gli ambiti di traccia e per impostare l'ambito di traccia predefinito, chiedi all'amministratore di concederti i seguenti ruoli IAM sul progetto:
-
Utente Cloud Trace (
roles/cloudtrace.user) -
Editor di osservabilità (
roles/observability.editor)
Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.
Questi ruoli predefiniti contengono le autorizzazioni necessarie per creare e visualizzare gli ambiti di traccia e per impostare l'ambito di traccia predefinito. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:
Autorizzazioni obbligatorie
Per creare e visualizzare gli ambiti di traccia e per impostare l'ambito di traccia predefinito sono necessarie le seguenti autorizzazioni:
-
Per creare e gestire gli ambiti della traccia:
cloudtrace.traceScopes.{create, delete, get, list, update} -
Per impostare l'ambito della traccia predefinito:
observability.scopes.{get, update}
Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.
-
Utente Cloud Trace (
Impostare l'ambito predefinito
Console
Per impostare l'ambito della traccia predefinito:
-
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 Google Cloud progetto. Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione della cartella app.
Seleziona la scheda Ambiti di traccia.
La scheda mostra gli ambiti di traccia e include un pulsante per creare un ambito di traccia personalizzato.
Trova l'ambito di traccia che vuoi designare come ambito di traccia predefinito, fai clic su more_vert Altro e poi seleziona Imposta come predefinito.
L'ambito della traccia selezionato viene mostrato con un'icona "Predefinito",
.
Limitazioni
Non è disponibile il supporto dell'Cloud Trace API o di Google Cloud CLI per la creazione o la gestione degli ambiti di traccia.
Limiti relativi agli ambiti delle tracce
| Limiti relativi agli ambiti delle tracce | Valore |
|---|---|
| Numero massimo di ambiti della traccia per progetto | 100 |
| Numero massimo di progetti per ambito della traccia | 20 |
Passaggi successivi
Cloud Logging e Cloud Monitoring contengono costrutti simili che consentono di controllare i dati di log o i dati delle metriche che puoi visualizzare o monitorare. Per informazioni su questi ambiti, consulta i seguenti documenti: