O monitoramento no Spanner Omni funciona de maneira semelhante ao monitoramento no Spanner, com algumas exceções. Este documento explica essas exceções e indica informações relacionadas na documentação de monitoramento do Spanner. Ao ler a documentação do Spanner, consulte esta página para confirmar as diferenças do Spanner Omni.
Recursos do Spanner que não são compatíveis
O Spanner Omni é compatível com todos os recursos de monitoramento do Spanner, exceto o rastreamento de ponta a ponta.
Capturar indicadores de telemetria
Para receber insights sobre desempenho, uso e possíveis problemas, capture sinais do banco de dados do Spanner Omni.
Visão geral da captura de indicadores
Os indicadores de telemetria ajudam a entender o desempenho do banco de dados.
Os seguintes indicadores estão disponíveis para o Spanner Omni:
| Tipo de indicador | Descrição |
|---|---|
| Métricas | Dados numéricos sobre a integridade ou o desempenho do banco de dados. |
| Registros | Registros gerados da atividade do sistema ao longo do tempo. |
| Traces | Caminhos de solicitação pelo aplicativo. |
| Tabelas de estatísticas | Tabelas integradas para consultar informações do banco de dados. |
No Spanner Omni, as métricas do lado do cliente não são compatíveis. As métricas do lado do cliente incluem latências para métricas do GFE, coleta de métricas do lado do cliente e coleta de métricas personalizadas do lado do cliente. Para mais informações, consulte Visão geral da captura de indicadores na documentação do Spanner.
Coleta de traces
Os traces representam o caminho de uma solicitação pelo aplicativo. Eles permitem que você siga o fluxo de uma solicitação e ajudam a identificar a causa raiz de um problema. Por exemplo, o rastreamento pode fornecer informações para cada solicitação de um cliente, como períodos com carimbos de data/hora de quando o cliente enviou e recebeu solicitações RPC. Isso ajuda a monitorar e depurar solicitações de banco de dados.
Para mais informações, consulte Visão geral da coleta de traces na documentação do Spanner.
Configurar a coleta de traces usando o OpenTelemetry
É possível configurar as bibliotecas de cliente do Spanner para exportar traces usando as APIs do OpenTelemetry. Esse processo envolve configurar o SDK do OpenTelemetry e usar um exportador para enviar dados de trace para um back-end de observabilidade.
O rastreamento do lado do cliente não está disponível para o Spanner Omni.
Para mais informações, consulte Configurar a coleta de traces usando o OpenTelemetry na documentação do Spanner.
Exportar traces do servidor para um coletor
Os servidores do Spanner Omni podem exportar os próprios traces no formato OTLP para um coletor de traces, como o Jaeger. Para definir o coletor, siga um destes procedimentos:
Em VMs, defina a variável de ambiente
SPANNER_TRACE_EXPORTER_ENDPOINTantes de iniciar os servidores. Para mais informações, consulte Coletar e analisar traces.No Kubernetes, defina o valor do 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 você instalar o gráfico Helm com
monitoring.enabled=truee não definirdeployment.traceExporterEndpoint, os servidores vão exportar traces para o coletor do Jaeger que o gráfico Helm instala, emdns:///jaeger.monitoring.svc.cluster.local:4317.
Os servidores exportam traces para um endpoint de soquete de domínio Unix (um destino que começa
com unix: ou unix-abstract:) sem TLS, porque os traces não saem
do host. Os servidores tratam todos os outros coletores como remotos, incluindo um coletor
em localhost, um endereço IP de loopback, outro pod ou serviço ou o
endereço IP do nó do Kubernetes (por exemplo, $HOST_IP:4317 para um coletor
DaemonSet).
Exportar traces por TLS
A partir da versão 2026.r4-lts.3 do Spanner Omni, os servidores em uma
implantação com criptografia TLS exportam traces para um coletor remoto apenas por
TLS. As versões anteriores exportam traces para coletores remotos em texto simples e não
são compatíveis com a exportação de traces TLS. Para exportar traces para um coletor remoto, faça o
seguinte:
Crie a CA do coletor de trace (
ca-otlp.crt) e um certificado de coletor para o nome do host do coletor no endpoint do exportador de trace:- Em VMs, consulte Criar autoridades certificadoras e Criar o certificado do coletor de trace.
- No Kubernetes, consulte Criar autoridades certificadoras e Criar o certificado do coletor de trace.
Ative o TLS no receptor gRPC OTLP do coletor com o certificado do coletor. Os exemplos a seguir usam os arquivos
collector.crtecollector.keyno diretóriootlp-certs. Execute os comandos no diretório em que você criou os certificados ou substituaotlp-certspelo caminho completo para esse diretório.Para o Jaeger v1 (
jaeger-all-in-one) em uma 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-oneO Jaeger v2 configura o TLS no arquivo de configuração. Para mais informações, consulte a documentação de segurança do Jaeger.
Para o coletor do Jaeger que o gráfico Helm instala com
monitoring.enabled=true, crie um secret de TLS chamadojaeger-tlsno namespacemonitoring:kubectl create secret tls jaeger-tls -n monitoring \ --cert=otlp-certs/collector.crt --key=otlp-certs/collector.keyA partir da versão 2.0.0 do gráfico Helm, o coletor Jaeger disponibiliza o TLS por padrão em implantações com criptografia TLS, usando o secret
jaeger-tls. Nessas implantações,helm installehelm upgradefalharão se o secret não existir, a menos que você definadeployment.traceExporterEndpointpara seu próprio coletor. Para usar um secret com um nome diferente, definamonitoring.jaeger.tls.secretName. O Jaeger recarrega o certificado a cadamonitoring.jaeger.tls.reloadInterval(padrão:1h) para que você possa fazer a rotação do certificado sem reiniciar.A versão 2.0.0 do gráfico Helm requer a versão
2026.r4-lts.3ou mais recente do Spanner Omni. Com versões anteriores, use a versão 1.x do gráfico Helm.
Distribua
ca-otlp.crtpara os servidores junto com os outros certificados:- Em VMs, copie-o para o diretório de certificados de cada servidor. Para mais informações, consulte Distribuir os certificados para todos os servidores.
No Kubernetes, adicione-o ao secret
tls-certs. Para mais informações, consulte Enviar os certificados, o conjunto de chaves de wrapper e a senha de administrador para o cluster do Kubernetes. Para adicioná-la a um secrettls-certssem alterar as outras chaves, execute o seguinte comando:kubectl patch secret tls-certs -n NAMESPACE --type=merge \ -p "{\"data\":{\"ca-otlp.crt\":\"$(base64 -w 0 certs/ca-otlp.crt)\"}}"
Inicie ou reinicie os servidores. Os servidores decidem se vão usar o TLS na inicialização, com base na existência de
ca-otlp.crt. Portanto, adicionar ou remover o arquivo só tem efeito após uma reinicialização. As alterações em um arquivo, como uma rotação de certificado, entram em vigor sem uma reinicialização.No Kubernetes, adicionar uma chave ao secret
tls-certsnão reinicia os servidores. Para reiniciá-los, execute o seguinte comando:kubectl rollout restart statefulset -n NAMESPACE \ -l app.kubernetes.io/instance=spanner-omni
Os servidores verificam se o certificado do coletor é emitido por ca-otlp.crt e
corresponde ao nome do host no endpoint do exportador de trace. Os servidores não apresentam um
certificado do cliente. Portanto, não configure o coletor para exigir certificados
do cliente. Se ca-otlp.crt existir, os servidores também vão usar o TLS para coletores remotos em implantações sem criptografia TLS.
Monitorar traces descartados
Em uma implantação com criptografia TLS, se ca-otlp.crt não existir, os servidores
não exportarão traces para um coletor remoto. Os servidores registram um aviso de limitação de taxa
que explica como corrigir a configuração e contam os traces descartados na
métrica do Prometheus opentelemetry_dropped_spans, com o rótulo reason definido como
secure_mode.
Antes de criar a implantação, os servidores não podem determinar se ela usa criptografia TLS. Até lá, se ca-otlp.crt não existir,
os servidores não vão exportar traces para um coletor remoto e os contarão com o
rótulo reason definido como deployment_state_unavailable.
Se ca-otlp.crt não for um certificado de CA válido, ou se o certificado do coletor
não for emitido por ca-otlp.crt ou não corresponder ao nome do host no endpoint do exportador de
trace, as conexões com o coletor vão falhar até que você corrija a
configuração. A métrica opentelemetry_dropped_spans não conta essas
falhas. Para detectá-los, verifique os registros do servidor em busca de erros de handshake de TLS e exportação de trace. Os servidores também registram um aviso na inicialização se ca-otlp.crt não
contiver um certificado PEM.
Registros de auditoria
Os registros de auditoria rastreiam mudanças administrativas e eventos de acesso a dados para segurança e conformidade. É possível usar registros de auditoria para monitorar as latências de solicitação consultando os campos de duração do processamento. Para mais informações, consulte Registros de auditoria.
Monitorar instâncias
Monitore suas instâncias para garantir que elas estejam funcionando conforme o esperado e para ajudar você a resolver possíveis problemas.
Monitorar o desempenho da instância usando insights
O painel de insights do sistema fornece gráficos e métricas de latência, utilização de CPU, armazenamento, capacidade de processamento e outras estatísticas de desempenho. Use esse painel para monitorar instâncias e bancos de dados do Spanner Omni. Para mais informações, consulte Monitorar instâncias com insights do sistema na documentação do Spanner.