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 viste di analisi in Observability Analytics ti consentono di definire una query SQL con uno schema personalizzato sui dati di Cloud Logging 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 fai per le query sulle visualizzazioni dei log.

Per una panoramica delle viste di analisi, consulta Informazioni sulle viste di analisi.

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 viste di analisi, chiedi all'amministratore di concederti i seguenti ruoli IAM nel progetto:

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

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

   Per informazioni sui ruoli aggiuntivi necessari per eseguire query sulle visualizzazioni sui bucket definiti dall'utente o per eseguire query sulla visualizzazione _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 Configura i bucket di log.

Crea una vista di analisi

Nota: una vista di analisi può eseguire query sulle visualizzazioni dei log. Se una vista di analisi 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 di analisi che esegue query sulle visualizzazioni dei log in questi due bucket di log.

Per creare una vista di analisi, segui questi passaggi:

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 (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 dei log su cui verrà eseguita la query della vista di analisi. Per caricare la query predefinita:

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

   2. Nella barra degli strumenti Schema, fai clic su Query, quindi 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 data_table Viste di analisi.

Esegui query su una vista di analisi

Puoi eseguire query su una vista di analisi in modo analogo alle query sulle viste log. Per eseguire query sulle viste di analisi, utilizza il seguente formato per la clausola FROM:

FROM `analytics_view.PROJECT_ID.LOCATION.ANALYTICS_VIEW_ID`

I campi delle espressioni precedenti hanno il seguente significato:

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

Per scoprire di più, consulta la panoramica delle query e dell'analisi dei log.

Elenca le viste di analisi

Per elencare le viste di analisi nel tuo progetto Google Cloud , segui questi passaggi:

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 (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 di analisi.

Ottieni dettagli su 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 segui questi passaggi:

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

Modifica una vista di analisi

Per modificare una vista di analisi, segui questi passaggi:

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 (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 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 Modifica vista.

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

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

Elimina una vista di analisi

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

Per eliminare una vista di analisi, segui questi passaggi:

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 (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 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 viste di analisi si applicano le seguenti limitazioni:

• Una vista di analisi può eseguire query solo sulle visualizzazioni 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 Analisi di Observability e solo quando utilizzi il motore di query Analisi di Observability (predefinito).
• Tutte le visualizzazioni su cui una vista di analisi esegue query devono trovarsi nella stessa località.
• Per creare o gestire le viste di analisi, devi utilizzare la console Google Cloud .
• Puoi creare un massimo di 100 viste di analisi per progetto Google Cloud .
• Puoi creare un massimo di 50 viste di analisi per regione.
• Per progetto Google Cloud , un massimo di 10 regioni può contenere una vista di analisi.

Passaggi successivi

• Panoramica delle query e dell'analisi dei log
• Salva e condividi una query SQL
• Crea grafici dei risultati delle query SQL
• Esempi di query SQL