Este documento explicará como adicionar atributo aos dados trace enviados à API Trace para que os spans exibam propriedades específicas na interface.
Por que decorar seus vãos?
Ao enviar dados para nossa API trace , você pode adicionar atributos personalizados aos períodos. Por exemplo, você pode decidir adicionar um atributo como customer.id
ou user.id
para ajudar a analisar seus dados trace .
Alguns valores de atributo esperados fazem com que nossa interface distributed tracing exiba algumas propriedades e detalhes específicostrace . Por exemplo, se um período tiver um atributo com prefixo error.
, a interface exibirá esse período com um erro. Para outro exemplo, um intervalo com um atributo que possui um prefixo db.
será exibido como um intervalo de armazenamento de dados na interface e terá sua consulta de armazenamento de dados destacada.
Decorar seus vãos para mostrar propriedades específicas em nossa interface pode ajudá-lo:
- Entenda melhor a estrutura dos seus dados de rastreamento.
- Solucione problemas com mais facilidade.
Como decorar seus vãos com atributo
Esta tabela explica como fazer com que os spans sejam enviados à API trace para aparecerem com propriedades específicas na interface do usuário. Para descrições de propriedades, consulte propriedades de span.
Propriedade de extensão desejada | indicador de interface | Como adicionar propriedade |
---|---|---|
Erros | Use um atributo com um prefixo | |
Externo | Use um atributo com um prefixo | |
Armazenamento de dados | Use um atributo com um prefixo | |
Serviço | Isso não pode ser feito com um atributo. Um intervalo é classificado como intervalo de serviço se for o intervalo raiz ou se seu pai for de uma entidade diferente. Se um intervalo tiver diversas propriedades, a classificação do intervalo de serviço terá precedência na interface. | |
Em processo | Isso não pode ser feito com um atributo. Um intervalo é classificado como em processo se não tiver sido classificado como intervalo de serviço, intervalo de armazenamento de dados ou intervalo externo. |
Para obter mais informações sobre como essas propriedades de span são determinadas e armazenadas, consulte estruturatrace .
Dicas para adicionar atributo:
- Você pode adicionar qualquer atributo a um intervalo. Por exemplo: você pode adicionar um atributo como
customer.id
para poder pesquisar rastreamento globalmente por rastreamento contendo clientes específicos. - Um intervalo pode estar em diversas categorias. Por exemplo,
external
é uma categoria mais geral do quedatastore
, portanto, se um intervalo for classificado comoexternal
edatastore
, ele será indicado como um intervalo de armazenamento de dados na interface.
Exemplos JSON
Aqui estão exemplos JSON mostrando como usar atributo para definir propriedades de span: