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, che ti permette di semplificare le query o ridurre il tempo che dedichi alla scrittura delle query. 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, eseguire una query su una vista di analisi equivale a eseguire 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 log 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.
Query per i dettagli di rete
Vuoi analizzare le prestazioni di rete utilizzando i log di flusso VPC. Devi
analizzare le prestazioni complessive della rete e identificare
reti, indirizzi IP e host specifici. Queste informazioni sono memorizzate all'interno di
campi nidificati nel campo json_payload di una voce di log.
Per semplificare le query di analisi, crea la seguente vista di analisi
e chiamala network_details:
SELECT
-- Create a column for each network field.
JSON_VALUE(resource.labels.subnetwork_name) subnetwork_name,
JSON_VALUE(json_payload.src_instance.vm_name) vm_name,
JSON_VALUE(json_payload.connection.src_ip) as src_ip,
JSON_VALUE(json_payload.connection.src_port) as src_port,
JSON_VALUE(json_payload.connection.dest_ip) as dest_ip,
JSON_VALUE(json_payload.connection.dest_port) as dest_port,
CAST(JSON_VALUE(json_payload.bytes_sent) as INT64) as bytes_sent,
CAST(JSON_VALUE(json_payload.packets_sent) as INT64) as packets_sent
FROM
-- Query one log view.
`PROJECT_ID.LOCATION.BUCKET_ID.LOG_VIEW_ID`
WHERE
-- Only query the VPC Flow Logs log.
log_id = "compute.googleapis.com/vpc_flows"
AND SEARCH(json_payload.reporter, "SRC")
Prima di utilizzare la query, imposta i valori delle seguenti variabili:
- PROJECT_ID: l'identificatore del progetto.
- LOCATION: la posizione della visualizzazione dei log.
- BUCKET_ID: il nome o l'ID del bucket di log.
- LOG_VIEW_ID: l'identificatore della visualizzazione dei log, che è limitato a 100 caratteri e può includere solo lettere, cifre, trattini bassi e trattini.
Quando vuoi analizzare il rendimento della rete, esegui una query sulla tua vista di analisi. Ad esempio, se ti interessa solo il nome dell'istanza e la quantità di dati inviati, puoi scrivere la seguente query:
SELECT vm_name, bytes_sent, packets_sent,
FROM `analytics_view.my_project.global.network_details`
ORDER BY bytes_sent DESC
LIMIT 100
Query di base per l'analisi della latenza dell'API
Diversi team hanno bisogno di dati sul rendimento settimanale per completare l'analisi. Invece di generare i dati settimanali per ogni team, crea una vista di analisi che estrae i dati settimanali. Altri team possono eseguire query sulla vista di analisi e poi eseguire la propria analisi.
La seguente query mostra come utilizzare SQL per calcolare la latenza minima, massima e media delle richieste:
SELECT week, MIN(took_ms) as min, MAX(took_ms) AS max, AVG(took_ms) AS avg
FROM (
SELECT TIMESTAMP_TRUNC(timestamp, WEEK) AS week,
CAST( JSON_VALUE(json_payload, '$."http.resp.took_ms"') AS INT64) as took_ms
FROM
-- Query one log view.
`PROJECT_ID.LOCATION.BUCKET_ID.LOG_VIEW_ID`
WHERE json_payload IS NOT NULL
AND SEARCH(labels,"frontend")
AND JSON_VALUE(json_payload.message) = "request complete"
ORDER BY took_ms DESC, timestamp ASC
)
GROUP BY week ORDER BY week
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 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
- Creare, interrogare e gestire le visualizzazioni di Analytics
- Panoramica delle query e dell'analisi dei log
- Salvare e condividere una query SQL