Neste documento, apresentamos uma introdução aos traces e períodos. Um trace representa uma única operação de ponta a ponta. Os traces são compostos de períodos, que são registros para uma única função ou operação.
Modelo de dados de trace
Um trace tem as seguintes propriedades:
ID do trace: o identificador exclusivo da operação completa. O ID do trace precisa ser propagado como contexto como parte da operação completa.
Uma coleção de períodos que compartilham o mesmo valor para o ID do trace.
O Cloud Trace usa o ID do trace para identificar quais períodos no repositório dele estão associados ao mesmo trace.
Modelo de dados do período
Um período corresponde a uma operação que ocorreu em um período finito, mas diferente de zero. Veja a seguir algumas propriedades essenciais armazenadas por cada período:
- ID do trace: 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 no fulfillment de uma única operação geral várias vezes, um trace poderá conter vários períodos com o mesmo nome. No entanto, cada período tem um ID diferente.
- ID do período pai: identifica a operação que invocou esse período. O
período "raiz" tem o ID do período pai definido como
null. - Nome: o nome da operação que foi executada.
- Horário de início: o horário de início da operação.
- Horário de término: o horário de término da operação.
Os períodos também podem conter atributos, que armazenam informações adicionais sobre uma operação usando pares de chave-valor. O Cloud Trace recomenda que você use as convenções semânticas do OpenTelemetry sempre que possível.
Recursos
Recursos do OpenTelemetry:
A seguir
- Saiba mais sobre contexto e propagação de contexto.
- Saiba mais sobre amostragem.