Creare, eseguire query e gestire le visualizzazioni di analisi

Preview

This product or feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms. Pre-GA products and features are available "as is" and might have limited support. For more information, see the launch stage descriptions.

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

Prima di iniziare

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

Poiché le visualizzazioni di analisi eseguono query sulle visualizzazioni di log, per creare e eseguire query sulle visualizzazioni di analisi, i tuoi ruoli IAM devono consentirti anche di eseguire query sulle visualizzazioni di log e di utilizzare Log Analytics. Questa sezione elenca i ruoli IAM necessari per creare visualizzazioni di analisi e quelli necessari per eseguire query sulle visualizzazioni 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 Utente di analisi dell'osservabilità (roles/observability.analyticsUser) nel progetto.

  Questo ruolo predefinito contiene le autorizzazioni necessarie per creare, gestire e utilizzare le visualizzazioni di analisi. Per visualizzare le autorizzazioni esatte richieste, espandi la sezione Autorizzazioni richieste:

  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 nel 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 Accesso alla visualizzazione dei log effettuata a livello di progetto o aggiungendo un'associazione IAM al file di criteri della visualizzazione di log. Per ulteriori informazioni, consulta Controllare l'accesso a una visualizzazione dei log.

  Per informazioni sui ruoli aggiuntivi 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 di Cloud Logging.

Creare una visualizzazione di analisi

Nota: una visualizzazione di analisi può eseguire query solo sulle visualizzazioni di log. Quando vengono eseguite query su più visualizzazioni di log, i bucket di log che le ospitano devono trovarsi in una posizione. Ad esempio, se hai due bucket di log nella posizione us-east1, puoi creare una vista di analisi che esegue query sulle viste dei log in questi bucket.

Per creare una visualizzazione di analisi:

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 Log del segmento e seleziona la visualizzazione dei log per cui eseguire la query.

   Per trovare una visualizzazione del log, puoi utilizzare la barra Filtra o scorrere l'elenco delle visualizzazioni dei log. Ogni voce dell'elenco è nel seguente formato BUCKET_ID.LOG_VIEW_ID, dove questi campi fanno riferimento agli ID del bucket dei log e della vista dei 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 nella barra degli strumenti viene visualizzato Esegui in BigQuery, fai clic su Impostazioni e seleziona Log Analytics (predefinito).

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 e poi seleziona Salva come vista di analisi.

7. Inserisci un nome e una descrizione per la visualizzazione di analisi, 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 di analisi dopo averla creata. Puoi modificare la descrizione e la query.

   La vista di analisi viene creata ed elencata nel riquadro Viste, nella sezione data_table Viste di analisi. Ogni voce dell'elenco è nel seguente formatoLOCATION.ANALYTICS_VIEW_ID, dove questi campi fanno riferimento alla posizione e all'ID di una visualizzazione di analisi. Ad esempio, se hai creato una visualizzazione di analisi con il nome my-analytic-view che esegue query su una visualizzazione dei log il cui bucket dei log si trova nella global regione, in questa sezione viene visualizzato global.my-analytic-view.

Esegui una query su una vista di analisi

Una volta creata una vista di analisi, puoi eseguire una query in modo simile a come esegui una query su una vista di 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 di analisi:

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 quella predefinita per la visualizzazione Dati. 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 Dati. La posizione di una vista di analisi viene ereditata dalle query della risorsa. Ad esempio, se una vista di analisi esegue query su una vista di log che si trova nella posizione global, la posizione della vista di analisi è anche global.
   • ANALYTICS_VIEW_ID: l'ID della visualizzazione di Dati, 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 Viste di analisi di data_table e seleziona la vista di analisi per cui vuoi eseguire una query.

      Per trovare una vista di analisi, puoi utilizzare la barra Filtro o scorrere l'elenco delle viste di analisi. Ogni voce dell'elenco è nel seguente formatoLOCATION.ANALYTICS_VIEW_ID, dove questi campi fanno riferimento alla posizione e all'ID di una visualizzazione di analisi.

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

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

3. Fai clic su Esegui query.

   Se nella barra degli strumenti viene visualizzato Esegui in BigQuery, fai clic su Impostazioni e seleziona Log Analytics (predefinito).

Elenco delle visualizzazioni di Dati

Per elencare le visualizzazioni di analisi 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 Visualizzazioni di analisi di data_table.

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

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

   1. Seleziona la visualizzazione di Dati.

      Lo schema della visualizzazione di Dati è 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 di analisi, tra cui la data di creazione, lo schema e la query.

Modificare una visualizzazione di Dati

Per modificare una visualizzazione di analisi:

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 Viste di analisi di data_table e seleziona la vista di analisi per cui vuoi eseguire una query.

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 visualizzazione Dati. Puoi modificare la descrizione e la query.

4. Dopo aver apportato le modifiche, fai clic su Sostituisci visualizzazione salvata.

Eliminare una visualizzazione di analisi

Nota: se hai scritto query per una visualizzazione di analisi ed elimini la visualizzazione di analisi, queste query non andranno a buon fine.

Per eliminare una visualizzazione di analisi:

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 Viste di analisi di data_table e seleziona la vista di analisi per cui vuoi eseguire una query.
3. Nella barra degli strumenti Schema, fai clic su Visualizza opzioni di visualizzazione di Dati, seleziona Elimina visualizzazione e completa la finestra di dialogo.

Limitazioni

Alle visualizzazioni di analisi si applicano le seguenti limitazioni:

• Una visualizzazione di Dati non può eseguire query su un'altra visualizzazione di Dati.
• Una visualizzazione di analisi può eseguire query su più visualizzazioni di log. Tuttavia, i bucket di log che ospitano le visualizzazioni di log sottoposte a query devono trovarsi in una posizione. Ad esempio, supponiamo che tu abbia due bucket di log, uno in us-east1 e l'altro in asia-east1. Non puoi creare una visualizzazione di analisi che esegui query sulle visualizzazioni dei log su questi bucket di log.
• La risorsa principale di una visualizzazione di analisi deve essere un progetto Google Cloud. Non puoi creare una visualizzazione di analisi in cartelle o organizzazioni.
• I set di dati collegati non sono supportati per le visualizzazioni di analisi. Pertanto, puoi eseguire query sulle visualizzazioni di analisi solo utilizzando la pagina Analisi dei log. Inoltre, devi eseguire queste query sul servizio Cloud Logging predefinito.
• Non è previsto il supporto dell'API per la creazione o la gestione delle visualizzazioni di analisi.

• Ai report di analisi si applicano i seguenti limiti:

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

Passaggi successivi

• Panoramica di query e analisi dei log
• Salvare e condividere una query SQL
• Grafica i risultati delle query SQL
• Esempi di query SQL