Panoramica del monitoraggio

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_ENDPOINT prima 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_PORT
    

    Se installi il chart Helm con monitoring.enabled=true e non imposti deployment.traceExporterEndpoint, i server esportano le tracce nel raccoglitore Jaeger installato dal chart Helm, all'indirizzo dns:///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:

  1. 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:

  2. Abilita TLS sul ricevitore gRPC OTLP del raccoglitore con il certificato del raccoglitore. I seguenti esempi utilizzano i file collector.crt e collector.key nella directory otlp-certs. Esegui i comandi dalla directory in cui hai creato i certificati o sostituisci otlp-certs con 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-one
      

      Jaeger 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 denominato jaeger-tls nello spazio dei nomi monitoring:

      kubectl create secret tls jaeger-tls -n monitoring \
          --cert=otlp-certs/collector.crt --key=otlp-certs/collector.key
      

      A 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 install e helm upgrade non vanno a buon fine se il secret non esiste, a meno che non imposti deployment.traceExporterEndpoint sul tuo raccoglitore. Per utilizzare un secret con un nome diverso, imposta monitoring.jaeger.tls.secretName. Jaeger ricarica il certificato ogni monitoring.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.3 o successiva di Spanner Omni. Con le versioni precedenti, utilizza la versione 1.x del chart Helm.

  3. Distribuisci ca-otlp.crt ai server insieme agli altri certificati:

  4. 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-certs non 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.

Passaggi successivi