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 la pagina Download di Spanner Omni.

Utilizzare la console Spanner Omni con deployment a server singolo

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

  1. Segui i passaggi descritti in Configurare 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 di Spanner Omni CLI.

    • 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 dei certificati client.

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

Utilizzare la console Spanner Omni con deployment zonali, regionali e multi-cluster

Per i deployment basati su Kubernetes, la console Spanner Omni viene eseguita il deployment 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 che si trova 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 approfondimenti sul tuo deployment.

Panoramica

La pagina Panoramica è la dashboard centrale per la tua implementazione di Spanner Omni. Fornisce le seguenti informazioni di alto livello su integrità, stato e utilizzo delle risorse dei tuoi nodi Spanner:

Informazioni del deployment

Questa sezione elenca i dettagli del deployment:

  • ID deployment: un identificatore univoco per il tuo attuale deployment Spanner Omni. Specifichi questo ID quando crei il deployment.

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

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

  • Tipo di licenza: il tipo di licenza installata nel deployment. Per ulteriori informazioni sulle versioni e sui tipi di licenza di Spanner Omni, consulta Panoramica delle versioni di Spanner Omni.

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

Configurazione del deployment

  • Utilizzo CPU: un grafico in tempo reale che mostra il carico di elaborazione nel deployment. Puoi alternare Zona e Server per visualizzare l'utilizzo.

  • Tabella delle risorse: fornisce una visualizzazione dettagliata dei componenti della tua implementazione con le seguenti informazioni. I server sono raggruppati per zona.

    Colonna Descrizione
    Nome della risorsa Il nome della zona o del nodo del server Spanner Omni specifico.
    Tipo
    • Zona: mostra il tipo di zona (ad esempio lettura/scrittura, sola lettura o testimone).
    • Server Spanner Omni: singoli nodi che eseguono il servizio Spanner Omni. La console Spanner Omni identifica in modo specifico i server radice.
    Stato Indica se la risorsa è integra (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 delle risorse attuali per ogni nodo e zona.

Database

La pagina Database offre 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 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 carico elevato.
Tables Il numero totale di tabelle definite dall'utente nel database.
Periodo di conservazione delle versioni La durata per la quale Spanner Omni conserva i dati storici per il recupero point-in-time (ad esempio, 1h).

Backup

La pagina Backup fornisce una visione completa di tutti i backup associati al tuo deployment di Spanner Omni. I backup sono snapshot coerenti dal punto di vista transazionale ed esterno del tuo database che Spanner Omni archivia in soluzioni di archiviazione esterne.

Per saperne di più, consulta la pagina relativa ai backup di Spanner Omni.

Spazio di archiviazione di backup totale

La sezione Spazio di archiviazione totale per i backup mostra le dimensioni cumulative di tutti i backup che memorizzi 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 in corso: il backup è in corso.
  • Scade a breve: 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 in cui il server Spanner Omni ha avviato la procedura di backup.
Tempo snapshot (o Tempo versione) Il momento nel tempo che rappresenta il 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 System Insights fornisce un'osservabilità granulare per la tua implementazione 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 posizioni fisiche.

  • Priorità: scopri come vengono suddivise le risorse tra le attività a 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 tiene traccia della velocità delle tue operazioni:

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

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

  • 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 nella deployment (misurato in byte al secondo).

  • Operazioni al secondo: il conteggio totale delle chiamate API elaborate dal sistema.

Tempo per attesa di blocco

Questa metrica misura il tempo cumulativo che le transazioni trascorrono in attesa di blocchi. I picchi in questa metrica, soprattutto se abbinati a una latenza elevata e a un utilizzo normale della CPU, spesso indicano 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 tuoi database. Il processo di compattazione dei dati Spanner Omni potrebbe causare fluttuazioni temporanee in questi numeri.

Prestazioni del file system

Questa sezione fornisce informazioni sul rendimento 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 svuotamento).

  • Throughput 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 per le tue query SQL e le 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 tue query sono la causa principale del carico della CPU del tuo deployment.

  • Identificazione: individua le query o i tag di richiesta dell'applicazione specifici che richiedono il maggior numero di risorse.

  • Analisi: utilizza metriche granulari come la latenza e i conteggi delle 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 del database.

N principali query e tag

Questa sezione fornisce una visualizzazione delle serie temporali delle query o dei tag che causano 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 che consumano più risorse. Puoi utilizzare questo strumento per identificare le query che richiedono più risorse nel tuo carico di lavoro delle query.

Colonna Descrizione
Impronta Un identificatore univoco per una "forma" di query specifica.
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 mostra 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 consumate 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 scansione-restituzione elevati 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.