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

Faça o download do console do Spanner Omni para executar uma única instância em toda a implantação. Para mais informações, consulte Fazer o download do 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 que a 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, na sigla em inglês).
   • PATH_TO_CLIENT_CERT_DIR: o caminho para o diretório do certificado 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 de vários clusters

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 navegador, acesse http://HOST_ADDRESS:15026.

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

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 os detalhes da implantação:

• ID da implantação: um identificador exclusivo para sua implantação atual do Spanner Omni. Especifique 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.r5).

• 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 Visão geral das edições do Spanner Omni.

• Expiração 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 na implantação. É possível alternar entre Zona e Servidor para ver a utilização.

• Tabela de recursos: fornece uma visualização detalhada dos componentes na 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 os 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, armazenamento usado	A alocação e a utilização atuais de recursos 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 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 que o banco de dados consome. Isso ajuda a identificar bancos de dados de alta carga.
Tabelas	O número total de tabelas definidas pelo usuário no banco de dados.
Período de armazenamento da versão	A duração em que o Spanner Omni retém dados históricos para recuperação pontual (por exemplo, 1h).

Backups

A página Backups oferece uma visualização abrangente de todos os backups associados à implantação do Spanner Omni. Os backups são snapshots transacionais e com consistência externa do 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 armazenamento externo (por exemplo, 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á próximo 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.
Hora do snapshot (ou horário da versão)	O momento que o backup representa. Todos os dados no backup são um snapshot consistente do banco de dados nesse 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 o desempenho e depurar problemas.

É possível personalizar os dados exibidos 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: confira as métricas de um banco de dados específico ou de toda a implantação.

• Período: 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: identifique 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: detalhe o uso por tarefas iniciadas pelo usuário, como leituras, gravações e confirmações.

Latência

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

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

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

• Percentis: por exemplo, veja isso no 50º percentil (P50) para desempenho mediano. No entanto, a solução de problemas geralmente requer a verificação de 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 esperando por 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, que o console do Spanner Omni agrupa por zona.

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

Desempenho do sistema de arquivos

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

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

• Capacidade 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 nas instruções DML (INSERT, UPDATE e DELETE). Use o Query Insights para identificar consultas ineficientes que podem contribuir para o alto uso da CPU.

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

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

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

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

A 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 visualização de série temporal das consultas ou tags que estão causando a maior carga do banco de dados no período selecionado.

Tabela de principais consultas e tags

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

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 exibir essa tag, permitindo que você agrupe 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 servidores.
Média de linhas verificadas	O número médio de linhas que o Spanner Omni lê para processar a consulta. Proporções 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 para seu aplicativo.
Bytes retornados	A quantidade média de dados que o console do Spanner Omni retorna por execução.