Usar o console do Spanner Omni

O Spanner Omni inclui o console do Spanner Omni, que mostra a integridade e outras informações importantes sobre suas implantações.

Iniciar o console do Spanner Omni

Baixe o console do Spanner Omni para executar uma única instância em toda a implantação. Para mais informações, consulte Baixar o Spanner Omni.

Usar o console do Spanner Omni com implantações de servidor único

Para iniciar o console do Spanner Omni com uma implantação de servidor único:

  1. Siga as etapas em Configurar o Spanner Omni.

  2. Execute o comando start-single-server para iniciar o servidor do Spanner.

  3. Inicie o console do Spanner Omni. Se você estiver usando contêineres, execute o seguinte comando:

    docker exec -it spanneromni /google/spanner/bin/omni-jre/bin/java -jar /google/spanner/bin/spanner-console

    O console do Spanner Omni usa as mesmas flags da CLI do Spanner Omni.

    • Para executar com TLS, use:

      docker exec -it spanneromni /google/spanner/bin/omni-jre/bin/java -jar \
    /google/spanner/bin/spanner-console \
    --ca-certificate-file=PATH_TO_CA_FILE

    • Para executar com mTLS, use:

      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

    Substitua:

    • PATH_TO_CA_FILE: o caminho para o arquivo de certificado da autoridade certificadora (CA).
    • PATH_TO_CLIENT_CERT_DIR: o caminho para o diretório de certificados do cliente.

  4. No navegador, acesse http://localhost:15026 para acessar o console do Spanner Omni.

Usar o console do Spanner Omni com implantações zonais, regionais e multicluster

Para implantações baseadas no Kubernetes, o console do Spanner Omni é implantado quando você cria uma implantação. Para acessar o console do Spanner Omni, no seu navegador, acesse http://HOST_ADDRESS:15026.

Substitua HOST_ADDRESS pelo EXTERNAL_IP de spanner-omni-console que está na saída do comando a seguir:

kubectl get svc -n spanner-ns

Recursos do console do Spanner Omni

O console do Spanner Omni inclui várias páginas que fornecem insights sobre sua implantação.

Visão geral

A página Visão geral é o painel central da implantação do Spanner Omni. Ele fornece as seguintes informações gerais sobre a integridade, o status e a utilização de recursos dos nós do Spanner:

Informações de implantação

Esta seção lista detalhes da sua implantação:

  • ID da implantação: um identificador exclusivo da sua implantação atual do Spanner Omni. Você especifica esse ID ao criar a implantação.

  • Versão do banco de dados: a versão específica do software Spanner Omni que você está executando (por exemplo, 2026.r4-lts).

  • Edição: a edição da licença do Spanner Omni instalada na implantação.

  • Tipo de licença: o tipo de licença instalada na implantação. Para mais informações sobre as edições e os tipos de licença do Spanner Omni, consulte a visão geral das edições do Spanner Omni.

  • Vencimento da licença: a data em que a licença da implantação expira.

Configuração da implantação

  • Uso da CPU: um gráfico em tempo real que mostra a carga de processamento em toda a implantação. Você pode alternar entre Zona e Servidor para conferir a utilização.

  • Tabela de recursos: oferece uma visualização detalhada dos componentes na sua implantação com as seguintes informações. Os servidores são agrupados por zona.

    Coluna Descrição
    Nome do recurso O nome da zona ou do nó de servidor específico do Spanner Omni.
    Tipo
    • Zona: mostra o tipo de zona (por exemplo, leitura/gravação, somente leitura ou testemunha).
    • Servidor do Spanner Omni: nós individuais que executam o serviço do Spanner Omni. O console do Spanner Omni identifica servidores raiz especificamente.
    Status Indica se o recurso está íntegro (por exemplo, Ready).
    Local A região física ou lógica que hospeda a zona (por exemplo, us-central1).
    vCPUs, memória e armazenamento usados A alocação e utilização de recursos atual para cada nó e zona.

Bancos de dados

A página Bancos de dados oferece uma visualização centralizada de todos os bancos de dados na sua implantação do Spanner Omni. A tabela nesta página inclui as seguintes informações:

Coluna Descrição
Nome do banco de dados O identificador exclusivo do seu banco de dados (por exemplo, retail, ycsbdb).
Dialeto O dialeto SQL compatível com o banco de dados:
  • GOOGLE_STANDARD_SQL: o dialeto padrão, que oferece suporte completo aos recursos do Spanner.
  • POSTGRESQL: uma interface compatível com PostgreSQL.
Uso da CPU A porcentagem de recursos de CPU consumidos pelo banco de dados. Isso ajuda a identificar bancos de dados de alta carga.
Tables O número total de tabelas definidas pelo usuário no banco de dados.
Período de armazenamento da versão O período em que o Spanner Omni retém dados históricos para recuperação pontual (por exemplo, 1h).

Backups

A página Backups oferece uma visão abrangente de todos os backups associados à sua implantação do Spanner Omni. Os backups são snapshots transacionais e externamente consistentes do seu banco de dados que o Spanner Omni armazena em soluções de armazenamento externas.

Para mais informações, consulte Backups do Spanner Omni.

Armazenamento total no backup

A seção Armazenamento total de backup mostra o tamanho cumulativo de todos os backups armazenados no seu armazenamento externo, como Amazon Simple Storage Service (Amazon S3), Cloud Storage ou armazenamento local compatível com o Amazon S3.

Tabela de backups

A tabela de backups mostra as seguintes informações para cada backup:

