• EnglishEspañol日本語한국어Português
  • EntrarComeçar agora

Esta tradução de máquina é fornecida para sua comodidade.

Caso haja alguma divergência entre a versão em inglês e a traduzida, a versão em inglês prevalece. Acesse esta página para mais informações.

Criar um problema

Relatar rastreamento no formato Zipkin por meio da API trace

Se quiser criar sua própria implementação de rastreamento, você pode usar nossa API Trace. Este documento explica como enviar dados trace no formato Zipkin para nossa API trace . (Para nosso formato de dados geral, consulte Formato New Relic.)

Requisitos de versão do Zipkin

A API trace oferece suporte a dados do Zipkin JSON v2 (ou superior) sem qualquer modificação. Para obter detalhes sobre esta versão, consulte Detalhes da versão do Zipkin v2 e o esquema do Zipkin v2.

Visão geral do uso da API trace

Usar nossa API trace é tão simples quanto:

  • Enviando dados trace no formato esperado (neste caso, formato zipkin).
  • Enviando esses dados para o endpointapropriado

Nossas instruções de envio de dados têm opções para ativar o rastreamento infinito. Para saber mais sobre isso, consulte Introdução às considerações sobre rastreamento e amostragem infinita .

Para começar a usar a API trace , escolha uma opção:

  • Enviar um tracede amostra: mostra um exemplo curl de envio de um trace para o New Relic. Isso é útil para entender como funciona a API trace e para verificar se você está vendo dados no New Relic.
  • Relatar dados da instrumentação Zipkin existente: se você tiver uma implementação Zipkin existente, poderá simplesmente alterar o endpoint para onde seus dados são enviados.

Enviar amostra de carga útil trace do Zipkin

Esta seção descreve como enviar um trace simples no formato Zipkin para nossa API trace por meio de solicitação curl. Você pode optar por fazer isso para aprender como nossa API funciona e para verificar se os dados estão aparecendo no New Relic antes de fazer uma instrumentação detalhada.

Para começar a enviar uma carga útil de amostra:

  1. (Opcional, para ativar o rastreamento infinito) Primeiro, você deve configurar um observador de rastreamento. Esse procedimento inclui instruções para enviar um trace de amostra usando nosso formato new-relic geral. Quando você chegar a essa etapa, volte aqui para aprender como enviar um trace no formato Zipkin.
  2. Envie uma carga no formato Zipkin seguindo as instruções abaixo.

Enviar carga útil no formato Zipkin

Para enviar um exemplo trace no formato Zipkin:

Obtenha o da conta para a qual você deseja relatar dados.

Você executará uma solicitação curl abaixo. Notas sobre isso:

  • Substitua o espaço reservado da chave de licença pela sua chave de licença.
  • Se você estiver usando o Rastreamento Infinito, use o valor YOUR_TRACE_OBSERVER_URL no lugar do endpoint padrão.
  • Se você quiser enviar mais de uma postagem, altere o ID trace para um valor diferente. Enviar a mesma carga útil ou intervalo id diversas vezes para o mesmo traceId pode resultar em rastreamento fragmentado na interface.
bash
$
curl -i -H 'Content-Type: application/json' \
>
-H 'Api-Key: NEW_RELIC_API_KEY' \
>
-H 'Data-Format: zipkin' \
>
-H 'Data-Format-Version: 2' \
>
-X POST \
>
-d '[
$
{
$
"traceId": "test-zipkin-trace-id-1",
$
"id": "3e0f5885710776cd",
$
"kind": "CLIENT",
$
"name": "post",
$
"duration": 508068,
$
"localEndpoint": {
$
"serviceName": "service-1",
$
"ipv4": "127.0.0.1",
$
"port": 8080
$
},
$
"tags": {
$
}
$
},
$
{
$
"traceId": "test-zipkin-trace-id-1",
$
"parentId": "3e0f5885710776cd",
$
"id": "asdf9asdn123lkasdf",
$
"kind": "CLIENT",
$
"name": "service 2 span",
$
"duration": 2019,
$
"localEndpoint": {
$
"serviceName": "service-2",
$
"ipv4": "127.0.0.1",
$
"port": 8080
$
},
$
"tags": {
$
"error.message": "Invalid credentials"
$
}
$
}
$
]' 'https://trace-api.newrelic.com/trace/v1'

Dentro de um minuto, o trace deverá estar disponível em nossa interface distributed tracing . Para encontrá-lo, execute uma consulta para trace.id. Neste exemplo, foi test-zipkin-trace-id-1. Observe que você pesquisa pelo atributo transformado de trace.id (não traceId).

Aprender mais:

Envie dados da instrumentação Zipkin existente

Notas preliminares:

Para relatar dados de uma instrumentação Zipkin existente, você apontará o tracer Zipkin para os endpoints Trace apropriados da API com alguns metadados de solicitação necessários. Você pode enviar os metadados necessários como cabeçalhos ou parâmetros de consulta (algumas versões tracer Zipkin não permitem especificar cabeçalhos HTTP).

Aqui está um exemplo de como seria criar um Zipkin OkHttpSender em Java configurado para a API trace :

OkHttpSender.create("https://trace-api.newrelic.com/trace/v1?Api-Key=NEW_RELIC_LICENSE_KEY&Data-Format=zipkin&Data-Format-Version=2");

Observe que se você estivesse usando o Infinite Tracing ou tivesse uma conta New Relic na região da UE, o endpoint seria diferente.

Para obter uma explicação sobre Api-Key e outros metadados, consulte Solicitar metadados.

Transformação de dados Zipkin

Para criar uma experiência de pesquisa/consulta consistente, alguns dados do Zipkin serão transformados para corresponder à nomenclatura do atributo New Relic. Para obter mais informações sobre como armazenamos e estruturamos dados trace , consulte Como funciona distributed tracing .

Tag Zipkin

Armazenado na New Relic como...

Detalhes

traceId

trace.id

Identificador exclusivo para um trace.

id

id

Identificador exclusivo por um período.

parentId

parent.id

identificador do span upstream que chamou o serviço.

kind

kind

Client ou Server.

name

name

Nome do intervalo.

duration

duration.ms

Os períodos do Zipkin v2 devem ter durações especificadas em microssegundos e serão convertidos em milissegundos.

localEndpoint: serviceName

service.name

Usamos o nome do serviço Zipkin v2 para identificar a entidade que criou esse intervalo. Se nenhum valor ou uma string vazia for fornecida, o intervalo será atribuído a uma entidade "UNKNOWN" e será exibido como tal na interface. Este valor deve ser fornecido para obter uma experiência completa na interface.

localEndpoint: port

localEndpoint.port

Todos os valores no objeto localEndpoint serão nivelados em um atributo span chamado localEndpoint.key

tags

relatado como atributo

Pares de valores principais no objeto tags no Zipkin v2 serão escritos como span atributo.

anotações

não suportado

Atualmente não oferecemos suporte a anotações na API trace . Os spans não serão rejeitados se contiverem anotações, mas os dados das anotações não serão gravados.

Adicionar outra tag/atributo

Você pode adicionar qualquer tag que desejar ao bloco tags , com exceção da tag restrita. Por exemplo, talvez você queira adicionar um atributo como customer.id ou user.id para ajudá-lo a analisar seus dados trace . tag será convertida em atributo New Relic .

Para saber como controlar como os spans aparecem no New Relic (por exemplo, adicionando erros ou definindo um span como um span de armazenamento de dados), consulte Decorar spans.

Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.