Resumo

  • No relato dos fundadores de maio de 2019, o maior problema era haver dois projetos semelhantes de instrumentação sem cooperação suficiente. A fusão priorizou pontes com ambos e propôs tornar os antigos projetos somente leitura até o fim do ano.
  • Em maio de 2023, o OpenTelemetry declarou paridade com OpenCensus em sete linguagens e planejou arquivar a maior parte de seus repositórios em 31 de julho. opencensus-python ficou como exceção explícita.

Duas iniciativas cobravam pelo mesmo serviço

Para entender um sistema distribuído, componentes e bibliotecas precisam registrar caminhos de requisições e métricas que possam ser reunidos depois. Não adianta instrumentar apenas o serviço principal se uma dependência importante fala outra língua. OpenTracing e OpenCensus procuravam dividir esse custo entre muitos usuários. Fizeram escolhas arquitetônicas diferentes, mas buscavam o tempo dos mesmos mantenedores de bibliotecas e dos mesmos operadores.

No texto de 2019 assinado por Ben Sigelman e Morgan McLean, a crítica veio de dentro: o maior problema de cada iniciativa era existirem duas. Quem mantinha uma biblioteca podia integrar uma delas, tentar sustentar as duas ou aguardar a definição. O usuário final acabava herdando essa loteria de integrações. Projetos criados para poupar trabalho compartilhado estavam gastando trabalho na própria duplicação.

A fusão criou uma casa comum no ambiente inicial da CNCF. Representantes de Google, LightStep, Microsoft e Uber participaram dos primeiros comitês de governança e técnica. Ali se decidiria o futuro das especificações e das contribuições. Mas nenhum comitê altera automaticamente as versões já instaladas. Os fundadores chamaram OpenTelemetry de próxima versão principal de ambos os predecessores. É uma descrição reveladora: uma versão nova precisa de caminho de atualização para quem não pode simplesmente desligar a antiga.

A ponte fazia parte do acordo

Compatibilidade retroativa por meio de pontes de software foi prioridade desde o anúncio. A ideia era deixar a instrumentação existente funcionar enquanto a aplicação passava a enviar dados pelo novo sistema. Os líderes também queriam reduzir o período de desenvolvimento simultâneo de três projetos e planejaram colocar OpenTracing e OpenCensus em modo somente leitura antes do fim de 2019. Era uma meta publicada naquele momento, não uma afirmação de que todos os usuários fizeram a troca até dezembro.

Há relógios diferentes. Um repositório pode deixar de ganhar funções enquanto aplicações continuam carregando suas bibliotecas todos os dias. Equipes precisam atualizar dependências, testar exportadores e conferir se os dados ainda contam a mesma história. A ponte não foi um remendo inventado depois do problema: constava do plano porque os autores sabiam que a fusão administrativa e a migração do código em execução não coincidiriam.

Quando a CNCF anunciou a incubação em agosto de 2021, o OpenTelemetry já tinha APIs e SDKs em onze linguagens e suporte a rastros e métricas em seu protocolo. O mesmo comunicado ainda apontava o arquivamento formal de OpenTracing e uma maior descontinuação de ambos os predecessores como trabalho à frente. Dois anos após a fusão, a saída do legado continuava no futuro do documento oficial.

O plano de 2023 tinha uma ressalva na margem

O aviso de maio de 2023 do próprio OpenTelemetry enumerou o que já havia e o que faltava. O projeto declarou paridade funcional com OpenCensus em C++, .NET, Go, Java, JavaScript, PHP e Python. Planejou arquivar quase todos os repositórios GitHub de OpenCensus em 31 de julho. Deixou opencensus-python fora da regra geral porque algumas partes ainda eram recomendadas para produção. A exceção era pequena no organograma e grande para quem dependia daquele código.

O comunicado indicava pontes para Go, Java, JavaScript e Python; algumas adaptações ainda estavam por ser lançadas. O percurso proposto era usar essas pontes para que a instrumentação antiga enviasse dados por exportadores OpenTelemetry, depois retirar gradualmente as bibliotecas anteriores. O projeto advertiu que a migração se parecia com uma atualização principal e podia alterar a telemetria. Receber algum dado não garante que nomes, atributos e comparações históricas continuem intactos.

A data de arquivamento delimitava a manutenção. Após 31 de julho, segundo o aviso, o OpenCensus arquivado não receberia novos recursos nem correções de segurança, embora código e pacotes continuassem disponíveis. Um serviço poderia continuar funcionando com uma dependência que já não teria a mesma equipe para consertá-la. A facilidade de download não pagaria essa conta.

A mesa de decisão andou antes das aplicações

Ao juntar as iniciativas em 2019, os líderes encerraram a disputa sobre onde construir a instrumentação comum. Isso direcionou o trabalho futuro. A migração de serviços existentes dependia de versões, paridade, qualidade das pontes e decisões de inúmeros mantenedores. O intervalo de quatro anos até o plano de saída do OpenCensus mostra essa distância. Ele não prova que a meta de modo somente leitura fracassou: somente leitura e arquivamento são etapas diferentes. Mostra que, em 2023, ainda era preciso dizer exatamente quais cabos poderiam ser retirados e qual exceção ficaria. A placa da oficina mudou primeiro; a fiação veio depois.