O agente Ruby automaticamente instrumento rack middlewares. Se você não estiver familiarizado com os fundamentos dos middlewares Rack, revise os recursos vinculados pelo guia Rails on Rack. Além disso, o agente Ruby fornece alguns recursos via middlewares Rack:
- Rastreamento distribuído
- instrumentação automática para
A New Relic instala automaticamente esses middlewares para Rails e Sinatra.
Instrumentação de rack
As duas maneiras mais comuns de configurar middlewares Rack são a API Rack::Builder (geralmente de config.ru) e a configuração stack de middleware Rails:
Visualizando dados de middleware
Você pode visualizar dados de middleware no APM.
Desativando a instrumentação do Rack
Se não quiser instrumentar middlewares de Rack, você pode desativar a instrumentação de middleware de Rack com a configuração disable_middleware_instrumentation . Você também pode ignorar transações específicas.
Instalando manualmente os middlewares do agente Ruby
Em versões do agente anteriores à 10.0.0, a implementação do agente Ruby do recurso de rastreamento multiaplicativo da New Relic usa a instrumentação de middleware do Rack para ler e gravar cabeçalhos HTTP que são necessários para passar informações entre os aplicativos monitorados. Se você estiver usando uma dessas versões com o Sinatra, tiver desativado a instrumentação de middleware conforme descrito acima e quiser usar o rastreamento multiaplicativo, deverá adicionar manualmente o middleware NewRelic::Rack::AgentHooks à sua stack de middleware.
Importante
O rastreamento multiaplicativo foi removido na versão 10.0.0 em favor do distributed tracing. O distributed tracing é configurado automaticamente para todos os aplicativos baseados em rack sem a necessidade de um middleware adicional.
Instrumentação manual de rack
Versões anteriores do agente Ruby suportavam middlewares Rack instrumentados manualmente por meio do módulo NewRelic::Agent::Instrumentation::Rack . Esta instrumentação foi removida e não há garantia de funcionamento no agente Ruby versão 4.0.0 ou superior. Esta forma de instrumentação manual é desnecessária na instrumentação automática de middleware. Recomendamos que você remova referências a este módulo do seu código após atualizar para 3.9.0 ou superior.


