Nossa API trace é usada para enviar dadosdistributed tracing para a New Relic: em nosso próprio formato genérico ou no formato de dados Zipkin . Essa API também é a forma como os dados trace de alguns de nossos integradores e exportadores são relatados à New Relic.
Quer experimentar a API trace ? Certifique-se de ter criado uma conta gratuita da New Relic. Não é necessário cartão de crédito.
Para pular algum conteúdo introdutório e começar rapidamente, acesse Começar a relatar dados.
Qual é a API trace ?
A API trace é uma forma pela qual a New Relic coleta dadosdistributed tracing . Temos algumas ferramentas de rastreamento que relatam dados por meio desta API (Infinite Tracing, nossa integração de código aberto e nossos SDKs de telemetria), ou você pode usar a API diretamente para criar sua própria implementação de rastreamento.
Razões para usar a API trace :
- Você tem sua própria ferramenta distributed tracing personalizada e deseja ver esses dados no New Relic sem alterar sua instrumentação.
- Você tem uma ferramenta que emite dados de rastreamento, mas requer um backend para armazenamento trace .
- Você deseja relatar dados distributed tracing para a New Relic sem usar nossas soluções instaladas.
- Você usa o Zipkin e deseja ver os dados trace no New Relic sem alterar sua instrumentação.
Quer entender como os dados trace se relacionam com outros dados da New Relic? Leia sobre nossos tipos de dados.
Requisitos
Para obter detalhes sobre quais dados você pode enviar e como eles são tratados, consulte Regras e limites.
Considerações sobre amostragem
Ao usar a API trace , você tem a opção de ativar o Rastreamento Infinito. O uso do Rastreamento Infinito tem implicações sobre como você configura a amostragem:
Use your own sampling (no Infinite Tracing):
Se você não usar o Rastreamento Infinito, presume-se que você deseja usar sua própria implementação de amostragem para amostrar o rastreamento antes de eles serem enviados para nós. (Se os seus dados de rastreamento excederem nossos limites de dados, aprovaremos a amostragem.)
Use Infinite Tracing:
Se você quiser usar o Infinite Tracing, uma abordagem típica é nos enviar 100% dos seus dados trace e contar com a amostragem do Infinite Tracing. (Ao seguir as instruções para Iniciar relatórios de dados , abaixo, você terá a opção de ativar o Rastreamento infinito.)
Comece a relatar dados
A API trace aceita dados trace nestes dois formatos JSON:
zipkin: o formato de dados trace Zipkin JSON v2 (saiba o que é Zipkin). Comece a enviar dados Zipkin.newrelic: nosso formato geral. Se você não tiver dados no formato Zipkin, use-os. Comece a enviar dados no formato New Relic.
Está tendo problemas para obter dados para relatar? Veja resolução de problemas.
Encontre dados
Você pode encontrar dados enviados através da API trace , ou de integração que utilizam esta API, nestes locais:
- Em nossa interfacedistributed tracing .
- Consultando: Para obter detalhes sobre como consultar e criar gráficos customizados, consulte consultar dados distributed tracing .
Próximos passos
Aqui estão algumas etapas adicionais a serem consideradas:
- Saiba mais sobre como funciona distributed tracing e a estrutura de dados.
- Decore os dados do span com atributo personalizado.
- Use nossa API NerdGraph baseada em GraphQL para consultar programaticamente seus dados de rastreamento.