Visão geral do Monitoring

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

    Se você instalar o gráfico Helm com monitoring.enabled=true e não definir deployment.traceExporterEndpoint, os servidores vão exportar traces para o coletor do Jaeger que o gráfico Helm instala, em dns:///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:

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

  2. Ative o TLS no receptor gRPC OTLP do coletor com o certificado do coletor. Os exemplos a seguir usam os arquivos collector.crt e collector.key no diretório otlp-certs. Execute os comandos no diretório em que você criou os certificados ou substitua otlp-certs pelo 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-one
      

      O 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 chamado jaeger-tls no namespace monitoring:

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

      A 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 install e helm upgrade falharão se o secret não existir, a menos que você defina deployment.traceExporterEndpoint para seu próprio coletor. Para usar um secret com um nome diferente, defina monitoring.jaeger.tls.secretName. O Jaeger recarrega o certificado a cada monitoring.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.3 ou mais recente do Spanner Omni. Com versões anteriores, use a versão 1.x do gráfico Helm.

  3. Distribua ca-otlp.crt para os servidores junto com os outros certificados:

  4. 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-certs nã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.

A seguir