Utilizzare la console Omni di Spanner

Spanner Omni include la console Spanner Omni che mostra lo stato e altre informazioni importanti sui tuoi deployment.

Avvia la console Spanner Omni

Scarica la console Spanner Omni per eseguire una singola istanza per l'intero deployment. Per saperne di più, consulta Scarica Spanner Omni.

Utilizza la console Spanner Omni con i deployment su un singolo server

Per avviare la console Spanner Omni con un deployment su un singolo server:

  1. Segui i passaggi descritti in Configura Spanner Omni.

  2. Esegui il comando start-single-server per avviare il server Spanner.

  3. Avvia la console Spanner Omni. Se utilizzi i container, esegui il seguente comando:

    docker exec -it spanneromni /google/spanner/bin/omni-jre/bin/java -jar /google/spanner/bin/spanner-console

    La console Spanner Omni utilizza gli stessi flag della CLI Spanner Omni.

    • Per l'esecuzione con TLS, utilizza:

      docker exec -it spanneromni /google/spanner/bin/omni-jre/bin/java -jar \
    /google/spanner/bin/spanner-console \
    --ca-certificate-file=PATH_TO_CA_FILE

    • Per l'esecuzione con mTLS, utilizza:

      docker exec -it spanneromni /google/spanner/bin/omni-jre/bin/java -jar \
    /google/spanner/bin/spanner-console \
    --ca-certificate-file=PATH_TO_CA_FILE \
    --client-certificate-directory=PATH_TO_CLIENT_CERT_DIR

    Sostituisci quanto segue:

    • PATH_TO_CA_FILE: il percorso del file del certificato dell'autorità di certificazione (CA).
    • PATH_TO_CLIENT_CERT_DIR: il percorso della directory del certificato client.

  4. Nel browser, vai a http://localhost:15026 per accedere alla console Spanner Omni.

Utilizza la console Spanner Omni con deployment a livello di zona, regione e multi-cluster

Per i deployment basati su Kubernetes, il deployment della console Spanner Omni viene eseguito quando crei un deployment. Per accedere alla console Spanner Omni, nel browser, vai a http://HOST_ADDRESS:15026.

Sostituisci HOST_ADDRESS con EXTERNAL_IP per spanner-omni-console nell'output del seguente comando:

kubectl get svc -n spanner-ns

Funzionalità della console Spanner Omni

La console Spanner Omni include diverse pagine che forniscono insight sul deployment.

Panoramica

La pagina Panoramica è la dashboard centrale per il deployment di Spanner Omni. Fornisce le seguenti informazioni di alto livello sull'integrità, lo stato e l'utilizzo delle risorse dei nodi Spanner:

Informazioni del deployment

Questa sezione elenca i dettagli del deployment:

  • ID deployment: un identificatore univoco per il deployment attuale di Spanner Omni. Questo ID viene specificato durante la creazione del deployment.

  • Versione del database: la versione specifica del software Spanner Omni in esecuzione (ad esempio 2026.r4-lts.1).

  • Versione: la versione della licenza Spanner Omni installata nel deployment.

  • Tipo di licenza: il tipo di licenza installata nel deployment. Per saperne di più sulle versioni e sui tipi di licenza di Spanner Omni, consulta la panoramica delle versioni di Spanner Omni.

  • Scadenza della licenza: la data di scadenza della licenza del deployment.

Configurazione del deployment

  • Utilizzo della CPU: un grafico in tempo reale che mostra il carico di elaborazione nel tuo deployment. Puoi passare da Zona a Server per visualizzare l'utilizzo.

  • Tabella delle risorse: fornisce una visualizzazione dettagliata dei componenti del tuo deployment con le seguenti informazioni. I server sono raggruppati per zona.

    Colonna Descrizione
    Nome della risorsa Il nome della zona o del nodo server Spanner Omni specifico.
    Tipo
    • Zona: mostra il tipo di zona (ad esempio, lettura/scrittura, sola lettura o witness).
    • Server Spanner Omni: singoli nodi che eseguono il servizio Spanner Omni. La console Spanner Omni identifica in modo specifico i server root.
    Stato Indica se la risorsa è in stato integro (ad esempio Ready).
    Località La regione fisica o logica che ospita la zona (ad esempio us-central1).
    vCPU, memoria, spazio di archiviazione utilizzato L'allocazione e l'utilizzo attuali delle risorse per ogni nodo e zona.

