A Langfuse publicou a versão v4.25.0 em 31 de agosto às 10:42:43 UTC. Ela introduz um limite de retenção sobre o quanto uma consulta pode retroceder: 30 dias na camada Cloud Hobby e 90 dias no Core. O limite é aplicado em cerca de uma dúzia de endpoints REST e seis ferramentas MCP. O pull request é classificado como bug fix, non-breaking.
Por que essa classificação está errada à primeira vista
Uma API que ontem retornava 180 dias de traces e hoje retorna 30 mudou seu contrato. Nada no pedido é inválido; a resposta simplesmente é truncada. Qualquer dashboard, relatório agendado ou job de avaliação que calcula um número trimestre a trimestre continua funcionando, continua retornando 200 e passa a produzir uma resposta diferente. Uma mudança que altera resultados sem alterar códigos de status é o tipo mais caro de classificar como non-breaking, porque nada a jusante consegue detectá-la.
O sinal que foi calculado e descartado
A implementação sabe quando truncou uma consulta — ela calcula uma sinalização indicando que o intervalo foi limitado. Essa sinalização não é exposta. Ela não vira um cabeçalho de resposta, não vira um campo no payload e não vira um aviso. O servidor, portanto, tem a informação exata de que o cliente precisa para saber que seus dados estão incompletos e a descarta antes de responder. Adicionar um cabeçalho teria transformado um truncamento silencioso em algo detectável, com custo praticamente nulo.
O que a leitura comum interpreta errado
Limites de retenção em planos gratuitos são comuns e defensáveis; um serviço hospedado tem direito de limitar o que armazena e serve. A questão não é que a Langfuse introduziu um limite. É como o limite é entregue: como um truncamento silencioso e não anunciado, rotulado como non-breaking, em endpoints cujos consumidores são automatizados. Lido como "o plano gratuito passa a ter retenção de 30 dias", isso é uma nota de preço. Lido como "uma dúzia de endpoints começou discretamente a devolver menos dados", é uma falha de observabilidade em um produto de observabilidade.
O que verificar
Qualquer métrica baseada em Langfuse que abranja mais de 30 dias no Hobby ou 90 no Core deve ser recalculada após a atualização. Não haverá erro. Ela apenas ficará menor, e a diferença parecerá uma queda no tráfego, não uma queda na visibilidade.