Como usar o rastreamento distribuído

As solicitações recebidas para os serviços do Cloud Run geram automaticamente os traces que você pode ver no Cloud Trace. É possível usar esses traces para identificar origens de problemas de latência na implementação sem precisar adicionar mais instrumentação ao Cloud Trace. O cabeçalho padrão de propagação de contexto de trace do W3C traceparent é preenchido automaticamente para solicitações do Cloud Run.

No entanto, se você adicionarinstrumentação adicional, também é possível usar o Cloud Trace para medir o tempo necessário para a propagação da solicitação em cada camada da implementação. Por exemplo, o tempo que leva para concluir uma consulta de banco de dados e receber os resultados de uma solicitação de API ou executar alguma lógica de negócios complexa. Cada uma dessas medidas de tempo específicas da camada é um "período". É possível visualizar os traces no Cloud Trace como gráficos de cascata que refletem os valores de latência.

Cobranças de faturamento

Os traces gerados automaticamente no Cloud Run, seja por amostragem ou forçado, não resultam em cobranças. No entanto, se você usar as bibliotecas do Cloud Trace e adicionar seus próprios períodos correlacionando-os aos períodos fornecidos para o Cloud Run, você será cobrado pelo Cloud Trace.

Taxa de amostragem do trace

O Cloud Run não usa amostras nos traces para cada solicitação. Quando usadas com o Cloud Run, as amostras das solicitações são amostradas a uma taxa máxima de 0,1 solicitação por segundo para cada instância (ou uma solicitação a cada 10 segundos). Também é possível forçar o rastreamento de uma solicitação específica. Se você forçar o rastreamento de uma solicitação, a amostragem dela será feita a uma taxa máxima de 0,1 segundo para cada instância ou 10 solicitações por segundo.

O Cloud Run não é compatível com a configuração da taxa de amostragem do Cloud Run.

Quando adicionar instrumentação

Os traces são gerados automaticamente sem qualquer instrumentação necessária no serviço. No entanto, em alguns casos, convém adicionar um código de instrumentação ao seu serviço para aproveitar ao máximo o recurso do Cloud Trace. Por exemplo, você precisa adicionar instrumentação se quiser:

  • Crie períodos de trace personalizados, por exemplo, para ver os dados de tempo do tempo que o serviço leva para trabalhar de volta da API Cloud Translation.
  • Propagar o contexto do trace para que o Cloud Trace mostre o fluxo de solicitações em vários serviços como uma única solicitação.

Para adicionar instrumentação, consulte Como instrumentar o rastreamento para aplicativos. Os traces resultantes da instrumentação no serviço geram cobranças padrão de cobrança do Cloud Trace.

Como visualizar traces

Para saber mais, consulte a documentação sobre como visualizar traces.