Creare, interrogare e gestire le viste di 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.

Le visualizzazioni Analytics in Observability Analytics ti consentono di definire una query SQL con uno schema personalizzato sui dati di Cloud Trace, in modo da semplificare e riutilizzare trasformazioni complesse. Dopo aver creato una vista di analisi, puoi eseguire query sui relativi risultati nella clausola FROM di altre query SQL, proprio come esegui query sulle viste di osservabilità.

Per una panoramica delle visualizzazioni di Analytics, consulta Informazioni sulle visualizzazioni di Analytics.

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 creare, gestire e utilizzare le visualizzazioni di analisi, chiedi all'amministratore di concederti i seguenti ruoli IAM:

   • Observability View Accessor (roles/observability.viewAccessor) sulle viste di osservabilità che vuoi interrogare. Questo ruolo supporta le condizioni IAM, che consentono di limitare la concessione a una visualizzazione specifica. Se non colleghi una condizione alla concessione del ruolo, l'entità può accedere a tutte le visualizzazioni di osservabilità.
   • Utente Observability Analytics (roles/observability.analyticsUser) sul tuo progetto. Questo ruolo contiene le autorizzazioni necessarie per salvare ed eseguire query private ed eseguire query condivise.

   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. Assicurati di avere una visualizzazione di osservabilità. Per saperne di più, consulta Modello di archiviazione di Cloud Trace.

Creare una vista di analisi

Nota: una vista di analisi può eseguire query sulle viste di osservabilità. Se una vista di analisi esegue query su più viste, queste devono trovarsi nella stessa posizione.

Per creare una vista di analisi, procedi nel seguente modo:

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. Configura la pagina Observability Analytics:
   1. Assicurati che nella barra degli strumenti sia visualizzato Esegui query. Se la barra degli strumenti mostra Esegui in BigQuery, fai clic su Impostazioni e seleziona Observability Analytics (impostazione predefinita).
   2. Se il menu Viste non viene visualizzato, vai al riquadro di navigazione e fai clic su Viste e schema.

3. Inserisci e convalida la query che vuoi salvare come vista di analisi.

   Potresti voler caricare e modificare la query predefinita per la visualizzazione di osservabilità che la vista di analisi eseguirà. Per caricare la query predefinita:

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

   2. Nella barra degli strumenti Schema, fai clic su Query e poi su Sovrascrivi.

      Il riquadro Query viene aggiornato con una query SQL.

   3. Aggiorna la query finché non sei soddisfatto dei risultati.

4. Crea una vista di analisi:

   1. Nella barra degli strumenti, fai clic su Salva Salva, quindi seleziona Salva come vista di analisi.

   2. Inserisci un nome e una descrizione per la vista di analisi.

      Il nome è limitato a 100 caratteri e può includere solo lettere, cifre, trattini bassi e trattini. Non puoi modificare il nome dopo aver creato la vista di analisi.

   3. Fai clic su Salva.

   Il sistema crea la vista di analisi e la elenca nel riquadro Viste, nella sezione Viste di analisi della data_table.

Eseguire query su una vista di analisi

Esegui una query su una vista di analisi in modo analogo all'esecuzione di query sulle viste di osservabilità. Per eseguire query sulle viste Analytics, utilizza il seguente formato per la clausola FROM:

FROM `analytics_view.PROJECT_ID.LOCATION.ANALYTICS_VIEW_ID`

I campi nelle espressioni precedenti hanno il seguente significato:

• PROJECT_ID: l'identificatore del progetto.
• LOCATION: la posizione della vista di analisi.
• ANALYTICS_VIEW_ID: l'ID della vista di analisi, che è limitato a 100 caratteri e può includere solo lettere, cifre, trattini bassi e trattini.

Per saperne di più, consulta Esegui query e analizza le tracce.

Visualizzare le viste di analisi degli elenchi

