Esta página oferece informações gerais sobre a recolha de rastreios com o OpenTelemetry. Para monitorizar e depurar pedidos do Spanner, pode ativar rastreios nas bibliotecas de cliente do Spanner. A monitorização por parte do cliente e ponto a ponto pode ajudar a monitorizar o desempenho e depurar problemas.
Os rastreios fornecem informações relevantes para cada pedido de um cliente, como as seguintes:
Intervalos com data/hora em que o cliente enviou um pedido RPC e em que o cliente recebeu a resposta RPC, incluindo a latência causada pela rede e pelo sistema do cliente.
Atributos (pares de chave-valor) que fornecem informações sobre o cliente e a respetiva configuração.
Anotações com eventos importantes nos intervalos.
Para mais informações sobre intervalos e atributos, consulte Intervalos e Atributos na documentação do OpenTelemetry.
Rastreio ponto a ponto
Além da monitorização ao nível do cliente, pode ativar a monitorização ponto a ponto. A monitorização ponto a ponto ajuda a compreender e depurar problemas de latência específicos do Spanner, como os seguintes:
Identifique se a latência se deve à latência da rede entre a sua aplicação e o Spanner ou se a latência está a ocorrer no Spanner.
Identifique as Google Cloud regiões através das quais os pedidos da sua aplicação estão a ser encaminhados e se existe um pedido entre regiões. Um pedido entre regiões significa normalmente latências mais elevadas entre a sua aplicação e o Spanner.
Para evitar a sobrecarga do Cloud Trace e ajudar a gerir os custos de forma eficaz, a monitorização completa tem um limite no número de intervalos de rastreio que pode exportar. Não existe qualquer impacto na utilização da monitorização ponto a ponto para resolução de problemas devido a este limite.
OpenTelemetry
As bibliotecas cliente do Spanner suportam a recolha de rastreios através das APIs OpenTelemetry. O OpenTelemetry é uma framework de observabilidade de código aberto. O OpenTelemetry oferece uma vasta gama de configurações, como exportadores para backends específicos, rácios de amostragem e limites de intervalos.
Exporte rastreios com exportadores e coletores
Como parte das suas configurações, pode exportar os rastreios para um back-end de observabilidade. A maioria dos fornecedores de serviços de observabilidade oferece exportadores para utilização, como o exportador de rastreio.
Além de um exportador, o OpenTelemetry recomenda a configuração de um coletor. Um coletor permite que o seu serviço transfira dados rapidamente e permite que o coletor cuide do processamento adicional, como novas tentativas, processamento em lote e encriptação. Um coletor é executado juntamente com a sua aplicação. O coletor recebe mensagens OLTP, processa as mensagens e exporta-as para o seu back-end de observabilidade.
Limitações
Os rastreios do Spanner têm as seguintes limitações:
- Os intervalos de rastreio estão disponíveis apenas para as bibliotecas cliente Java, Go, Node e Python.
- As rastreios ponto a ponto só podem ser exportados para o Cloud Trace.
Preços
Além da utilização do Spanner, a monitorização pode incorrer em custos através do seu back-end de observabilidade.
A ingestão de intervalos de rastreio no seu back-end de observabilidade é faturável. Por exemplo, se usar o Cloud Trace como back-end, a faturação é feita de acordo com os preços do Cloud Trace.
Para compreender melhor a faturação, comece com uma pequena taxa de amostragem de rastreio com base no seu tráfego.
O que se segue?
Para configurar a monitorização do lado do cliente e ponto a ponto, consulte o artigo Configure a recolha de rastreios com o OpenTelemetry.