Il monitoraggio in Spanner Omni funziona in modo simile al monitoraggio in Spanner, con alcune eccezioni. Questo documento fornisce spiegazioni di queste eccezioni e rimanda alle informazioni correlate nella documentazione di monitoraggio di Spanner. Mentre leggi la documentazione di Spanner, consulta questa pagina per verificare le differenze di Spanner Omni.
Funzionalità di Spanner non supportate
Spanner Omni supporta tutte le funzionalità di monitoraggio di Spanner, ad eccezione del tracciamento end-to-end.
Acquisisci indicatori di telemetria
Per ottenere insight su prestazioni, utilizzo e potenziali problemi, puoi acquisire indicatori dal tuo database Spanner Omni.
Panoramica dell'acquisizione degli indicatori
I segnali di telemetria ti aiutano a capire il rendimento del tuo database.
Per Spanner Omni sono disponibili i seguenti indicatori:
| Tipo di indicatore | Descrizione |
|---|---|
| Metriche | Dati numerici sull'integrità o sulle prestazioni del database. |
| Log | Record generati dell'attività del sistema nel tempo. |
| Tracce | Percorsi delle richieste attraverso l'applicazione. |
| Tabelle delle statistiche | Tabelle integrate per l'esecuzione di query sulle informazioni del database. |
In Spanner Omni, le metriche lato client non sono supportate. Le metriche lato client includono le latenze per le metriche GFE, la raccolta di metriche lato client e la raccolta di metriche lato client personalizzate. Per saperne di più, consulta la panoramica dell'acquisizione degli indicatori nella documentazione di Spanner.
Raccolta di Trace
Le tracce rappresentano il percorso di una richiesta attraverso l'applicazione. Ti consentono di seguire il flusso di una richiesta e ti aiutano a identificare la causa principale di un problema. Ad esempio, il tracciamento può fornire informazioni per ogni richiesta di un client, come gli intervalli con i timestamp di quando il client ha inviato e ricevuto le richieste RPC. In questo modo puoi monitorare ed eseguire il debug delle richieste al database.
Per saperne di più, consulta la panoramica della raccolta di tracce nella documentazione di Spanner.
Configura la raccolta delle tracce utilizzando OpenTelemetry
Puoi configurare le librerie client di Spanner per esportare le tracce utilizzando le API OpenTelemetry. Questo processo prevede la configurazione dell'SDK OpenTelemetry e l'utilizzo di un esportatore per inviare i dati di traccia a un backend di osservabilità.
Il tracciamento lato client non è disponibile per Spanner Omni.
Per saperne di più, consulta Configura la raccolta delle tracce utilizzando OpenTelemetry nella documentazione di Spanner.
Esporta le tracce del server in un raccoglitore
I server Spanner Omni possono esportare le proprie tracce in formato OTLP in un raccoglitore di tracce, come Jaeger. Per impostare il raccoglitore, esegui una delle seguenti operazioni:
Sulle VM, imposta la variabile di ambiente
SPANNER_TRACE_EXPORTER_ENDPOINTprima di avviare i server. Per saperne di più, consulta Raccogli e analizza le tracce.Su Kubernetes, imposta il valore Helm
deployment.traceExporterEndpoint:helm upgrade spanner-omni oci://us-docker.pkg.dev/spanner-omni/charts/spanner-omni \ --version 2.0.0 \ --namespace NAMESPACE \ --reuse-values \ --set deployment.traceExporterEndpoint=dns:///COLLECTOR_HOST:COLLECTOR_PORTSe installi il chart Helm con
monitoring.enabled=truee non impostideployment.traceExporterEndpoint, i server esportano le tracce nel raccoglitore Jaeger installato dal chart Helm, all'indirizzodns:///jaeger.monitoring.svc.cluster.local:4317.
I server esportano le tracce in un endpoint socket di dominio Unix (una destinazione che inizia con unix: o unix-abstract:) senza TLS, perché le tracce non lasciano l'host. I server trattano ogni altro raccoglitore come remoto, incluso un raccoglitore su localhost, un indirizzo IP di loopback, un altro pod o servizio o l'indirizzo IP del nodo Kubernetes (ad esempio, $HOST_IP:4317 per un raccoglitore DaemonSet).
Esporta le tracce su TLS
A partire dalla versione 2026.r4-lts.3 di Spanner Omni, i server in un deployment con crittografia TLS esportano le tracce in un raccoglitore remoto solo tramite TLS. Le versioni precedenti esportano le tracce in testo non crittografato verso i raccoglitori remoti e non supportano l'esportazione delle tracce TLS. Per esportare le tracce in un raccoglitore remoto, segui questi passaggi:
Crea la CA del raccoglitore di tracce (
ca-otlp.crt) e un certificato del raccoglitore per il nome host del raccoglitore nell'endpoint dell'esportatore di tracce:- Sulle VM, consulta Crea autorità di certificazione e Crea il certificato del raccoglitore di tracce.
- Su Kubernetes, consulta Crea autorità di certificazione e Crea il certificato del raccoglitore di tracce.
Abilita TLS sul ricevitore gRPC OTLP del raccoglitore con il certificato del raccoglitore. I seguenti esempi utilizzano i file
collector.crtecollector.keynella directoryotlp-certs. Esegui i comandi dalla directory in cui hai creato i certificati o sostituisciotlp-certscon il percorso completo di quella directory.Per Jaeger v1 (
jaeger-all-in-one) su una VM:export COLLECTOR_OTLP_ENABLED=true export COLLECTOR_OTLP_GRPC_TLS_ENABLED=true export COLLECTOR_OTLP_GRPC_TLS_CERT=otlp-certs/collector.crt export COLLECTOR_OTLP_GRPC_TLS_KEY=otlp-certs/collector.key jaeger-all-in-oneJaeger v2 configura invece TLS nel proprio file di configurazione. Per saperne di più, consulta la documentazione sulla sicurezza di Jaeger.
Per il raccoglitore Jaeger installato dal chart Helm con
monitoring.enabled=true, crea un secret TLS denominatojaeger-tlsnello spazio dei nomimonitoring:kubectl create secret tls jaeger-tls -n monitoring \ --cert=otlp-certs/collector.crt --key=otlp-certs/collector.keyA partire dalla versione 2.0.0 del chart Helm, il raccoglitore Jaeger gestisce TLS per impostazione predefinita nei deployment con crittografia TLS, utilizzando il secret
jaeger-tls. In questi deployment,helm installehelm upgradenon vanno a buon fine se il secret non esiste, a meno che non impostideployment.traceExporterEndpointsul tuo raccoglitore. Per utilizzare un secret con un nome diverso, impostamonitoring.jaeger.tls.secretName. Jaeger ricarica il certificato ognimonitoring.jaeger.tls.reloadInterval(valore predefinito:1h), in modo da poter ruotare il certificato senza riavviare.La versione 2.0.0 del chart Helm richiede la release
2026.r4-lts.3o successiva di Spanner Omni. Con le versioni precedenti, utilizza la versione 1.x del chart Helm.
Distribuisci
ca-otlp.crtai server insieme agli altri certificati:- Sulle VM, copialo nella directory dei certificati di ogni server. Per saperne di più, consulta Distribuisci i certificati a tutti i server.
Su Kubernetes, aggiungilo al secret
tls-certs. Per saperne di più, consulta Invia i certificati, il set di chiavi wrapper e la password amministratore al cluster Kubernetes. Per aggiungerla a un secrettls-certsesistente senza modificare le altre chiavi, esegui questo comando:kubectl patch secret tls-certs -n NAMESPACE --type=merge \ -p "{\"data\":{\"ca-otlp.crt\":\"$(base64 -w 0 certs/ca-otlp.crt)\"}}"
Avvia o riavvia i server. I server decidono se utilizzare TLS all'avvio, in base alla presenza o meno di
ca-otlp.crt, pertanto l'aggiunta o la rimozione del file ha effetto solo dopo un riavvio. Le modifiche a un file esistente, come la rotazione di un certificato, diventano effettive senza riavvio.Su Kubernetes, l'aggiunta di una chiave al secret
tls-certsnon riavvia i server. Per riavviarli, esegui questo comando:kubectl rollout restart statefulset -n NAMESPACE \ -l app.kubernetes.io/instance=spanner-omni
I server verificano che il certificato del raccoglitore sia emesso da ca-otlp.crt e corrisponda al nome host nell'endpoint dell'esportatore di tracce. I server non presentano un certificato client, quindi non configurare il raccoglitore in modo che richieda certificati client. Se ca-otlp.crt esiste, i server utilizzano TLS anche per i raccoglitori remoti nei deployment senza crittografia TLS.
Monitora le tracce ignorate
In un deployment con crittografia TLS, se ca-otlp.crt non esiste, i server non esportano le tracce in un raccoglitore remoto. I server registrano un avviso di limitazione di frequenza che spiega come correggere la configurazione e conteggiano le tracce ignorate nella metrica Prometheus opentelemetry_dropped_spans, con l'etichetta reason impostata su secure_mode.
Prima di creare il deployment, i server non possono determinare se il deployment utilizza la crittografia TLS. Fino ad allora, se ca-otlp.crt non esiste, i server non esportano le tracce in un raccoglitore remoto e le conteggiano con l'etichetta reason impostata su deployment_state_unavailable.
Se ca-otlp.crt non è un certificato CA valido o se il certificato del raccoglitore non è emesso da ca-otlp.crt o non corrisponde al nome host nell'endpoint dell'esportatore di tracce, le connessioni al raccoglitore non vanno a buon fine finché non correggi la configurazione. La metrica opentelemetry_dropped_spans non conteggia questi errori. Per rilevarli, controlla i log del server per verificare la presenza di errori di TLS handshake e di esportazione delle tracce. I server registrano anche un avviso all'avvio se ca-otlp.crt non contiene un certificato PEM.
Audit log
Gli audit log monitorano le modifiche amministrative e gli eventi di accesso ai dati per la sicurezza e la conformità. Puoi utilizzare gli audit log per monitorare le latenze delle richieste facendo riferimento ai campi relativi alla durata dell'elaborazione. Per saperne di più, consulta Audit log.
Monitoraggio delle istanze
Monitora le istanze per assicurarti che funzionino come previsto e per aiutarti a risolvere potenziali problemi.
Monitora le prestazioni dell'istanza utilizzando gli insight
La dashboard degli insight di sistema fornisce grafici e metriche per latenza, utilizzo della CPU, spazio di archiviazione, throughput e altre statistiche sul rendimento. Puoi utilizzare questa dashboard per monitorare le istanze e i database Spanner Omni. Per saperne di più, consulta Monitora le istanze con insight di sistema nella documentazione di Spanner.