Creare, eseguire query e gestire le visualizzazioni di analisi

Anteprima

Questo prodotto o questa funzionalità sono soggetti ai "Termini dell'offerta pre-GA" nella sezione 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 saperne di più, consulta le descrizioni della fase di lancio.

Questo documento descrive come creare, gestire ed eseguire query sulle viste di analisi. Per una panoramica concettuale, consulta Informazioni sulle viste di Analytics.

Prima di iniziare

Nota: non esistono ruoli Identity and Access Management (IAM) di Cloud Logging predefiniti che contengano le autorizzazioni necessarie per creare o interrogare una visualizzazione di analisi.

Poiché le viste Analytics eseguono query sulle viste dei log, per creare ed eseguire query sulle viste Analytics, i tuoi ruoli IAM devono anche consentirti di eseguire query sulle viste dei log e utilizzare Analisi dei log. Questa sezione elenca i ruoli IAM necessari per creare viste di analisi e quelli necessari per eseguire query sulle viste dei log e utilizzare Log Analytics:

• Per ottenere le autorizzazioni necessarie per creare, gestire e utilizzare le visualizzazioni di analisi, chiedi all'amministratore di concederti il ruolo IAM Observability Analytics User (roles/observability.analyticsUser) sul progetto.

  Questo ruolo predefinito contiene le autorizzazioni necessarie per creare, gestire e utilizzare le visualizzazioni di analisi. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

  Autorizzazioni obbligatorie

  Per creare, gestire e utilizzare le visualizzazioni di analisi sono necessarie le seguenti autorizzazioni:

  • observability.analyticsViews.get
  • observability.analyticsViews.list
  • observability.analyticsViews.create
  • observability.analyticsViews.update
  • observability.analyticsViews.delete

• Per ottenere le autorizzazioni necessarie per eseguire query su una visualizzazione log e utilizzare Log Analytics, chiedi all'amministratore di concederti i seguenti ruoli IAM sul progetto:

  • Per eseguire query sui bucket di log _Required e _Default: Visualizzatore log (roles/logging.viewer)
  • Per eseguire query su tutte le visualizzazioni dei log in un progetto: 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 binding IAM al file delle norme della visualizzazione di log. Per ulteriori informazioni, vedi Controllare l'accesso a una visualizzazione dei log.

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

Creare una vista di analisi

Nota: una vista Analytics può eseguire query solo sulle visualizzazioni di log. Quando vengono eseguite query su più visualizzazioni di log, i bucket di log che ospitano queste visualizzazioni devono trovarsi in un'unica posizione. Ad esempio, se hai due bucket di log nella località us-east1, puoi creare una vista Analytics che esegue query sulle viste dei log in questi 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. Nel menu Visualizzazioni, vai alla sezione segmento Log e poi seleziona la visualizzazione dei log da interrogare.

   Per trovare una visualizzazione log, puoi utilizzare la barra Filtro o scorrere l'elenco delle visualizzazioni log. Ogni voce dell'elenco è nel seguente formato BUCKET_ID.LOG_VIEW_ID, dove questi campi si riferiscono agli ID del bucket di log e della visualizzazione log.

3. Nella barra degli strumenti Schema, fai clic su Query.

   Il riquadro Query viene aggiornato con una query SQL.

4. Assicurati che nella barra degli strumenti sia visualizzata l'opzione Esegui query.

   Se la barra degli strumenti mostra Esegui in BigQuery, fai clic su Impostazioni e seleziona Log Analytics (impostazione predefinita).

5. Aggiorna la query SQL nel riquadro Query finché non sei soddisfatto dei risultati della query.

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

7. Inserisci un nome e una descrizione per la visualizzazione di Analytics, quindi fai clic su Salva.

   Il nome è limitato a 100 caratteri e può includere solo lettere, cifre, trattini bassi e trattini.

   Nota: non puoi modificare il nome di una vista Analytics dopo la sua creazione. Puoi modificare la descrizione e la query.

   La vista Analytics viene creata e visualizzata nel riquadro Viste, nella sezione intitolata data_table Viste Analytics. Ogni voce dell'elenco è nel seguente formato LOCATION.ANALYTICS_VIEW_ID, dove questi campi si riferiscono alla posizione e all'ID di una vista Analytics. Ad esempio, se hai creato una vista Analytics con il nome my-analytic-view che esegue query su una vista log il cui bucket log si trova nella regione global, questa sezione mostra global.my-analytic-view.

Esegui query su una vista analitica

