Monitoramento de Browser e do agente Python

Com o agente Python, você pode adicionar monitoramento de browser às suas páginas da web de forma automática ou manual. Para ativar na interface do usuário, siga os procedimentos para instalar o agente browser. Em seguida, siga os procedimentos nesta seção para configurar o agente Python.

Para usar o agente browser com seu agente Python, certifique-se de ter a versão mais recente. Para obter mais informações, consulte as instruções de instalação do agente.

Suporte para instrumentação automática

O agente Python suporta apenas instrumentação automática para aplicativos WSGI hospedados diretamente em um servidor WSGI dedicado com uma interface WSGI nativa e onde o aplicativo WSGI retorna a resposta da página HTML por meio de um iterável/gerador.

A instrumentação automática requer um servidor WSGI dedicado.

Servidores WSGI como Apache/mod_wsgi, gunicorn e uWSGI são suportados.
O uso de adaptadores WSGI sobre a estrutura Tornado ou Twisted não é suportado.

O agente Python não oferece suporte à inserção de instrumentação ao usar o retorno de chamada write() retornado da função WSGI start_response() para gravar de volta a resposta da página HTML. Para obter mais informações sobre requisitos para instrumentação automática, consulte resolução de problemas de instrumentação de browser em Python.

Use instrumentação automática

O agente Python pode adicionar automaticamente o agente JavaScript do browser a qualquer resposta da página HTML. Para o aplicativo WSGI, o agente utiliza um middleware WSGI instalado no pipeline de solicitação. Como o middleware está no nível WSGI, a instrumentação automática deve funcionar para qualquer aplicativo WSGI, independentemente da framework da web que você está usando, incluindo a estrutura da web Python popular, como Django, Flask e Pyramid.

Desabilitar instrumentação para páginas específicas

Se você quiser usar a instrumentação automática, mas tiver uma resposta de página HTML que não deseja instrumentada, poderá desabilitar a instrumentação para essa solicitação. Adicione esta chamada de API do agente Python ao código desse manipulador de solicitação:

newrelic.agent.disable_browser_autorum()

Se você estiver usando um servidor WSGI que permite configuração por solicitação, como Apache/mod_wsgi, também poderá desativar a instrumentação automática definindo a chave newrelic.disable_browser_autorum para essa solicitação no dicionário de ambiente WSGI transmitido para seu aplicativo de monitor.

Por exemplo, se estiver usando Apache/mod_wsgi, você pode desativar a instrumentação automática filtrando a URL:

<Location /login>
SetEnv newrelic.disable_browser_autorum true
</Location>

Habilitar manualmente o monitoramento do browser para páginas específicas

Você pode adicionar manualmente a instrumentação do browser a páginas específicas. Isso é útil, por exemplo, se a instrumentação automática não for possível para seu aplicativo, se você usar uma política de segurança de conteúdo não autorizada ou se quiser coletar dados do browser apenas para páginas específicas.

As chamadas neste procedimento devem ser feitas na solicitação every que você deseja monitor. Você cannot chama essas funções uma vez no escopo global e armazena o resultado em cache para uso posterior.

Importante

A partir da versão 9.4.0+ do Python agente, a API get_browser_timing_footer está obsoleta e sempre retorna uma string vazia. A funcionalidade anterior de get_browser_timing_footer() agora está incluída em get_browser_timing_header().

Em versões mais antigas do agente, o rodapé é necessário para carregar o agente browser.

Desative a instrumentação automática: no arquivo newrelic.ini , defina browser_monitoring.auto_instrument como false.
Reinicie seu aplicativo.

Coloque essas chamadas no gerenciador de solicitações da página every que você deseja monitor:

import newrelic.agent

header = newrelic.agent.get_browser_timing_header()
# The footer is required on Python Agent versions 9.3.0 and below.
footer = newrelic.agent.get_browser_timing_footer()

Passe as variáveis header e possivelmente footer para a resposta HTML.
Na página correspondente, insira a variável header no elemento <head> . Coloque a variável header após qualquer propriedade charset ou qualquer meta tag para http-equiv com um valor de X-UA-Compatible.
Se necessário, insira a variável footer antes do final do elemento <body> .

Aguarde alguns minutos e verifique os dados do monitoramento do seu browser. Se nenhum dado aparecer após esperar alguns minutos, consulte resolução de problemas de instrumentação de browser em Python.

Suporte CSP Nonce

O uso do CSP Nonce em nossa instrumentação de browser é compatível com a versão 9.4.0+ do agente Python. 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.

Desative a instrumentação automática: no arquivo newrelic.ini , defina browser_monitoring.auto_instrument como false.
Reinicie seu aplicativo.
Coloque essas chamadas no gerenciador de solicitações da página every que você deseja monitor, substituindo "NONCE" pelo seu CSP nonce:
```
import newrelic.agent

header = newrelic.agent.get_browser_timing_header("NONCE")
```
Passe a variável header para a resposta HTML.
Na página correspondente, insira a variável header no elemento <head> . Coloque a variável header após qualquer propriedade charset ou qualquer meta tag para http-equiv com um valor de X-UA-Compatible.