Esta página oferece informações gerais sobre a coleta de rastros com o OpenTelemetry. Para monitorar e depurar solicitações do Spanner, ative os rastros nas bibliotecas de cliente do Spanner. O rastreamento do lado do cliente e de ponta a ponta pode ajudar a monitorar o desempenho e depurar problemas.
Os rastros fornecem informações relevantes para cada solicitação de um cliente, como as seguintes:
Intervalos com carimbos de data/hora de quando o cliente enviou uma solicitação RPC e quando 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 configuração dele.
Anotações com eventos importantes nos períodos.
Para mais informações sobre spans e atributos, consulte Spans 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 estes:
Identifique se a latência é devido à latência de rede entre seu aplicativo e o Spanner ou se a latência está ocorrendo no Spanner.
Identifique as Google Cloud regiões para as 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 a sobrecarga do Cloud Trace e ajudar a gerenciar os custos de maneira eficaz, o rastreamento de ponta a ponta tem um limite no número de intervalos de rastreamento que você pode exportar. Esse limite não afeta o uso do rastreamento de ponta a ponta para solução de problemas.
OpenTelemetry
As bibliotecas de cliente do Spanner oferecem suporte à coleta de rastros 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 rastros com exportadores e coletores
Como parte das suas configurações, é possível exportar os rastros para um back-end de observabilidade. A maioria dos provedores de serviços de observabilidade oferece exportadores para você usar, como o Exportador de trace.
Além de um exportador, o OpenTelemetry recomenda configurar um coletor. Um coletor permite que seu serviço descarregue dados rapidamente e que ele cuide de outros processamentos, como reexecuções, agrupamentos e criptografia. Um coletor é executado junto ao seu aplicativo. O coletor recebe mensagens OLTP, processa-as e as exporta para o back-end de observabilidade.
Limitações
Os rastros 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 rastros completos só podem ser exportados para o Cloud Trace.
Faturamento
Além do uso do Spanner, o rastreamento pode gerar cobranças pelo back-end de observabilidade.
A ingestão de intervalos de trace no back-end de observabilidade é faturável. Por exemplo, se você usar o Cloud Trace como back-end, vai receber cobranças de acordo com os preços do Cloud Trace.
Para entender melhor o faturamento, comece com uma pequena proporção de amostragem de rastros com base no seu tráfego.
A seguir
Para configurar o rastreamento do lado do cliente e completo, consulte Configurar a coleta de rastros usando o OpenTelemetry.