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 visualizzare e analizzare solo gli span che hanno origine nel tuo progetto Google Cloud, non devi configurare alcun ambito di traccia. Tuttavia, se i dati delle tracce 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 da un singolo progetto Google Cloud.
Questo documento non descrive come visualizzare le tracce e gli intervalli. Per informazioni su questo argomento, consulta Trovare ed esplorare le tracce.
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 in modo da eseguire ricerche in base all'ambito della traccia, il che significa che la pagina cercherà nei progetti elencati nell'ambito selezionato. I tuoi ruoli IAM (Identity and Access Management) nei progetti sottoposti a ricerca e l'impostazione dell'intervallo di tempo determinano quali dati vengono recuperati dall'archiviazione e poi visualizzati.
Quando crei un progetto Google Cloud, viene creato un ambito 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 e modificarli ed eliminarli. Vuoi creare un ambito di traccia quando hai un servizio che scrive i dati degli span in più progetti Google Cloud.
A meno che non apra la pagina Esplora tracce con un URL che includa un ambito della traccia o un ID traccia e span, la pagina Esplora tracce cerca i dati di traccia nei progetti Google 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.
Prima di iniziare
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:
-
Per creare e visualizzare gli ambiti traccia e per ottenere l'ambito traccia predefinito:
Utente Cloud Trace (
roles/cloudtrace.user) nel tuo progetto -
Per impostare l'ambito della traccia predefinito:
Editor di osservabilità (
roles/observability.editor) nel tuo progetto
Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.
Questi ruoli predefiniti contengono le autorizzazioni necessarie per creare e visualizzare gli ambiti delle tracce e per impostare l'ambito della traccia predefinito. Per visualizzare le autorizzazioni esatte richieste, espandi la sezione Autorizzazioni richieste:
Autorizzazioni obbligatorie
Per creare e visualizzare gli ambiti di traccia e 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.
Elenca gli ambiti delle tracce
Per elencare gli ambiti 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.
Seleziona la scheda Ampi dello tracciamento.
La tabella elenca gli ambiti dei traccianti. Dopo aver selezionato un progetto Google Cloud, viene visualizzata una voce con l'icona "Predefinito",
, che indica che si tratta dell'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.
Creare un ambito della traccia
Gli intervalli visualizzati dalla pagina Esplora tracce dipendono dai progetti cercati, dai tuoi ruoli IAM in questi progetti, dall'impostazione dell'intervallo di tempo e dai filtri applicati.
Puoi creare 100 ambiti della traccia per progetto. Un ambito della traccia può includere un totale di 20 progetti.
Per creare un ambito 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.
- Seleziona la scheda Ampi dello traccia e poi fai clic su Crea ambito traccia.
Fai clic su Aggiungi progetti e completa la finestra di dialogo.
Quando aggiungi un progetto, gli intervalli archiviati in quel progetto sono inclusi nell'ambito della traccia. Se non sai quali progetti includere in un ambito, puoi utilizzare la pagina Esplora tracce precedente per identificarli. Per ulteriori informazioni, consulta la sezione Eseguire la migrazione agli ambiti di traccia di questo documento.
Nella sezione Nome ambito traccia, inserisci il nome e la descrizione da visualizzare nella scheda Ambiti 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 traccia.
Eseguire la migrazione agli ambiti delle tracce
La pagina Esplora tracce richiede di specificare i progetti Google Cloud in cui cercare i dati di traccia, il che rappresenta un cambiamento di comportamento rispetto alla pagina Esplora tracce precedente. La pagina Esplora tracce precedente cerca in tutti i progetti di un'organizzazione. A causa di queste differenze, la pagina Esplora tracce potrebbe non mostrare gli intervalli visualizzati dalle pagine Esplora tracce precedenti.
Puoi utilizzare la sezione del riquadro Dettagli traccia della pagina Esplora tracce precedente per compilare un elenco dei progetti Google Cloud che archiviano i dati di traccia:
Vai alla pagina Trace Explorer precedente:
Seleziona una traccia.
Puoi provare quanto segue:
- Visualizzare una traccia inserendo il relativo ID nel campo ID traccia.
- Aggiunta di filtri.
Nel riquadro Dettagli su Trace, seleziona la traccia e vai alla scheda Progetti.
Questa scheda elenca i progetti che archiviano gli span per la traccia.
Per creare un ambito della traccia contenente i progetti elencati, vai alla barra degli strumenti della scheda Progetti, seleziona Crea ambito con questi progetti e 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.
Impostare 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 questo ambito di traccia non è accessibile, nel progetto vengono cercati i dati di traccia.
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 traccia e designarlo come ambito traccia predefinito.
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.
- Seleziona la scheda Ampi dello tracciamento.
Individua l'ambito traccia che vuoi designare come ambito traccia predefinito, fai clic su more_vert Altro e poi seleziona Imposta come predefinita.
L'ambito della traccia selezionato viene mostrato con un'icona "Predefinito",
.
Modificare o eliminare l'ambito di una traccia
Non puoi eliminare o modificare l'ambito della traccia denominato _Default. Puoi modificare o eliminare tutti gli altri ambiti di traccia.
Per modificare o eliminare l'ambito di una 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.
- Seleziona la scheda Ampi dello tracciamento.
Individua l'ambito della traccia da 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.
Limitazioni
L'Cloud Trace API o Google Cloud CLI non supporta la creazione o la gestione degli ambiti di traccia.
Passaggi successivi
Cloud Logging e Cloud Monitoring contengono costrutti simili che consentono di controllare i dati di log o le metriche che puoi visualizzare o monitorare. Per informazioni su questi ambiti, consulta i seguenti documenti: