Identidade e ambientes

Cadastre o serviço e seus ambientes antes de configurar os SDKs. O nome enviado precisa corresponder ao cadastro para que as consultas encontrem os mesmos dados.

Informação	Exemplo	Onde configurar
Serviço	checkout-api	service nos logs e métricas; service.name no OpenTelemetry; vínculo do DSN no Farol
Ambiente	production	environment nos logs e erros; deployment.environment.name nas traces
Versão	2026.10.01	service.version nas traces e release nos eventos de erro
Equipe	payments	Cadastro do serviço

Use o slug do ambiente, exatamente como cadastrado. production, producao e prod são valores diferentes.

Logs estruturados

{"level":"error","service":"checkout-api","environment":"production","message":"falha ao confirmar pedido","trace_id":"4d2e0f4d6a994d778a49c1775d0ca280"}

Inclua trace_id somente quando houver um contexto real de trace. O ID tem 32 dígitos hexadecimais; não gere outro ID só para preencher o campo.

Traces e ambiente

Configure service.name igual ao cadastro e o atributo deployment.environment.name igual ao slug do ambiente. O atributo antigo deployment.environment não é a referência usada para separar os ambientes nos painéis RED do Farol.

Os indicadores de requisições, erros e duração dependem de spans de servidor e da marcação correta de falhas. A presença de uma trace não garante, sozinha, que esses indicadores estão completos.

Confirme os campos

Faça uma requisição real, gere um log e confira os campos na interface. Se também houver um erro na requisição, compare o trace_id completo entre erro, log e trace.

Continue em configuração de traces, coleta de logs ou captura de erros.