Usar o console do Spanner Omni

Visualizar

Esse produto ou recurso é uma oferta de pré-lançamento sujeita aos "Termos de ofertas pré-GA" na seção "Termos gerais de serviço" dos Termos específicos de serviço e só pode ser usado para fins de desenvolvimento, teste, prototipagem e demonstração de programas de software. Ele não pode ser usado para fins comerciais ou de processamento de dados. Os produtos e recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

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

O console do Spanner Omni oferece suporte a implantações não criptografadas que executam a versão de pré-lançamento do Spanner Omni. Para acessar os recursos que permitem criar implantações com criptografia TLS, entre em contato com o Google para solicitar acesso antecipado à versão completa do Spanner Omni. Para implantações que usam criptografia TLS, use alertas do Prometheus e Grafana para monitorar suas implantações.

Iniciar o console do Spanner Omni

Faça o download do console do Spanner Omni para executar uma única instância para 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 /app/bin/spanner-console
   

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. Ela 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 principais identificadores 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 do Spanner Omni que você está executando (por exemplo, 2026.r1-beta).

Configuração da implantação

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

• Tabela de recursos: fornece uma visã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 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 utilização de recursos atuais para cada nó e zona.

Bancos de dados

A página Bancos de dados oferece uma visão centralizada de todos os bancos de dados na 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 o 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.
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 visão abrangente de todos os backups associados à 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 externo.

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

Armazenamento total no backup

A seção Armazenamento total no 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 está concluído e 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.
Hora do snapshot (ou hora 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 a implantação do Spanner Omni, que permite 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 servidor individuais.

• Bancos de dados: confira métricas para um banco de dados específico ou para 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 na implantação. É possível agrupar essa métrica por:

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

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

• 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 acompanha a velocidade das operações:

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

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

• Percentis: por exemplo, confira isso no 50º percentil (P50) para performance mediana. No entanto, a solução de problemas geralmente exige 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: o número total de chamadas de API processadas pelo sistema.

Tempo de espera de bloqueio

Essa métrica mede o tempo cumulativo que as transações gastam 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 subjacente, que o console do Spanner Omni agrupa por zona.

• Utilização 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 para operações de E/S de baixo nível (leitura, gravação e descarga).

• 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 performance para suas consultas SQL e instruções DML (INSERT, UPDATE e DELETE). Use o Query Insights para identificar consultas ineficientes que possam contribuir para o alto uso 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 específicas ou tags de solicitação de aplicativo que são mais intensivas em recursos.

• Análise: use métricas granulares, como latência e contagens 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 fornece uma visualização de 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 de principais consultas e tags

A tabela lista as principais consultas e tags de consumo. É possível usar isso para identificar as consultas mais intensivas em 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 mostrar essa tag, permitindo 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 servidores.
Média de linhas verificadas	O número médio de linhas que o Spanner Omni lê para processar a consulta. As proporções altas de linhas verificadas para retornadas 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 seu aplicativo.
Bytes retornados	A quantidade média de dados que o console do Spanner Omni retorna por execução.