• EnglishEspañol日本語한국어Português
  • EntrarComeçar agora

Esta tradução de máquina é fornecida para sua comodidade.

In the event of any inconsistency between the English version and the translated version, the English versionwill take priority. Please visit this page for more information.

Criar um problema

Monitoramento de Browser e agente Ruby

Com o agente Ruby , você pode injetar o agente de monitoramento do Browser em suas páginas da web de forma automática ou manual. Por padrão, se o agente Ruby detectar Javascript, ele instalará automaticamente .

Caso prefira adicionar o monitoramento de browser manualmente ou queira conhecer as opções de instalação do agente browser, consulte o guia de instalação do agente browser.

Requisitos

A instrumentação automática do browser está disponível para todas as versões suportadas do agente Ruby. Para garantir que seu ambiente esteja pronto para instrumentação automática, revise o guia de compatibilidade e requisitos do monitoramento de browser.

Use instrumentação automática

A configuração padrão do New Relic permite o monitoramento automático da instrumentação do browser:

browser_monitoring:
auto_instrument: true

Esta é a forma mais simples de monitor o usuário final. O agente Ruby examina cada página do seu aplicativo quando carrega e injeta automaticamente o JavaScript do browser no cabeçalho. A instrumentação automática funciona para ambientes que usam Rack. Por motivos de desempenho, o agente verifica apenas as primeiras 50 mil linhas da resposta do seu aplicativo em busca do ponto de instrumentação do cabeçalho. Nos casos em que uma meta 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 procura uma meta tag X-UA-Compatible e insere o JavaScript diretamente depois dela. Se a instrumentação automática não conseguir encontrar uma meta tag X-UA-Compatible , ela a inserirá após a tag head de abertura. Caso contrário, ele será inserido 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á.

A instrumentação automática não ocorrerá em páginas com anexo 'Content-Type' ou quando detectar solicitações de streaming.

Se a instrumentação automática não conseguir instrumentar corretamente as páginas do seu aplicativo, você precisará instrumentar manualmente usando a API do agente.

Instrumento manualmente via API do agente

Você pode configurar o monitoramento final do usuário manualmente incluindo script apropriado em suas páginas. Use a API do agente New Relic Ruby para gerar o script. A API injeta esse script 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

Se a política de segurança de conteúdo estiver definida como ‘unsafe-inline’, você poderá instrumentar automaticamente o browser do agente. Se você quiser usar um CSP Nonce, pode ser necessário adicionar alguma configuração manual.

Rails CSP Nonce

As versões 5.2+ do Rails incluem um recurso para definir um nonce CSP usando uma API. Nas versões 9.10.0+ do agente Ruby , o nonce Rails CSP será automaticamente detectado e aplicado ao script de injeção do agente de browser.

Você pode desativar esse recurso atualizando seu newrelic.yml para o seguinte:

browser_monitoring:
content_security_policy_nonce: false

Ou defina a variável de ambiente NEW_RELIC_BROWSER_MONITORING_CONTENT_SECURITY_POLICY=false.

Chamada de API

Você pode transmitir um CSP nonce para a API NewRelic::Agent.browser_timing_header nas versões 7.1.0+ do agente Ruby.

Ao passar um nonce para este método, você deve desabilitar o monitoramento de instrumentação automática do Browser e utilizar a instrumentação manual via API do agente.

Atualize seu newrelic.yml para:

browser_monitoring:
auto_instrument: false

Ou defina a variável de ambiente NEW_RELIC_BROWSER_MONITORING_AUTO_INSTRUMENT=false.

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 os dados do browser não forem informados, visualize o código-fonte HTML e confirme se dois blocos de script semelhantes aos seguintes estão no cabeçalho HTML:

<script type="text/javascript">
window.NREUM||(NREUM={});...
</script>

Se estes não estiverem presentes, verifique:

  • As configurações de instrumentação automática
  • A colocação de instrumentação manual em seus arquivos de modelo
  • A maneira como você está aplicando um nonce

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.

browser_monitoring:
auto_instrument: 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 é afetada por esta chamada.

Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.