Creare, interrogare e gestire le viste di Analytics

Questo documento descrive come creare e gestire le viste Analytics. Dopo aver creato una vista di analisi, puoi eseguire query su di essa in modo simile a come esegui query sulle viste dei log. Se non hai familiarità con le viste Analytics, consulta Informazioni sulle viste Analytics.

Prima di iniziare

1. Verifica che la fatturazione sia attivata per il tuo progetto Google Cloud .

2. Per ottenere le autorizzazioni necessarie per creare, gestire e utilizzare le visualizzazioni di analisi, chiedi all'amministratore di concederti i seguenti ruoli IAM nel progetto:

   • Utente Observability Analytics (roles/observability.analyticsUser)
   • Logs View Accessor (roles/logging.viewAccessor)

   Puoi limitare un'entità a una visualizzazione di log specifica aggiungendo una condizione IAM alla concessione del ruolo Accessore visualizzazione log effettuata a livello di progetto oppure aggiungendo un'associazione IAM al file della policy della visualizzazione di log. Per saperne di più, consulta Controllare l'accesso a una visualizzazione log.

   Per informazioni su altri ruoli necessari per eseguire query sulle visualizzazioni dei bucket definiti dall'utente o per eseguire query sulla visualizzazione _AllLogs del bucket di log _Default, consulta Ruoli Cloud Logging.

3. Assicurati di avere un bucket di log di cui è stato eseguito l'upgrade per utilizzare Observability Analytics. Per informazioni su questo passaggio, vedi Configura i bucket di log.

Creare una vista di analisi

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

1. Nella console Google Cloud , vai alla pagina manage_search 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 settings Impostazioni e seleziona Observability Analytics (impostazione predefinita).
   2. Se il menu Viste non viene visualizzato, vai al riquadro di navigazione e fai clic su last_page 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 dei log che la tua vista di analisi eseguirà. Per caricare la query predefinita:

   1. Nel menu Visualizzazioni, vai alla sezione segmento Log, trova e seleziona la visualizzazione log per cui vuoi eseguire una query.

   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 dei log. 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 Panoramica delle query e dell'analisi dei log.

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 manage_search 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 settings Impostazioni e seleziona Observability Analytics (impostazione predefinita).
   2. Se il menu Viste non viene visualizzato, vai al riquadro di navigazione e fai clic su last_page 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 more_vert 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 manage_search 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 settings Impostazioni e seleziona Observability Analytics (impostazione predefinita).
   2. Se il menu Viste non viene visualizzato, vai al riquadro di navigazione e fai clic su last_page 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 more_vert 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

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

1. Nella console Google Cloud , vai alla pagina manage_search 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 settings Impostazioni e seleziona Observability Analytics (impostazione predefinita).
   2. Se il menu Viste non viene visualizzato, vai al riquadro di navigazione e fai clic su last_page 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 more_vert 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 dei log.
• 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

• Panoramica delle query e dell'analisi dei log
• Salvare e condividere una query SQL
• Grafici dei risultati delle query SQL
• Query SQL di esempio