Creare, eseguire query e gestire le visualizzazioni di analisi

Questo documento descrive come creare e gestire le viste di Analytics. Dopo aver creato una vista Analytics, 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. Verify that billing is enabled for your Google Cloud project.

  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:

    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 dei criteri della visualizzazione di log. Per ulteriori informazioni, vedi Controllare l'accesso a una visualizzazione 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.

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

Creare una vista di analisi

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. Configura la pagina Analisi dei log:
    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 Log Analytics (impostazione 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 analitica.

    Potresti voler caricare e modificare la query predefinita per la visualizzazione log che verrà interrogata dalla visualizzazione Analytics. Per caricare la query predefinita:

    1. Nel menu Visualizzazioni, vai alla sezione Log, individua 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. Creare una vista Analytics:

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

    2. Inserisci un nome e una descrizione per la visualizzazione di Analytics.

      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 Analytics e la elenca nel riquadro Viste, nella sezione Viste Analytics della .

Esegui query su una vista analitica

Esegui una query su una vista Analytics in modo analogo all'esecuzione di query sulle viste dei log. Per eseguire query sulle visualizzazioni di 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 Analytics.
  • ANALYTICS_VIEW_ID: l'ID della visualizzazione Analytics, 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

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. Configura la pagina Analisi dei log:
    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 Log Analytics (impostazione predefinita).
    2. Se il menu Viste non viene visualizzato, vai al riquadro di navigazione e fai clic su Viste e schema.

  3. Nel menu Visualizzazioni, vai alla sezione Visualizzazioni Analytics.

Visualizzare i dettagli di una vista Analytics

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

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

Per visualizzare i dettagli di una vista Analytics, elenca le viste Analytics 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 Visualizza le opzioni della vista analitica e seleziona Visualizza dettagli.

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. Configura la pagina Analisi dei log:
    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 Log Analytics (impostazione 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 Viste Analytics e seleziona la vista Analytics che vuoi modificare.
  4. 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.

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

Eliminare una vista Analytics

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. Configura la pagina Analisi dei log:
    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 Log Analytics (impostazione 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 Viste Analytics e seleziona la vista Analytics che vuoi eliminare.
  4. 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 di analisi può eseguire query solo sulle viste dei log.
  • La risorsa padre di una vista Analytics deve essere un progetto Google Cloud .
  • Puoi eseguire query su una vista Analytics solo utilizzando la pagina Analisi dei log e solo quando utilizzi il motore di query Analisi dei log (impostazione predefinita).
  • Tutte le viste su cui viene eseguita una query da una vista Analytics devono trovarsi nella stessa posizione.
  • Per creare o gestire le viste di Analytics, devi utilizzare la console Google Cloud .
  • Puoi creare al massimo 100 viste Analytics per Google Cloud progetto.
  • Puoi creare un massimo di 50 viste Analytics per regione.
  • Per Google Cloud progetto, al massimo 10 regioni possono contenere una vista Analytics.

Passaggi successivi