Eseguire la migrazione a Observability Analytics

Anteprima

Questo prodotto o funzionalità sono soggetti ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Se utilizzi i sink per esportare i dati di traccia in BigQuery, allora questo documento è valido per te. L'utilizzo dei sink per esportare i dati di traccia non è più consigliato. Ti consigliamo invece di utilizzare Observability Analytics, che supporta lo stesso SQL linguaggio di query di BigQuery. Questo documento descrive come eseguire la migrazione da una soluzione basata su sink a una che utilizza Observability Analytics. Include anche informazioni su come eseguire query sui dati di traccia utilizzando i servizi BigQuery.

BigQuery fornisce servizi che consentono di copiare le tabelle o esportare i dati. Puoi copiare ed esportare i dati di traccia utilizzando questi servizi dopo aver creato un set di dati BigQuery collegato, un passaggio facoltativo descritto in dettaglio in questo documento. Per ulteriori informazioni, consulta Gestire le tabelle e Introduzione all'esportazione dei dati.

Per iniziare a utilizzare Observability Analytics, consulta Eseguire query e analizzare le tracce.

Prima di iniziare

Accedi al tuo Google Cloud account. 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 workload.

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.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. 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.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. 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 collegato, chiedi all'amministratore di concederti i seguenti ruoli IAM nel progetto:

   • Amministratore Cloud Trace (roles/cloudtrace.admin)
   • Editor di osservabilità (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 Google Cloud console, attiva Cloud Shell.

   Attiva Cloud Shell

   Nella parte inferiore della Google Cloud console, viene avviata una sessiona di Cloud Shell e viene visualizzato un prompt della riga di comando. Cloud Shell è un ambiente shell con Google Cloud CLI già inclusa e 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 Google Cloud console, vai alla Observability Analytics pagina:

      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 , quindi seleziona _Trace.Spans._AllSpans.

      Il riquadro Schema viene aggiornato e mostra lo schema.

      Se non vedi una visualizzazione denominata _Trace.Spans._AllSpans, allora il tuo Google Cloud progetto non contiene un bucket di osservabilità denominato _Trace. Per informazioni su come risolvere questa situazione, consulta Inizializzazione dell'archiviazione delle tracce non riuscita.

   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 ulteriori informazioni, consulta Eseguire 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 gcloud alpha trace sinks list comando:

      gcloud alpha trace sinks list
      

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

      gcloud alpha trace sinks delete SINK_NAME
      

   3. (Facoltativo) Elimina eventuali 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 Observability Analytics e sink.

Nome	Analytics	Legacy
ID traccia	trace_id	extendedFields.traceId
ID intervallo	span_id	span.spanId
ID intervallo padre	parent_span_id	span.parentSpanId
Nome intervallo	name	span.displayName.value
Tipo intervallo	kind Per i valori, consulta OpenTelemetry: SpanKind.	span.spanKind Per i valori, consulta la pagina di riferimento dell'Cloud Trace API SpanKind.
Ora di inizio intervallo	start_time	span.startTime
Ora di fine intervallo	end_time	span.endTime
Attributi	Gli attributi di intervallo, 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

• Eseguire query e analizzare le tracce.
• Query di esempio.