Coluna Descrição
Nome do backup O identificador exclusivo do backup.
Banco de dados de origem O nome do banco de dados em que o console do Spanner Omni criou o backup.
Status O estado atual do backup. Os status comuns incluem:
  • Pronto: o backup foi concluído e está disponível para restauração.
  • Criando: o backup está em andamento.
  • Expira em breve: o backup está perto da data de validade especificada pelo usuário.
Tamanho do backup O tamanho dos dados de backup no armazenamento.
Horário da criação O carimbo de data/hora em que o servidor do Spanner Omni iniciou o processo de backup.
Horário do snapshot (ou horário da versão) O ponto no tempo que o backup representa. Todos os dados no backup são um snapshot consistente do banco de dados naquele momento.
Tempo de expiração A data e a hora em que o Spanner Omni exclui o backup.

Insights do sistema

A página Insights do sistema oferece observabilidade granular para sua implantação do Spanner Omni, permitindo monitorar a integridade do sistema, analisar a performance e depurar problemas.

É possível personalizar os dados mostrados no painel com os seguintes filtros:

  • Zonas: filtre métricas para zonas de implantação específicas.

  • Servidores: detalhe os nós de servidores individuais.

  • Bancos de dados: veja métricas de um banco de dados específico ou de toda a implantação.

  • Intervalo de tempo: selecione uma janela de lookback de 1 hora a 7 dias.

Uso da CPU

Esta seção monitora a carga de processamento em toda a implantação. É possível agrupar essa métrica por:

  • Zona: identifica desequilíbrios de carga entre locais físicos.

  • Prioridade: veja como os recursos são divididos entre tarefas de prioridade alta, média e baixa.

  • Tipo de operação: divide o uso por tarefas iniciadas pelo usuário, como leituras, gravações e confirmações.

Latência

Esta seção acompanha a velocidade das suas operações:

  • Latência de solicitação: o tempo gasto para solicitações individuais de API.

  • Latência da transação: o tempo total para concluir transações de banco de dados.

  • Percentis: por exemplo, confira no 50º percentil (P50) para a performance mediana. No entanto, a solução de problemas geralmente exige verificar P90 ou P99.

Capacidade de processamento e operações

Esta seção mostra as seguintes informações:

  • Capacidade de processamento: o volume de dados que o sistema lê ou grava na implantação (medido em bytes por segundo).

  • Operações por segundo: a contagem total de chamadas de API que o sistema processa.

Tempo de espera de bloqueio

Essa métrica mede o tempo cumulativo que as transações passam aguardando bloqueios. Picos nessa métrica, especialmente quando combinados com alta latência e uso normal da CPU, geralmente indicam contenção de bloqueio.

Métricas de armazenamento

  • Capacidade de armazenamento: o espaço de armazenamento total e disponível no sistema de arquivos subjacente, que o console do Spanner Omni agrupa por zona.

  • Uso do armazenamento: o número de bytes usados pelos seus bancos de dados. O processo de compactação de dados do Spanner Omni pode causar flutuações temporárias nesses números.

Performance do sistema de arquivos

Esta seção fornece insights sobre a performance da camada de armazenamento subjacente (SpanhostFS):

  • Latência do sistema de arquivos: o tempo gasto em operações de E/S de baixo nível (leitura, gravação e limpeza).

  • Capacidade de processamento do sistema de arquivos: a taxa de transferência de dados no nível do sistema de arquivos.

Query Insights

A página Query Insights ajuda a detectar e diagnosticar problemas de desempenho nas consultas SQL e instruções DML (INSERT, UPDATE e DELETE). Use o Query Insights para identificar consultas ineficientes que podem contribuir para a alta utilização da CPU.

  • Detecção: determine se as consultas são a principal causa da carga da CPU da implantação.

  • Identificação: identifique as consultas ou tags de solicitação de aplicativo específicas que consomem mais recursos.

  • Análise: use métricas granulares, como latência e contagem de linhas, para entender por que uma consulta pode ser lenta.

Carga do banco de dados por tempo de execução (todas as consultas)

Carga do banco de dados por tempo de execução mostra o uso agregado da CPU para todas as consultas ao longo do tempo. Para mostrar a carga de um banco de dados específico, use um filtro de banco de dados.

N principais consultas e tags

Esta seção mostra uma série temporal das consultas ou tags que estão causando a maior parte da carga do banco de dados no período selecionado.

Tabela das principais consultas e tags

A tabela lista as principais consultas e tags que consomem recursos. Use isso para identificar as consultas que consomem mais recursos na sua carga de trabalho de consultas.

Coluna Descrição
Impressão digital Um identificador exclusivo para um "formato" de consulta específico.
Tag de solicitação ou consulta O texto SQL normalizado da consulta. Se o aplicativo fornecer uma tag de solicitação nas opções de consulta, o console do Spanner Omni vai mostrar essa tag. Assim, você pode agrupar consultas relacionadas (por exemplo, checkout_process).
Tipo de consulta O tipo de operação (por exemplo, QUERY).
CPU (%) A porcentagem do total de recursos de CPU do banco de dados que essa consulta consome durante o intervalo.
Contagem de execução O número total de vezes que o console do Spanner Omni executou a consulta.
Latência média (ms) O tempo médio gasto para concluir a consulta, incluindo o tempo de rede entre os servidores.
Média de linhas verificadas O número médio de linhas que o Spanner Omni lê para processar a consulta. Taxas altas de verificação para retorno geralmente indicam índices ausentes ou ineficientes.
Média de linhas retornadas O número médio de linhas que o console do Spanner Omni envia de volta ao aplicativo.
Bytes retornados A quantidade média de dados que o console do Spanner Omni retorna por execução.