Eseguire la migrazione ad Analisi dei log

Anteprima

Questo prodotto o funzionalità sono soggetti ai "Termini delle Offerte pre-GA" nella sezione 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 saperne di più, consulta le descrizioni della fase di lancio.

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

Per iniziare a utilizzare Analisi dei log, 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 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 Log Analytics, eseguire query e creare un set di dati collegato, chiedi all'amministratore di concederti i seguenti ruoli IAM sul 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 ad Analisi dei log

1. Completato 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 Log Analytics:

   1. Nella console Google Cloud , vai alla pagina Analisi dei log:

      Vai ad Analisi dei log

      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 visualizzazione 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 Analisi dei log.

3. (Facoltativo) Se vuoi unire i dati delle tracce ad altri dati aziendali disponibili per BigQuery, crea un set di dati BigQuery collegato. Per saperne di più, 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 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 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 Analisi dei log e sui sink.

Nome	Analytics	Legacy
ID traccia	trace_id	extendedFields.traceId
ID intervallo	span_id	span.spanId
ID span 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 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.