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

  1. 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.

    Go to project selector

  2. Verify that billing is enabled for your Google Cloud project.

  3. 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

  4. 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:

    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.

  5. 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 init

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