Creare, interrogare e gestire le viste di Analytics

Anteprima

Questo prodotto o funzionalità è soggetto ai "Termini delle Offerte pre-GA" nella sezione Termini di servizio generali dei Termini di servizio specifici. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni delle fasi di lancio.

Questo documento descrive come creare e gestire le viste di Analytics. Dopo aver creato una vista Analytics, puoi eseguirvi query in modo simile a come esegui query su viste log e 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 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.

Abilita l'API Observability.

Ruoli richiesti per abilitare le API

Per abilitare le API, devi disporre del ruolo IAM Amministratore utilizzo dei servizi (roles/serviceusage.serviceUsageAdmin), che include l'autorizzazione serviceusage.services.enable. Scopri come concedere i ruoli.

Abilitare l'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.

Abilita l'API Observability.

Ruoli richiesti per abilitare le API

Per abilitare le API, devi disporre del ruolo IAM Amministratore utilizzo dei servizi (roles/serviceusage.serviceUsageAdmin), che include l'autorizzazione serviceusage.services.enable. Scopri come concedere i ruoli.

Abilitare l'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 visualizzazioni di osservabilità che vuoi interrogare. Questo ruolo supporta le condizioni IAM, che ti 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à. Le visualizzazioni di osservabilità sono in Anteprima pubblica.
   • Observability Analytics User (roles/observability.analyticsUser) sul tuo progetto. Questo ruolo contiene le autorizzazioni necessarie per salvare ed eseguire query private ed eseguire query condivise.
   • Visualizzatore log (roles/logging.viewer) sul tuo progetto.
   • Logs View Accessor (roles/logging.viewAccessor) sul progetto che memorizza le visualizzazioni log su cui vuoi eseguire query. Puoi limitare la concessione di questo ruolo a una visualizzazione specifica aggiungendo una condizione IAM.

   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 disporre di almeno uno dei seguenti elementi:
   • Un bucket di log di cui è stato eseguito l'upgrade per utilizzare Analisi dei log. Per saperne di più, consulta Configurare i bucket dei log.
   • Una visualizzazione di osservabilità. Per saperne di più, consulta la pagina Modello di archiviazione di Cloud Trace.

Creare una vista di analisi

Nota: una visualizzazione Analytics può eseguire query su visualizzazioni di log e visualizzazioni di osservabilità. Quando una vista Analytics interroga più viste, queste devono trovarsi nella stessa posizione. Ad esempio, se hai due bucket di log nella località us-east1, puoi creare una vista di analisi che esegue query sulle viste di log in questi due bucket di log.

Per creare una vista 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. Configura la pagina Analisi dei log:
   1. Assicurati che nella barra degli strumenti sia visualizzato il pulsante Esegui query. Se la barra degli strumenti mostra Esegui in BigQuery, allora fai clic su Impostazioni e seleziona Log 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 analitica.

   Potresti voler caricare e modificare la query predefinita per la visualizzazione dei log o la visualizzazione dell'osservabilità che la visualizzazione Analytics eseguirà. Per caricare la query predefinita:

   1. Nel menu Visualizzazioni, esegui una delle seguenti operazioni:

      • Vai alla sezione segmento Log e seleziona una visualizzazione dei log.
      • Vai alla sezione Tracce e 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é i risultati non ti soddisfano.

4. Creare una vista Analytics:

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

   2. Inserisci un nome e una descrizione per la visualizzazione di Analytics.

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

   3. Fai clic su Salva.

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

Esegui query su una vista analitica

Esegui una query su una vista di analisi in modo analogo all'esecuzione di query su viste dei log e viste di osservabilità. Per eseguire query sulle visualizzazioni 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 Analytics.
• ANALYTICS_VIEW_ID: l'ID della visualizzazione Analytics, che è limitato a 100 caratteri e può includere solo lettere, cifre, trattini bassi e trattini.

Per saperne di più, consulta Analisi dei log.

Visualizzare le viste di analisi

Per elencare le viste Analytics nel tuo Google Cloud progetto:

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. Configura la pagina Analisi dei log:
   1. Assicurati che nella barra degli strumenti sia visualizzato il pulsante Esegui query. Se la barra degli strumenti mostra Esegui in BigQuery, allora fai clic su Impostazioni e seleziona Log 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 Analytics

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

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

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

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

Modificare una visualizzazione di Analytics

Per modificare una vista 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. Configura la pagina Analisi dei log:
   1. Assicurati che nella barra degli strumenti sia visualizzato il pulsante Esegui query. Se la barra degli strumenti mostra Esegui in BigQuery, allora fai clic su Impostazioni e seleziona Log 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 Viste, vai alla sezione data_table Viste Analytics e seleziona la vista Analytics che vuoi modificare.

4. Nella barra degli strumenti Schema, fai clic su Visualizza le opzioni della vista analitica e seleziona Modifica vista.

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

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

Eliminare una vista Analytics

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

Per eliminare una vista 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. Configura la pagina Analisi dei log:
   1. Assicurati che nella barra degli strumenti sia visualizzato il pulsante Esegui query. Se la barra degli strumenti mostra Esegui in BigQuery, allora fai clic su Impostazioni e seleziona Log 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 Viste, vai alla sezione data_table Viste Analytics e seleziona la vista Analytics che vuoi eliminare.
4. Nella barra degli strumenti Schema, fai clic su Visualizza opzioni di visualizzazione di Analytics, seleziona Elimina visualizzazione e completa la finestra di dialogo.

Limitazioni

Alle visualizzazioni di Analytics si applicano le seguenti limitazioni:

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

Passaggi successivi

• Esegui query e analizza la telemetria con Analisi dei log.
• Grafici dei risultati delle query SQL.
• Salva e condividi le query.
• Query SQL di esempio.