📊Dev

OpenTelemetry Span JSON

Gera span OpenTelemetry no formato JSON.

Nome span

Trace ID

YAML

—

Um span de OpenTelemetry com os identificadores válidos

Um span é o registro de uma operação dentro de um rastro distribuído: tem nome, um identificador próprio, o identificador do rastro a que pertence, o tipo e o resultado. Encadeados pelo mesmo identificador de rastro, os spans reconstroem o caminho de uma requisição por vários serviços — que é a razão de existir da instrumentação distribuída.

Preencha o nome e, se já tiver, o identificador do rastro, e a página monta o span em JSON. Os tamanhos não são negociáveis: o identificador do rastro tem 16 bytes, ou 32 dígitos hexadecimais, e o do span tem 8 bytes, ou 16 dígitos. Identificador com tamanho errado é descartado pelo coletor, e identificador só de zeros é explicitamente inválido na especificação.

O uso natural é montar um exemplo para testar um coletor ou uma configuração de exportador sem precisar instrumentar uma aplicação inteira. Vale notar o que fica de fora do span mínimo: os carimbos de tempo de início e fim, os atributos, os eventos e o identificador do span pai — este último é o que forma a árvore. Um span sem pai é a raiz do rastro.

Perguntas frequentes

Posso reaproveitar o mesmo identificador de rastro?

Deve, e é o ponto: todos os spans da mesma requisição compartilham o identificador do rastro e se distinguem pelo identificador próprio. É a ligação entre eles que permite montar a linha do tempo. O que não pode repetir é o identificador do span dentro do mesmo rastro.

Como o identificador viaja entre serviços?

Pelo cabeçalho de contexto de rastro padronizado pelo W3C, que carrega a versão, o identificador do rastro, o do span pai e as opções, tudo separado por hífen. É esse cabeçalho que faz o rastro atravessar a fronteira entre serviços sem cada um precisar conhecer o outro.

O que significa o tipo do span?

Ele diz o papel da operação: servidor, para quem atendeu a requisição; cliente, para quem a fez; produtor e consumidor, para mensageria; e interno, para trabalho que não cruza fronteira. As ferramentas de visualização usam isso para desenhar a relação entre serviços.

Ferramentas Relacionadas

✔️

Validador JSON

Valide dados JSON para verificar erros de sintaxe. Relatório de erros detalhado com linha e posição do problema.

⚖️

Analisador de Tamanho de JSON por Chave

Analisa um JSON e mostra quantos bytes cada chave ocupa, em ordem de peso, com percentual do total e o caminho completo de cada nó.

🔄

Conversor JSON ↔ CSV

Converta dados entre JSON (array de objetos) e CSV bidirecional. Cole e converta instantaneamente no navegador, sem fazer upload de arquivos.

📦

Gerador de package.json

Construa um package.json mínimo: name, version, description, scripts, license, repository, type (module/commonjs). Tudo no navegador.

🌐

Comparador de Traduções i18n

Compara dois arquivos JSON de tradução e aponta chaves faltando, sobrando, vazias e placeholders divergentes entre os dois idiomas.

📦

Testador de Range SemVer

Testa quais versões satisfazem um range semver (^1.2.3, ~2.0, >=1 <2) e explica o intervalo em limite inferior e superior.