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

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

Caso haja alguma divergência entre a versão em inglês e a traduzida, a versão em inglês prevalece. Acesse esta página para mais informações.

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.