Nesta página, você encontra informações gerais sobre a coleta de rastreamentos com o OpenTelemetry. Para monitorar e depurar solicitações do Spanner, ative os rastreamentos nas bibliotecas de cliente do Spanner. O rastreamento do lado do cliente e de ponta a ponta pode ajudar você a monitorar o desempenho e depurar problemas.
Os rastreamentos fornecem informações relevantes para cada solicitação de um cliente, como:
Abrangências com carimbos de data/hora de quando o cliente enviou uma solicitação de RPC e quando o cliente recebeu a resposta de 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 configuração dele.
Anotações com eventos importantes nos intervalos.
Para mais informações sobre intervalos e atributos, consulte Intervalos e Atributos na documentação do OpenTelemetry.
Rastreamento de ponta a ponta
Além do rastreamento do lado do cliente, você pode ativar o rastreamento de ponta a ponta. O rastreamento de ponta a ponta ajuda a entender e depurar problemas de latência específicos do Spanner, como:
Identifique se a latência é causada pela rede entre o aplicativo e o Spanner ou se ela está ocorrendo no Spanner.
Identifique as Google Cloud regiões pelas quais as solicitações do aplicativo estão sendo encaminhadas e se há uma solicitação entre regiões. Uma solicitação entre regiões geralmente significa latências mais altas entre seu aplicativo e o Spanner.
Para evitar sobrecarregar o Cloud Trace e ajudar a gerenciar os custos de maneira eficaz, a rastreamento de ponta a ponta tem um limite no número de intervalos de rastreamento que podem ser exportados. Não há impacto no uso do rastreamento de ponta a ponta para solução de problemas devido a esse limite.
OpenTelemetry
As bibliotecas de cliente do Spanner oferecem suporte à coleta de rastreamentos usando APIs do OpenTelemetry. O OpenTelemetry é um framework de observabilidade de código aberto. O OpenTelemetry oferece uma ampla variedade de configurações, como exportadores para back-ends específicos, taxas de amostragem e limites de período.
Exportar rastreamentos com exportadores e coletores
Como parte das suas configurações, é possível exportar seus rastreamentos para um back-end de observabilidade. A maioria dos provedores de serviços de observabilidade oferece exportadores para você usar, como o exportador de rastreamento.
Além de um exportador, o OpenTelemetry recomenda configurar um coletor. Um coletor permite que seu serviço descarregue dados rapidamente e que o coletor cuide de outros processamentos, como novas tentativas, agrupamento em lotes e criptografia. Um coletor é executado ao lado do seu aplicativo. O coletor recebe e processa mensagens OLTP e as exporta para o back-end de observabilidade.
Limitações
Os rastreamentos do Spanner têm as seguintes limitações:
- Os intervalos de rastreamento estão disponíveis apenas para as bibliotecas de cliente Java, Go, Node e Python.
- Os rastreamentos de ponta a ponta só podem ser exportados para o Cloud Trace.
Preços
Além do uso do Spanner, o rastreamento pode gerar cobranças pelo back-end de observabilidade.
A ingestão de intervalos de rastreamento no back-end de observabilidade é faturável. Por exemplo, se você usar o Cloud Trace como back-end, a cobrança será feita de acordo com os preços do Cloud Trace.
Para entender melhor o faturamento, comece com uma pequena proporção de amostragem de rastreamento com base no seu tráfego.
A seguir
Para configurar o rastreamento do lado do cliente e de ponta a ponta, consulte Configurar a coleta de rastreamento usando o OpenTelemetry.