Informazioni sulle viste Analytics

Le visualizzazioni Analytics in Observability Analytics consentono di definire una query SQL con uno schema personalizzato sui dati di osservabilità in modo da semplificare e riutilizzare trasformazioni complesse. Mentre puoi eseguire nuovamente solo una query salvata, puoi fare riferimento a una vista di analisi come origine dati nella clausola FROM di altre query SQL.

Panoramica

Una vista di analisi è una risorsa su cui puoi eseguire query. ovvero, dopo aver definito una vista di analisi, puoi scrivere query in cui specifichi la vista di analisi nella clausola FROM.

Il vantaggio principale dell'utilizzo delle viste di analisi è che non sei vincolato a interrogare i dati nel formato definito da un'API o da un sistema. Una vista di analisi ti consente di definire uno schema, semplificando le query o riducendo il tempo necessario per scriverle. La query in una visualizzazione Analytics può eseguire operazioni come conservare solo campi specifici, rinominare i campi, spostare i campi nidificati in una colonna di primo livello ed eseguire raggruppamenti e aggregazioni.

Le viste Analytics non sono viste materializzate. Una vista di analisi non è una vista precalcolata che memorizza periodicamente nella cache i risultati delle query. Pertanto, l'esecuzione di una query su una vista di analisi equivale all'esecuzione di una query sulle viste elencate nella query della vista di analisi.

Le viste Analytics sono più potenti delle query salvate, ovvero query che esegui nella pagina Observability Analytics e poi salvi. Puoi eseguire di nuovo una query salvata, ma non puoi eseguire query sui risultati di una query salvata.

Tipi di viste Analytics

Esistono due tipi di viste di Analytics: definite dall'utente e definite dal sistema:

  • Le viste Analytics definite dall'utente sono tutte le viste Analytics che crei. Puoi eseguire query, modificare ed eliminare le visualizzazioni di Analytics definite dall'utente.

  • Le viste Analytics definite dal sistema sono viste Analytics create dai serviziGoogle Cloud . Puoi eseguire query sulle viste di analisi definite dal sistema. Tuttavia, non puoi modificarli o eliminarli.

Per informazioni sull'elenco delle viste Analytics nel tuo progettoGoogle Cloud , vedi Elenca le viste Analytics.

Posizione delle viste Analytics

La posizione di una vista di analisi è determinata dalla posizione delle risorse su cui esegue query. Ad esempio, se una vista di analisi esegue query su una vista di osservabilità che si trova nella località global, anche la località della vista di analisi deve essere global. Quando utilizzi la console Google Cloud per creare una vista di analisi, la località viene impostata automaticamente.

Esempi di casi d'uso

I seguenti esempi illustrano come utilizzare le visualizzazioni Analytics per semplificare e riutilizzare le query.

Estrai il nome del servizio di tracciamento

Supponiamo che tu voglia scrivere query che analizzino i dati di traccia e che tu voglia visualizzare o raggruppare in base a un nome di servizio sintetizzato. La query per la vista di analisi determina il nome del servizio per uno span utilizzando la funzione COALESCE, che valuta un elenco di espressioni in ordine e restituisce il valore della prima espressione che non restituisce NULL:

SELECT
  start_time,
  -- Set the value of service name based on the first non-null value in the list.
  COALESCE(
    JSON_VALUE(resource.attributes, '$."service.name"'),
    JSON_VALUE(attributes, '$."service.name"'),
    JSON_VALUE(attributes, '$."g.co/gae/app/module"')) AS service_name,
  name AS span_name,
  duration_nano,
  status.code AS status,
  trace_id,
  span_id
FROM
  `PROJECT_ID.us._Trace.Spans._AllSpans`
LIMIT 10

Prima di utilizzare la query, sostituisci PROJECT_ID con l'ID del tuo progettoGoogle Cloud .

Limitazioni

Alle visualizzazioni di Analytics si applicano le seguenti limitazioni:

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

Passaggi successivi