Grafana Cloud lança trace linkage para ligar traces da aplicação às queries do banco de dados

O Grafana Cloud tornou o trace linkage geralmente disponível no Database Observability. A ideia é sair de um span de banco dentro de um trace e chegar direto aos detalhes da query, sem cruzar timestamps ou texto de query na mão. O link aparece sobre o texto da query no span. Dali, o app leva às amostras de execução, ao histórico de performance, ao schema e ao explain plan.

O Grafana Cloud Traces, baseado em Tempo, mantém os atributos do span. O trace linkage usa o texto da query, o sistema de banco e o nome do banco para fazer a ligação. Há suporte às convenções estáveis do OpenTelemetry, como db.query.text, e também ao equivalente legado db.statement, então instrumentação existente continua funcionando.

Há dois níveis de correspondência. O primeiro é por texto da query: o Grafana compensa diferenças de formatação, comentários, valores literais mascarados ou não e placeholders de parâmetros, além da normalização que cada engine aplica ao texto coletado pelo Alloy. Esse modo não exige mudança na aplicação. O segundo usa o sqlcommenter, projeto open source doado à comunidade OpenTelemetry, que injeta o trace ID e o span ID num comentário ao fim do SQL. O Alloy extrai o traceparent e o inclui nos logs de amostra de query, o que permite apontar uma execução específica.

Há limites, e a própria fonte os admite. O sqlcommenter não garante que o Alloy capturou aquela execução, pois isso depende de a query ser curta e da frequência de polling. Nem todo engine é suportado, e o recurso pode trazer desvantagens para os caches do banco. Mesmo com sqlcommenter, o match exato continua sendo best-effort.

Para quem opera plataforma, a leitura é prática: o caminho de "a requisição ficou lenta" até "esta query, com este plano" encurta, e isso reduz tempo de diagnóstico em incidente. Como o match por texto funciona sem mexer no código, dá para começar sem um ciclo de deploy. Já ligar o sqlcommenter pede um teste, principalmente por causa do possível impacto no cache do banco em produção.