Rastreios e intervalos

Este documento apresenta uma introdução aos rastreios e aos intervalos. Um rastreio representa uma única operação ponto a ponto. Os rastreios são compostos por extensões, que são registos de uma única função ou operação.

Modelo de dados de rastreio

Um rastreio tem as seguintes propriedades:

  • ID de rastreio: o identificador exclusivo da operação ponto a ponto. O ID de rastreio tem de ser propagado como contexto como parte da operação ponto a ponto.

  • Uma coleção de intervalos que partilham o mesmo valor para o ID do rastreio.

    O Cloud Trace usa o ID do rastreio para identificar os intervalos no respetivo repositório que estão associados ao mesmo rastreio.

Modelo de dados de intervalo

Um intervalo corresponde a uma operação que ocorreu durante um período finito, mas não nulo. A lista seguinte apresenta algumas propriedades essenciais armazenadas por cada intervalo:

  • ID de rastreio: o identificador da operação ponto a ponto na qual esta operação geral específica ocorreu.
  • ID do intervalo: o identificador exclusivo do intervalo. Se a mesma operação for invocada no cumprimento de uma única operação geral várias vezes, um rastreio pode conter vários intervalos com o mesmo nome. No entanto, cada intervalo tem um ID do intervalo distinto.
  • ID do intervalo principal: identifica a operação que invocou este intervalo. O intervalo "root" tem o ID do intervalo principal definido como null.
  • Nome: o nome da operação que foi realizada.
  • Hora de início: a hora de início da operação.
  • Hora de fim: a hora de fim da operação.

Os intervalos também podem conter atributos, que armazenam informações adicionais sobre uma operação através de pares de chave/valor. O Cloud Trace recomenda que use as convenções semânticas do OpenTelemetry sempre que possível.

Recursos

Recursos do OpenTelemetry:

O que se segue?