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 a performance e depurar problemas.
Os rastros fornecem informações relevantes para cada solicitação de um cliente, como:
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 (Visualização). 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 ela está ocorrendo no Spanner.
Identifique as regiões do Google Cloud pelas quais as solicitações do aplicativo estão sendo roteadas 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.
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 repetição, agrupamento e criptografia. Um coletor é executado junto com o aplicativo. O coletor recebe, processa e exporta as mensagens OLTP 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 e Go.
- 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, 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 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.