Esta página oferece informações gerais sobre a coleta de traces com o OpenTelemetry. Para monitorar e depurar solicitações do Spanner, ative os traces 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 traces fornecem informações relevantes para cada solicitação de um cliente, como:
Períodos com carimbos de data/hora de quando o cliente enviou uma solicitação de RPC e quando 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 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, 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:
Identificar se a latência é devido à latência de rede entre o aplicativo e o Spanner ou se ela está ocorrendo no Spanner.
Identificar 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 o 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 períodos de trace 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 traces usando OpenTelemetry APIs. O OpenTelemetry é um framework de observabilidade de código aberto. Ele oferece uma ampla variedade de configurações, como exportadores para back-ends específicos, taxas de amostragem e limites de período.
Exportar traces usando o OTLP
Como parte da configuração do OpenTelemetry, você usa um exportador para enviar dados de trace a um back-end de observabilidade. Recomendamos o uso de um exportador do protocolo OpenTelemetry
(OTLP)
que envia dados usando o protocolo OpenTelemetry. É possível configurar o exportador do OTLP
para enviar traces diretamente a back-ends de observabilidade que oferecem suporte ao OTLP,
como o Cloud Trace usando
Telemetry
API, ou
a um coletor do OpenTelemetry .
Limitações
Os traces do Spanner têm as seguintes limitações:
- Os períodos de trace estão disponíveis apenas para as bibliotecas de cliente Java, Go, Node e Python.
- Os traces 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 períodos de trace no back-end de observabilidade é faturável. Por exemplo, se você usar o Cloud Trace como back-end, será cobrado de acordo com os preços do Cloud Trace.
Para entender melhor o faturamento, comece com uma pequena taxa de amostragem de trace com base no tráfego.
A seguir
Para configurar o rastreamento do lado do cliente e de ponta a ponta, consulte Configurar a coleta de traces usando o OpenTelemetry.