Nesta página, você encontra uma visão geral dos componentes de alto nível envolvidos em uma solicitação do Spanner e como cada componente pode afetar a latência.
Solicitações da API Spanner
Os componentes de alto nível usados para fazer uma solicitação da API Spanner incluem:
Bibliotecas de cliente do Spanner, que fornecem uma camada de abstração sobre o gRPC e processam detalhes de comunicação do servidor, como gerenciamento de sessão, transações e novas tentativas.
O Google Front End (GFE), que é um serviço de infraestrutura comum a todos os serviços do Google Cloud, incluindo o Spanner. O GFE verifica se todas as conexões do Transport Layer Security (TLS) estão interrompidas e aplica proteções contra ataques de negação de serviço. Para saber mais sobre o GFE, consulte Serviço de front-end do Google.
O front-end da API Spanner, que executa várias verificações na solicitação da API (incluindo autenticação, autorização e verificações de cota) e mantém sessões e estados de transação.
O banco de dados do Spanner, que executa leituras e gravações no banco de dados.
Quando você faz uma chamada de procedimento remoto para o Spanner, as bibliotecas de cliente do Spanner preparam a solicitação de API. Em seguida, a solicitação de API passa pelo GFE e pelo front-end da API Spanner antes de chegar ao banco de dados do Spanner.
Ao medir e comparar as latências de solicitação entre diferentes componentes e o banco de dados, você pode determinar qual componente está causando o problema. Essas latências incluem latências de ida e volta do cliente, GFE, solicitação da API Spanner e latências de consulta.
As seções a seguir explicam cada tipo de latência observada no diagrama anterior.
Latência de ida e volta do cliente
A latência de ida e volta do cliente é o tempo (em milissegundos) entre o primeiro byte da solicitação da API Spanner que o cliente envia ao banco de dados (pelo GFE e pelo front-end da API Spanner) e o último byte da resposta que o cliente recebe do banco de dados.
A métrica grpc.io/client/roundtrip_latency fornece o tempo entre o primeiro byte da solicitação de API enviada ao último byte da resposta recebida.
Para capturar e visualizar a latência desse componente, consulte Capturar e visualizar a latência de ida e volta do cliente com o OpenTelemetry ou com o OpenCensus.
Latência do GFE
A latência do Google Front End (GFE) é o período (em milissegundos) entre o momento em que a rede do Google recebe uma chamada de procedimento remoto do cliente e o momento em que o GFE recebe o primeiro byte da resposta. Essa latência não inclui handshakes de TCP/SSL.
Todas as respostas do Spanner, sejam elas REST ou gRPC, incluem um cabeçalho que contém o tempo total entre o GFE e o back-end (o serviço Spanner) da solicitação e da resposta. Isso ajuda a diferenciar melhor a origem da latência entre o cliente e a rede do Google.
A métrica spanner/gfe_latency captura e expõe a latência do GFE para solicitações do Spanner.
Para capturar e visualizar a latência desse componente, consulte Capturar e visualizar a latência do GFE com o OpenTelemetry ou com o OpenCensus.
Latência da solicitação da API Spanner
A latência da solicitação da API Spanner é o período (em segundos) entre o primeiro byte da solicitação que o front-end da API Spanner recebe e o último byte da resposta enviado pelo front-end da API Spanner. A latência inclui o tempo necessário para processar solicitações de API no back-end do Spanner e na camada da API. No entanto, essa latência não inclui sobrecarga de rede ou proxy reverso entre os clientes e os servidores do Spanner.
A métrica spanner.googleapis.com/api/request_latencies captura e expõe a latência de front-end da API Spanner para solicitações do Spanner.
Para capturar e visualizar a latência desse componente, consulte Capturar e visualizar a latência de solicitação da API Spanner com o OpenTelemetry ou com o OpenCensus.
Latência da consulta
A latência da consulta é o tempo (em milissegundos) necessário para executar consultas SQL no banco de dados do Spanner.
A latência da consulta está disponível para a API executeSql.
Se o parâmetro QueryMode for definido como PROFILE, o ResultSetStats do Spanner estará disponível nas respostas.
Definir QueryMode como PROFILE retorna o plano de consulta e as estatísticas de execução com os resultados. Além disso, ResultSetStats inclui o tempo decorrido para executar consultas no banco de dados do Spanner.
Para capturar e visualizar a latência desse componente, consulte Capturar e visualizar a latência da consulta com o OpenTelemetry ou com o OpenCensus.
A seguir
- Saiba como identificar pontos de latência nos componentes do Spanner.