Per elencare le viste Analytics nel tuo progetto Google Cloud :

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. Configura la pagina Observability Analytics:
   1. Assicurati che nella barra degli strumenti sia visualizzato Esegui query. Se la barra degli strumenti mostra Esegui in BigQuery, fai clic su Impostazioni e seleziona Observability Analytics (impostazione predefinita).
   2. Se il menu Viste non viene visualizzato, vai al riquadro di navigazione e fai clic su Viste e schema.

3. Nel menu Visualizzazioni, vai alla sezione data_table Visualizzazioni Analytics.

Visualizzare i dettagli di una vista di analisi

Puoi utilizzare le opzioni nel riquadro Schema per visualizzare le seguenti informazioni su una vista di analisi:

• Nome
• Data di creazione
• Ultimo aggiornamento
• Schema
• Query

Per visualizzare i dettagli di una vista di analisi, elenca le viste di analisi nel tuo progetto, quindi procedi nel seguente modo:

1. Seleziona la vista di Analytics di cui vuoi visualizzare le informazioni.
2. Nella barra degli strumenti Schema, fai clic su Visualizza le opzioni della vista di analisi e seleziona Visualizza dettagli.

Modificare una vista di analisi

Per modificare una vista di analisi, procedi nel seguente modo:

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. Configura la pagina Observability Analytics:
   1. Assicurati che nella barra degli strumenti sia visualizzato Esegui query. Se la barra degli strumenti mostra Esegui in BigQuery, fai clic su Impostazioni e seleziona Observability Analytics (impostazione predefinita).
   2. Se il menu Viste non viene visualizzato, vai al riquadro di navigazione e fai clic su Viste e schema.

3. Nel menu Visualizzazioni, vai alla sezione data_table Viste di analisi e seleziona la vista di analisi che vuoi modificare.

4. Nella barra degli strumenti Schema, fai clic su Visualizza le opzioni della vista di analisi e seleziona Area di modifica.

   Si apre una finestra di dialogo che mostra informazioni sulla vista di analisi. Puoi modificare la descrizione e la query.

5. Dopo aver completato le modifiche, fai clic su Sovrascrivi vista salvata.

Eliminare una vista di analisi

Nota :se hai scritto query su una vista di analisi ed elimini la vista di analisi, queste query non andranno a buon fine.

Per eliminare una vista di analisi, procedi nel seguente modo:

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. Configura la pagina Observability Analytics:
   1. Assicurati che nella barra degli strumenti sia visualizzato Esegui query. Se la barra degli strumenti mostra Esegui in BigQuery, fai clic su Impostazioni e seleziona Observability Analytics (impostazione predefinita).
   2. Se il menu Viste non viene visualizzato, vai al riquadro di navigazione e fai clic su Viste e schema.

3. Nel menu Visualizzazioni, vai alla sezione data_table Viste di analisi e seleziona la vista di analisi che vuoi eliminare.
4. Nella barra degli strumenti Schema, fai clic su Visualizza le opzioni della vista di analisi, seleziona Elimina vista e completa la finestra di dialogo.

Limitazioni

Alle visualizzazioni di Analytics si applicano le seguenti limitazioni:

• Una vista di analisi può eseguire query solo sulle viste di osservabilità.
• La risorsa padre di una vista di analisi deve essere un progetto Google Cloud .
• Puoi eseguire query su una vista di analisi solo utilizzando la pagina Observability Analytics e solo quando utilizzi il motore di query Observability Analytics (predefinito).
• Tutte le viste che una vista di analisi interroga devono trovarsi nella stessa posizione.
• Per creare o gestire le viste di analisi, devi utilizzare la console Google Cloud .
• Puoi creare al massimo 100 viste Analytics per Google Cloud progetto.
• Puoi creare al massimo 50 viste Analytics per regione.
• Per Google Cloud progetto, al massimo 10 regioni possono contenere una vista di analisi.

Passaggi successivi

• Esegui query e analizza le tracce
• Grafici dei risultati delle query SQL
• Salvare e condividere le query
• Query SQL di esempio