Database

La pagina Database fornisce una visualizzazione centralizzata di tutti i database nel tuo deployment di Spanner Omni. La tabella in questa pagina include le seguenti informazioni:

Colonna Descrizione
Nome database L'identificatore univoco del tuo database (ad esempio retail, ycsbdb).
Dialetto Il dialetto SQL supportato dal database:
  • GOOGLE_STANDARD_SQL: il dialetto predefinito, che offre il supporto completo delle funzionalità di Spanner.
  • POSTGRESQL: un'interfaccia compatibile con PostgreSQL.
Utilizzo CPU La percentuale di risorse della CPU consumate dal database. In questo modo puoi identificare i database con un carico elevato.
Tabelle Il numero totale di tabelle definite dall'utente nel database.
Periodo di conservazione delle versioni La durata per cui Spanner Omni conserva i dati storici per il recupero point-in-time (ad esempio, 1h).

Backup

La pagina Backup offre una visualizzazione completa di tutti i backup associati al tuo deployment di Spanner Omni. I backup sono snapshot del database coerenti dal punto di vista transazionale e con coerenza esterna che Spanner Omni archivia in soluzioni di archiviazione esterne.

Per saperne di più, consulta Backup di Spanner Omni.

Spazio di archiviazione di backup totale

La sezione Spazio di archiviazione di backup totale mostra le dimensioni cumulative di tutti i backup archiviati nello spazio di archiviazione esterno (ad esempio Amazon Simple Storage Service (Amazon S3), Cloud Storage o spazio di archiviazione locale compatibile con Amazon S3).

Tabella dei backup

La tabella dei backup mostra le seguenti informazioni per ogni backup:

Colonna Descrizione
Nome backup L'identificatore univoco del backup.
Database di origine Il nome del database da cui la console Spanner Omni ha creato il backup.
Stato Lo stato attuale del backup. Gli stati comuni includono:
  • Pronto: il backup è completo e disponibile per il ripristino.
  • Creazione: il backup è in corso.
  • In scadenza: il backup è vicino alla data di scadenza specificata dall'utente.
Dimensione backup Le dimensioni dei dati di backup nello spazio di archiviazione.
Data/ora creazione Il timestamp di quando il server Spanner Omni ha avviato il processo di backup.
Data/ora snapshot (o Data/ora versione) Il momento nel tempo rappresentato dal backup. Tutti i dati nel backup sono uno snapshot coerente del database in questo momento.
Scadenza La data e l'ora in cui Spanner Omni elimina il backup.

Insight sul sistema

La pagina Insight di sistema offre un'osservabilità granulare per il tuo deployment di Spanner Omni, che ti consente di monitorare l'integrità del sistema, analizzare le prestazioni ed eseguire il debug dei problemi.

Puoi personalizzare i dati visualizzati nella dashboard con i seguenti filtri:

  • Zone: filtra le metriche per zone di deployment specifiche.

  • Server: visualizza in dettaglio i singoli nodi del server.

  • Database: visualizza le metriche per un database specifico o per l'intero deployment.

  • Intervallo di tempo: seleziona una finestra temporale da 1 ora a 7 giorni.

Utilizzo CPU

Questa sezione monitora il carico di elaborazione nel deployment. Puoi raggruppare questa metrica per:

  • Zona: identifica gli squilibri di carico tra le località fisiche.

  • Priorità: scopri come vengono suddivise le risorse tra attività con priorità alta, media e bassa.

  • Tipo di operazione: suddivide l'utilizzo in base alle attività avviate dall'utente, come letture, scritture e commit.

Latenza

