Este documento apresenta os rastros e os intervalos. Um trace representa uma única operação de ponta a ponta. Os rastros são compostos por períodos, que são registros de uma única função ou operação.
Modelo de dados de rastreamento
Um rastro tem as seguintes propriedades:
ID do rastreamento: é o identificador exclusivo da operação de ponta a ponta. O ID do rastreamento precisa ser propagado como contexto como parte da operação de ponta a ponta.
Uma coleção de períodos que compartilham o mesmo valor para o ID do rastreamento.
O Cloud Trace usa o ID do trace para identificar quais períodos no repositório estão associados ao mesmo trace.
Modelo de dados de período
Um período corresponde a uma operação que ocorreu em um período de tempo finito, mas não nulo. Confira a seguir algumas propriedades essenciais armazenadas por cada período:
- ID do rastreamento: o identificador da operação completa em que essa operação geral específica ocorreu.
- ID do período: o identificador exclusivo do período. Se a mesma operação for invocada várias vezes no cumprimento de uma única operação geral, um rastro poderá conter vários períodos com o mesmo nome. No entanto, cada span tem um ID distinto.
- ID da span pai: identifica a operação que invocou essa span. O período "raiz" tem o ID de período pai definido como
null
. - Nome: o nome da operação que foi realizada.
- Horário de início: o horário de início da operação.
- Fim: o horário de término da operação.
As extensões também podem conter atributos, que armazenam informações adicionais sobre uma operação usando pares de chave-valor. O Cloud Trace recomenda o uso das convenções semânticas do OpenTelemetry sempre que possível.
Recursos
Recursos do OpenTelemetry:
- OpenTelemetry
- Visão geral do OpenTelemetry Trace
- Rastreamentos do OpenTelemetry
- OpenTelemetry
trace.proto
A seguir
- Saiba mais sobre contexto e propagação de contexto.
- Saiba mais sobre a amostragem.