Una volta creata una vista Analytics, puoi eseguire query su di essa in modo simile a una vista log. Per un elenco di documenti che descrivono come utilizzare la pagina Analisi dei log, consulta la sezione Passaggi successivi di questo documento.

Per eseguire la query predefinita per una visualizzazione analitica:

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. Inserisci una query o carica la query predefinita per la visualizzazione Analytics. La clausola FROM per la query deve avere il seguente formato:

   FROM `analytics_view.PROJECT_ID.LOCATION.ANALYTICS_VIEW_ID`
   

   Nell'espressione precedente, i campi hanno il seguente significato:

   • PROJECT_ID: l'identificatore del progetto.
   • LOCATION: la posizione della vista Analytics. La posizione di una vista Analytics viene ereditata dalla risorsa che interroga. Ad esempio, se una vista Analytics esegue query su una vista log che si trova nella località global, anche la località della vista Analytics è global.
   • ANALYTICS_VIEW_ID: l'ID della visualizzazione Analytics, che è limitato a 100 caratteri e può includere solo lettere, cifre, trattini bassi e trattini.

   Per eseguire la query predefinita, segui questi passaggi:

   1. Nel menu Viste, vai alla sezione data_table Viste Analytics e seleziona la vista Analytics che vuoi interrogare.

      Per trovare una vista Analytics, puoi utilizzare la barra Filtro o scorrere l'elenco delle viste Analytics. Ogni voce dell'elenco è nel seguente formato LOCATION.ANALYTICS_VIEW_ID, dove questi campi si riferiscono alla posizione e all'ID di una vista Analytics.

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

      Il riquadro Query viene aggiornato con una query SQL che esegue query sulla vista Analytics selezionata.

3. Fai clic su Esegui query.

   Se la barra degli strumenti mostra Esegui in BigQuery, fai clic su Impostazioni e seleziona Log Analytics (impostazione predefinita).

Visualizzare le viste di analisi

Per elencare le viste Analytics nel tuo progetto Google Cloud :

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. Nel menu Visualizzazioni, vai alla sezione data_table Visualizzazioni Analytics.

   Viene visualizzato un elenco di viste di Analytics. Ogni voce dell'elenco è nel seguente formato LOCATION.ANALYTICS_VIEW_ID, dove questi campi si riferiscono alla posizione e all'ID di una vista Analytics. Ad esempio, se hai creato una vista Analytics con il nome my-analytic-view che esegue query su una vista log il cui bucket log si trova nella regione global, questa sezione mostra global.my-analytic-view.

3. Per visualizzare i dettagli di una visualizzazione di Analytics specifica:

   1. Seleziona la vista Analytics.

      Lo schema della visualizzazione Analytics viene mostrato nella sezione Schema.

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

      La finestra di dialogo mostra informazioni sulla vista Analytics, tra cui la data di creazione, lo schema e la query.

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. Nel menu Viste, vai alla sezione data_table Viste Analytics e seleziona la vista Analytics che vuoi interrogare.

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

4. Dopo aver apportato le modifiche, fai clic su Sovrascrivi visualizzazione 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. Nel menu Viste, vai alla sezione data_table Viste Analytics e seleziona la vista Analytics che vuoi interrogare.
3. 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 vista Analytics non può eseguire query su un'altra vista Analytics.
• Una vista di analisi può eseguire query su più viste dei log. Tuttavia, i bucket di log che ospitano le visualizzazioni dei log sottoposte a query devono trovarsi in un'unica posizione. Ad esempio, supponiamo di avere due bucket di log, uno in us-east1 e l'altro in asia-east1. Non puoi creare una vista Analytics che esegue query sulle visualizzazioni dei log in questi bucket di log.
• La risorsa padre di una vista Analytics deve essere un progetto Google Cloud . Non puoi creare una vista Analytics in cartelle o organizzazioni.
• I set di dati collegati non sono supportati per le viste Analytics. Pertanto, puoi eseguire query sulle viste Analytics solo utilizzando la pagina Analisi dei log. Inoltre, devi eseguire queste query sul servizio Cloud Logging predefinito.
• Non è disponibile il supporto API per la creazione o la gestione delle viste Analytics.

• Alle viste di Analytics si applicano i seguenti limiti:

  • Numero massimo di viste Analytics per Google Cloud progetto: 100
  • Per progetto Google Cloud , il numero massimo di viste Analytics per regione: 50
  • Per progetto Google Cloud , il numero massimo di regioni che possono archiviare le viste Analytics: 10

Passaggi successivi

• Eseguire query e analizzare la panoramica dei log
• Salvare e condividere una query SQL
• Visualizzare i risultati delle query SQL in un grafico
• Esempi di query SQL