Questa sezione monitora la velocità delle tue operazioni:

  • Latenza delle richieste: il tempo impiegato per le singole richieste API.

  • Latenza transazione: il tempo totale per le transazioni complete del database.

  • Percentili: ad esempio, visualizza questo valore al 50° percentile (P50) per il rendimento mediano. Tuttavia, la risoluzione dei problemi spesso richiede il controllo di P90 o P99.

Velocità effettiva e operazioni

Questa sezione mostra le seguenti informazioni:

  • Throughput: il volume di dati che il sistema legge o scrive nel deployment (misurato in byte al secondo).

  • Operazioni al secondo: il numero totale di chiamate API elaborate dal sistema.

Tempo per attesa di blocco

Questa metrica misura il tempo cumulativo che le transazioni trascorrono in attesa dei blocchi. I picchi di questa metrica, soprattutto se associati a una latenza elevata e a un utilizzo normale della CPU, spesso indicano una contesa di blocco.

Metriche di archiviazione

  • Capacità di archiviazione: lo spazio di archiviazione totale e disponibile sul file system sottostante, che la console Spanner Omni raggruppa per zona.

  • Utilizzo dello spazio di archiviazione: il numero di byte utilizzati dai database. Il processo di compattazione dei dati di Spanner Omni potrebbe causare fluttuazioni temporanee di questi numeri.

Prestazioni del file system

Questa sezione fornisce insight sulle prestazioni del livello di archiviazione sottostante (SpanhostFS):

  • Latenza del file system: il tempo impiegato per le operazioni di I/O di basso livello (lettura, scrittura e flush).

  • Velocità effettiva del file system: la velocità di trasferimento dei dati a livello di file system.

Query Insights

La pagina Query Insights ti aiuta a rilevare e diagnosticare i problemi di prestazioni delle query SQL e delle istruzioni DML (INSERT, UPDATE e DELETE). Utilizza Query Insights per identificare le query inefficienti che potrebbero contribuire a un utilizzo elevato della CPU.

  • Rilevamento: determina se le query sono la causa principale del carico della CPU del deployment.

  • Identificazione: individua le query o i tag di richiesta dell'applicazione specifici che richiedono più risorse.

  • Analisi: utilizza metriche granulari come la latenza e il numero di righe per capire perché una query potrebbe essere lenta.

Carico database per tempo di esecuzione (tutte le query)

Carico database per tempo di esecuzione mostra l'utilizzo aggregato della CPU per tutte le query nel tempo. Per visualizzare il carico di un database specifico, utilizza un filtro per database.

N principali query e tag

Questa sezione fornisce una visualizzazione delle serie temporali delle query o dei tag che generano il carico del database più elevato nel periodo di tempo selezionato.

Tabella delle query e dei tag principali

La tabella elenca le query e i tag con il consumo più elevato. Puoi utilizzarlo per identificare le query che richiedono più risorse nel tuo workload di query.

Colonna Descrizione
Impronta Un identificatore univoco per una specifica "forma" di query.
Tag di query o richiesta Il testo SQL normalizzato della query. Se la tua applicazione fornisce un tag di richiesta nelle opzioni di query, la console Spanner Omni visualizza invece quel tag, consentendoti di raggruppare le query correlate (ad esempio, checkout_process).
Tipo di query Il tipo di operazione (ad esempio QUERY).
CPU (%) La percentuale delle risorse CPU totali del database utilizzate da questa query durante l'intervallo.
Conteggio esecuzioni Il numero totale di volte in cui la console Spanner Omni ha eseguito la query.
Latenza media (ms) Il tempo medio impiegato per completare la query, incluso il tempo di rete tra i server.
Media righe scansionate Il numero medio di righe lette da Spanner Omni per elaborare la query. Rapporti elevati tra elementi scansionati e restituiti spesso indicano indici mancanti o inefficienti.
Numero medio di righe restituite Il numero medio di righe che la console Spanner Omni invia alla tua applicazione.
Byte restituiti La quantità media di dati restituita dalla console Spanner Omni per esecuzione.