Eseguire la migrazione a Observability Analytics

Se utilizzi i sink di traccia per esportare i dati di Cloud Trace in BigQuery, esegui la migrazione a Observability Analytics. I sink Trace sono deprecati e verranno rimossi a partire dal 18 febbraio 2027. Observability Analytics ti consente di eseguire query sui dati di traccia direttamente utilizzando lo stesso linguaggio di query SQL di BigQuery senza gestire i sink di esportazione.

Se vuoi utilizzare i servizi BigQuery per unire i set di dati, gestire le tabelle o esportare i dati, puoi creare un set di dati BigQuery collegato. Puoi creare il set di dati BigQuery collegato durante la migrazione o in un secondo momento. Per iniziare a utilizzare Observability Analytics, consulta Eseguire query e analizzare le tracce.

Prima di iniziare

Accedi al tuo account Google Cloud . Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti senza costi per l'esecuzione, il test e il deployment dei carichi di lavoro.

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, 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

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, 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

1. Per ottenere le autorizzazioni necessarie per caricare la pagina Observability Analytics, eseguire query e creare un set di dati BigQuery collegato, chiedi all'amministratore di concederti i seguenti ruoli IAM nel progetto:

   • Amministratore Cloud Trace (roles/cloudtrace.admin)
   • Editor Observability (roles/observability.editor)
   • Utente BigQuery (roles/bigquery.user)

   Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

   Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

2. Nella console Google Cloud , attiva Cloud Shell.

   Attiva Cloud Shell

   Nella parte inferiore della console Google Cloud viene avviata una sessione di Cloud Shell e viene visualizzato un prompt della riga di comando. Cloud Shell è un ambiente shell con Google Cloud CLI già installata e con valori già impostati per il progetto corrente. L'inizializzazione della sessione può richiedere alcuni secondi.

Eseguire la migrazione a Observability Analytics

1. Completa le azioni elencate nella sezione Prima di iniziare di questo documento. Queste azioni includono l'abilitazione dell'API Observability.

2. Verifica di avere accesso ai dati di traccia utilizzando Observability Analytics:

   1. Nella console Google Cloud , vai alla pagina Observability Analytics:

      Vai a Observability Analytics

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

   2. Nel menu Visualizzazioni, vai alla sezione Tracce e poi seleziona _Trace.Spans._AllSpans.

      Il riquadro Schema viene aggiornato e mostra lo schema.

      Se non vedi una vista denominata _Trace.Spans._AllSpans, il tuo progettoGoogle Cloud non contiene un bucket di osservabilità denominato _Trace. Per informazioni su come risolvere questa situazione, consulta L'inizializzazione dell'archiviazione delle tracce non va a buon fine.

   3. Nel riquadro Schema, seleziona Query.

      Il campo dell'editor di query viene aggiornato. La clausola FROM elenca una voce simile alla seguente:

      `PROJECT_ID.us._Trace.Spans._AllSpans`
      

   4. Nella barra degli strumenti, seleziona Esegui query.

      Se nella barra degli strumenti viene visualizzato Esegui in BigQuery, fai clic su Impostazioni e seleziona Analytics (impostazione predefinita).

   Hai verificato di poter eseguire query sui dati di traccia utilizzando la pagina Observability Analytics.

3. (Facoltativo) Se vuoi unire i dati di traccia ad altri dati aziendali disponibili per BigQuery, crea un set di dati BigQuery collegato. Per saperne di più, consulta Eseguire una query su un set di dati BigQuery collegato.

4. Elimina i sink di traccia e i set di dati non necessari:

   1. Per elencare i sink di traccia esistenti, esegui il comando gcloud alpha trace sinks list:

      gcloud alpha trace sinks list
      

   2. Per ogni sink, esegui il comando gcloud alpha trace sinks delete:

      gcloud alpha trace sinks delete SINK_NAME
      

   3. (Facoltativo) Elimina i set di dati BigQuery non necessari. Per informazioni su come eliminare un set di dati BigQuery, consulta Eliminare i set di dati.

Confronto degli schemi

Questa sezione fornisce informazioni sulle differenze tra gli schemi di esportazione basati su sink e Observability Analytics.

Nome	Analytics	Legacy
ID traccia	trace_id	extendedFields.traceId
ID intervallo	span_id	span.spanId
ID span padre	parent_span_id	span.parentSpanId
Nome span	name	span.displayName.value
Tipo intervallo	kind Per i valori, vedi OpenTelemetry: SpanKind.	span.spanKind Per i valori, consulta la pagina di riferimento dell'Cloud Trace API SpanKind.
Ora di inizio dell'intervallo	start_time	span.startTime
Ora di fine intervallo	end_time	span.endTime
Attributi	Gli attributi di span, risorsa e strumentazione hanno ciascuno un formato univoco. Questi campi hanno il tipo di dati JSON di BigQuery. Esempi: attributes["somekey"] resource.attributes["somekey"] instrumentation_scope.attributes["somekey"]	Tutti gli attributi utilizzano lo stesso formato: span.attributes.attributeMap.ATTRIBUTE_KEY Esempi: span.attributes.attributeMap._http_method span.attributes.attributeMap.g_co_agent span.attributes.attributeMap.rpc_service span.attributes.attributeMap.rpc_method

Passaggi successivi

• Esegui query e analizza le tracce
• Query di esempio