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.

Questo documento descrive come creare e gestire le viste analitiche. Dopo aver creato una vista analitica, puoi eseguirne una query in modo simile a quello delle viste dei log. Se non hai familiarità con le viste analitiche, consulta Informazioni sulle viste analitiche.

Prima di iniziare

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

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

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

   Puoi limitare un principal a una vista dei log specifica aggiungendo una condizione IAM alla concessione del ruolo Logs View Accessor effettuata a livello di progetto o aggiungendo un'associazione IAM al file di policy della vista dei log. Per ulteriori informazioni, consulta Controllare l'accesso a una vista dei log.

   Per informazioni sui ruoli aggiuntivi necessari per eseguire query sulle viste dei bucket definiti dall'utente o sulla vista _AllLogs del bucket di log _Default, consulta Ruoli di 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, consulta Configurare i bucket di log.

Creare una vista analitica

Nota: una vista analitica può eseguire query sulle viste dei log. Quando una vista analitica esegue query su più viste, queste devono trovarsi nella stessa località. Ad esempio, se hai due bucket di log nella località us-east1, puoi creare una vista analitica che esegue query sulle viste dei log di questi due bucket di log.

Per creare una vista analitica:

1. Nella Google Cloud console, vai alla Observability Analytics pagina:

   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 nella barra degli strumenti è visualizzato Esegui in BigQuery, allora fai clic su Impostazioni e seleziona Observability Analytics (predefinito).
   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 vista dei log su cui eseguirà query la vista analitica. Per caricare la query predefinita:

   1. Nel menu Viste, vai alla sezione del segmento Log, trova e seleziona la vista dei log su cui vuoi eseguire 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 della query.

4. Crea una vista analitica:

   1. Nella barra degli strumenti, fai clic su salva Salva e poi seleziona Salva come vista analitica.

   2. Inserisci un nome e una descrizione per la vista analitica.

      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 analitica e la elenca nel riquadro Viste, nella sezione data_table Viste analitiche.

Eseguire query su una vista analitica

Esegui query su una vista analitica in modo analogo a quello delle viste dei log. Per eseguire query sulle viste analitiche, 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 località della vista analitica.
• ANALYTICS_VIEW_ID: l'ID della vista analitica, 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.

Elencare le viste analitiche

Per elencare le viste analitiche nel tuo Google Cloud progetto:

1. Nella Google Cloud console, vai alla Observability Analytics pagina:

   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 nella barra degli strumenti è visualizzato Esegui in BigQuery, allora fai clic su Impostazioni e seleziona Observability Analytics (predefinito).
   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 analitiche.

Ottenere i dettagli di una vista analitica

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

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

Per visualizzare i dettagli di una vista analitica, elenca le viste analitiche nel tuo progetto e poi:

1. Seleziona la vista analitica 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 vista analitica

Per modificare una vista analitica:

1. Nella Google Cloud console, vai alla Observability Analytics pagina:

   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 nella barra degli strumenti è visualizzato Esegui in BigQuery, allora fai clic su Impostazioni e seleziona Observability Analytics (predefinito).
   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 data_table Viste analitiche sezione e seleziona la vista analitica che vuoi modificare.

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

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

5. Al termine delle modifiche, fai clic su Sovrascrivi vista salvata.

Eliminare una vista analitica

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

Per eliminare una vista analitica:

1. Nella Google Cloud console, vai alla Observability Analytics pagina:

   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 nella barra degli strumenti è visualizzato Esegui in BigQuery, allora fai clic su Impostazioni e seleziona Observability Analytics (predefinito).
   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 data_table Viste analitiche sezione e seleziona la vista analitica che vuoi eliminare.
4. Nella barra degli strumenti Schema, fai clic su Visualizza le opzioni della vista analitica, seleziona Elimina vista e completa la finestra di dialogo.

Limitazioni

Alle viste analitiche si applicano le seguenti limitazioni:

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

Passaggi successivi

• Panoramica delle query e dell'analisi dei log
• Salvare e condividere una query SQL
• Creare grafici dei risultati delle query SQL
• Esempi di query SQL