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 completo do cliente e de ponta a ponta pode ajudar a monitorar o desempenho e depurar problemas.
Os traces 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 períodos e atributos, consulte Períodos e Atributos na documentação do OpenTelemetry.
Rastreamento de ponta a ponta
Além do rastreamento do lado do cliente, é possível ativar o rastreamento completo (Prévia). 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 se deve à latência de rede entre seu aplicativo ou se a latência estiver ocorrendo dentro do Spanner.
Identifique as regiões do Google Cloud que as solicitações do seu aplicativo estão sendo encaminhados e se houver 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 traces usando APIs do OpenTelemetry. O OpenTelemetry é um framework de observabilidade de código aberto. O OpenTelemetry oferece várias configurações, como exportadores de back-ends específicos, proporções de amostragem e limites de períodos.
Exportar rastros com exportadores e coletores
Como parte das configurações, é possível exportar os traces para uma capacidade de observabilidade back-end. 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 uma coletador (link em inglês). 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 seu aplicativo. O coletor recebe, processa e exporta mensagens OLTP para o back-end de observabilidade.
Limitações
Os traces 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 períodos 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 aos preços do Cloud Trace.
Para entender melhor o faturamento, comece com uma proporção de amostragem de traces pequena 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.