Blog on OpenTelemetry

Como Nomear Seus Spans

Wed, 10 Jun 2026 15:06:40 -0400

Um dos aspectos mais fundamentais - e muitas vezes negligenciados - de uma boa instrumentação é a nomenclatura. Esta publicação é a primeira de uma série dedicada à arte e ciência de nomear coisas no OpenTelemetry. Vamos começar com os trechos (spans), os blocos de construção de um rastro (trace) distribuído, e logo no início apresentaremos a você o ponto mais importante: como nomear os trechos que descrevem sua lógica de negócio exclusiva.

Como Contribuir para o OpenTelemetry

Thu, 04 Jun 2026 11:53:28 -0400

Você pode ter ouvido falar sobre o OpenTelemetry, o achou interessante e quer se envolver, mas o caminho para a contribuição não está imediatamente claro. Talvez você comece a enviar mensagens para as pessoas pedindo para ser atribuído a issues, ou apenas diga “Estou aqui para ajudar, é só me falar”, mas nunca recebe uma resposta. Então, como você pode realmente começar a contribuir para o OpenTelemetry?

O código aberto prospera com a comunidade, apoio mútuo e desenvolvimento colaborativo de tecnologia inovadora. No entanto, também apresenta desafios, especialmente se você é novo neste ecossistema.

A jornada da configuração declarativa: Por que levou 5 anos para ignorar os endpoints de verificação de integridade no rastreamento

Thu, 04 Jun 2026 11:53:28 -0400

Uma das solicitações de recursos mais persistentes e populares para o OpenTelemetry Java nos últimos anos tem sido a capacidade de eliminar com eficiência trechos para endpoints de verificação de integridade – ou quaisquer outros endpoints que sejam de baixo valor ou custosos. Essa questão foi levantada pela primeira vez em agosto de 2020, mas uma solução abrangente permaneceu indefinida por um tempo surpreendentemente longo. Por que demoramos cinco anos para resolver esse problema aparentemente simples? A resposta está nos princípios fundamentais do sistema de configuração do OpenTelemetry e na jornada em direção a uma abordagem mais robusta e flexível: a configuração declarativa.

O OpenTelemetry é um Projeto Graduado da CNCF

Thu, 21 May 2026 15:19:55 -0300

Hoje, a Cloud Native Computing Foundation (CNCF) anunciou que o OpenTelemetry se graduou.

A graduação é um marco importante para o projeto e reflete a força da comunidade e do ecossistema OpenTelemetry. Desde a fusão do OpenTracing e do OpenCensus, milhares de colaboradores, mantenedores, usuários finais e organizações ajudaram a moldar o OpenTelemetry em um framework de observabilidade aberto e neutro em relação a fornecedores, utilizado em toda a indústria.

Este marco pertence à comunidade.

Como Nomear Suas Métricas

Mon, 15 Sep 2025 06:28:53 -0300

Métricas são a espinha dorsal quantitativa da observabilidade — os números que nos dizem como nossos sistemas estão se comportando. Esta é a terceira publicação em nossa série sobre nomenclatura do OpenTelemetry, onde já exploramos como nomear trechos e como enriquecê-los com atributos significativos. Agora, vamos abordar a arte de nomear as medições que realmente importam.

Ao contrário dos trechos (spans) que contam histórias sobre o que aconteceu, as métricas nos falam sobre quantidades: quais, quantos e quão rápido. Mas aqui está a questão — nomeá-las bem é tão crucial quanto nomear trechos, e os princípios que aprendemos também se aplicam aqui. O “quem” ainda pertence aos atributos, não aos nomes.

Como Nomear seus Atributos de Span

Fri, 29 Aug 2025 19:34:03 -0300

Sejam bem-vindos à segunda parte da nossa série sobre boas práticas de nomenclatura no OpenTelemetry. Em nossa publicação anterior, exploramos como nomear trechos utilizando o padrão {verbo} {objeto}. Hoje, vamos mergulhar nos atributos de trecho (span) — os dados contextuais ricos que transformam seus rastros (traces) de simples registros de operação em poderosas ferramentas de depuração (debugging) e análise.

Este guia é direcionado para desenvolvedores que estão:

Instrumentando suas próprias aplicações com trechos e atributos personalizados
Enriquecendo a telemetria além do que a auto-instrumentação fornece
Criando bibliotecas que outros irão instrumentar

As decisões de nomenclatura que você tomar para os atributos impactam diretamente a usabilidade e manutenibilidade dos seus dados de observabilidade. Vamos acertar isso desde o início.

Site do OpenTelemetry com suporte a múltiplos idiomas!

Fri, 31 Jan 2025 16:02:13 -0300

É com grande prazer que anunciamos que o site do OpenTelemetry está disponível em múltiplos idiomas! Os times de localização já começaram a traduzir páginas do site para Chinês, Japonês, Português e Espanhol.

O projeto OpenTelemetry cresceu para incluir pessoas que contribuem e o utilizam em todas as partes do mundo. Disponibilizar o site em múltiplos idiomas é um passo importante para garantir que todos, independente da sua língua nativa, consigam contribuir para o projeto. Nós também estamos empolgados que essa iniciativa permite que usuários acessem a documentações em diversas linguagens, facilitando o aprendizado e o entendimento do OpenTelemetry.