Com o agente Ruby, você pode adicionar instrumentação de agente de monitoramento de browser às suas páginas da web de forma automática ou manual. Para habilitar na interface, siga os procedimentos para instalar o agente browser. Em seguida, siga os procedimentos nesta seção para configurar o agente Ruby.
Requisitos
A instrumentação automática do browser é suportada pelas versões mais recentes do Rails:
- Agente New Relic Ruby (versão 3.0.1 ou superior)
- Para instrumentação automática: Rails 2.3 ou superior
- Para instrumentação manual: Rails 2.0 a 2.2
Use instrumentação automática
A instrumentação automática funciona com Rack e requer Rails 2.3 ou superior.
Configure o agente para páginas de instrumentos automaticamente com script de monitoramento do usuário final, adicionando ou editando o seguinte sinalizador em newrelic.yml.
browser_monitoring: auto_instrument: trueEsta é a forma mais simples de monitor o usuário final. O agente Ruby examina cada página do seu aplicativo e injeta automaticamente o JavaScript do browser no cabeçalho. A instrumentação automática funciona para ambientes que suportam Rack. Por motivos de desempenho, o agente verifica apenas os primeiros 50k da resposta do seu aplicativo em busca do ponto de instrumentação do cabeçalho. Nos casos em que uma tag X-UA-Compatible estiver presente e a tag <head> tiver mais de 50k, a instrumentação automática falhará normalmente.
A instrumentação automática procurará uma meta tag X-UA-Compatible e inserirá o JavaScript diretamente depois dela. Se a instrumentação automática não conseguir encontrar uma meta tag X-UA-Compatible , ela será inserida após a tag head de abertura e, caso contrário, será inserida após a tag body de abertura. Se alguma dessas tags estiver envolvida em condicionais ou comentários, a instrumentação automática provavelmente falhará.
Se a instrumentação automática não instrumentar corretamente as páginas do seu aplicativo, você deverá instrumentar manualmente por meio da API do agente.
Instrumento manualmente via API do agente
Se você estiver usando Rails 2.1 a 2.2 ou não puder usar a instrumentação automática, você ainda poderá configurar o monitoramento do usuário final manualmente, incluindo o script apropriado em suas páginas. Utilize a API do agente New Relic Ruby para gerar o script a ser inserido em suas páginas.
Por exemplo, para modificar o modelo do seu aplicativo para chamar o agente, use:
<head> <%= ::NewRelic::Agent.browser_timing_header rescue "" %> # existing template code ...</head>Suporte CSP Nonce
O uso do CSP Nonce em nossa instrumentação de browser é compatível com a versão 7.1.0+ do agente Ruby. Para utilizar um nonce com a instrumentação do browser, você deve desabilitar o monitoramento de instrumentação automática do browser e utilizar a instrumentação manual via API do agente.
Agora você pode passar um nonce como argumento para o método API para permitir que o agente insira o nonce na instrumentação do browser. Por exemplo, NewRelic::Agent.browser_timing_header(nonce).
Resolução de problemas
Se você não vir nenhum dado do browser sendo relatado, visualize o código-fonte HTML e confirme dois blocos de script semelhantes a este em seu cabeçalho HTML:
<script type="text/javascript"> window.NREUM||(NREUM={});...</script>Se não estiverem presentes, verifique as configurações de instrumentação automática ou o posicionamento da instrumentação manual em seus arquivos de modelo.
Nas versões do agente Ruby anteriores a 3.7.0, <%=::NewRelic::Agent.browser_timing_footer rescue "" %> também precisava ser chamado o mais próximo possível do final do documento. Com 3.7.0, todo o script necessário é incluído por browser_timing_header. browser_timing_footer retorna uma string vazia para compatibilidade.
Desativar instrumentação automática
O valor padrão de auto-instrument é true (mesmo quando não especificado). Para desativar a instrumentação automática, defina este sinalizador como false.
Para desativar a instrumentação automática apenas para determinados controladores ou ações do controlador, use newrelic_ignore_enduser. A instrumentação do lado do servidor não será afetada por esta chamada.