• /
  • EnglishEspañol日本語한국어Português
  • Inicia sesiónComenzar ahora

Te ofrecemos esta traducción automática para facilitar la lectura.

En caso de que haya discrepancias entre la versión en inglés y la versión traducida, se entiende que prevalece la versión en inglés. Visita esta página para obtener más información.

Crea una propuesta

Compatibilidad y requisitos para el monitoreo del navegador.

Nuestro incluye estrictas medidas de seguridad para proporcionar un producto sólido e independiente con monitoreo de características del navegador. Antes de instalar el agente del navegador, asegúrese de que su sistema cumpla con estos requisitos.

Requerimientos básicos

Para reportar datos a New Relic, su aplicación debe cumplir dos requisitos básicos:

  1. El tráfico a la aplicación debe provenir de clientes capaces de cargar y ejecutar código JavaScript browser .
  2. Los clientes que accedan a la aplicación deben poder enviar datos a New Relic a través de solicitudes HTTP. Se requiere HTTPS para el monitoreo más avanzado de características del navegador.

La mayoría de las aplicaciones browser típicas cumplen con estos requisitos, pero algunas aplicaciones browser en entornos restringidos pueden tener dificultades para informar datos a New Relic. Por ejemplo:

  • Aplicación móvil híbrida
  • Aplicación instalada en hardware inusual, como terminales de punto de venta o electrodomésticos de consumo.

Para obtener más información, revise la documentación de instrumentación para el monitoreo del navegador y luego verifique el acceso a la red del usuario final.

Navegador compatible

El agente del navegador soporta oficialmente las siguientes versiones browser :

La instrumentación y características específicas pueden ser compatibles con otros navegadores o versiones.

Exceptions

Comments

Tiempos de pintura

Los atributos firstPaint y firstContentfulPaint en BrowserInteraction, PageView y PageViewTiming eventos solo son compatibles con:

  • Chrome 60 o superior para escritorio y dispositivos móviles (vista web de Android y Chrome para Android)
  • Opera 47 o superior para escritorio
  • Opera 44 o superior para móviles Android
  • Samsung Internet para móviles

AJAX

La característica de temporización AJAX no está disponible con:

  • Chrome para iPhone y iPad
  • Es decir, 7 y 8

PageAction evento

PageAction incluso requiere un browser que sea totalmente compatible con dominios cruzados XMLHttpRequests. Las versiones 9 y anteriores de Internet Explorer no pueden registrar el evento PageAction . Obtenga más información sobre cómo consultar sus datos.

Rastreo de sesión

El rastreo de sesión se informa únicamente desde navegadores que admiten la especificación de sincronización de recursos.

SHA-256

New Relic solo puede monitor navegadores que sean compatibles con SHA-256.

Importante

Cuando utiliza el monitoreo del navegador con cookies, las cookies de New Relic son cookies de terceros en su sitio y pueden no almacenarse ni funcionar en ciertos navegadores web utilizados por sus visitantes. Consulte los sitios web del browser correspondiente para obtener detalles sobre su compatibilidad con cookies de terceros.

Agente APM

Una forma de implementar el monitoreo del navegador de una aplicación es utilizando uno de nuestros agentes APM.

Si está implementando browser para una aplicación que APM ya está monitoreando, asegúrese de que la versión de su agente APM admita el monitoreo del navegador:

  • Go: Versión 2.5.0 o superior
  • Java: Versión 3.4.0 o mas alto
  • .NET: Versión 2.20.25.0 o superior
  • Node.js: Versión 1.4.0 o superior
  • PHP: Versión 4.4.5.35 o superior
  • Python: Versión 2.10.1.9 o mas alto
  • Ruby: Versión 3.7.0.177 o superior

Marco soportado y biblioteca

El agente del navegador recopila datos en sitios que utilizan muchos marcos de interfaz y bibliotecas populares. El agente del navegador monitorea objetos y métodos JavaScript de bajo nivel, que pueden ser empaquetados o modificados por otra biblioteca y marco. Como resultado, el nivel de detalle recopilado puede variar de un framework a otro y pueden ocurrir conflictos con cualquier biblioteca que modifique la mecánica nativa de JavaScript.

Excepciones de compatibilidad

Comentarios

Zone.js

Si está utilizando AngularJS y desea utilizar nuestra característica de monitoreo SPA, tenga en cuenta que las versiones de Zone.js 0.6.18 a 0.6.24 no son compatibles con el navegador. En todos los casos, el agente del navegador must se cargará antes que Zone.js para evitar errores.

Cypress.io

Browser no puede instrumentar correctamente los métodos open y send de solicitudes cuando se ejecutan pruebas en Cypress. Esto provocará que se arroje el siguiente error:

Cannot set property 'status' of undefined

Esto solo afectará a los clientes que ejecuten pruebas con el agente del navegador presente en su código. La aplicación de producción no debería verse afectada.

html2pdf.js

Esta biblioteca no es compatible con nuestro agente Pro+SPA debido a la forma en que esta biblioteca envuelve las promesas. Si está utilizando esta biblioteca, le recomendamos seleccionar el tipo de agente Pro.

MooHerramientas

El agente del navegador no es compatible con versiones de MooTools anteriores a 1.6.0 ni con ninguna versión que incluya la capa de compatibilidad de mootools. Si migrar desde MooTools no es una opción, recomendamos usar la versión 1.6.0-nocompat.

Monitoreo de aplicación de página única (SPA)

Para utilizar la característica relacionada con el monitoreo de aplicaciones de página única (SPA), su aplicación debe cumplir con estos requisitos.

SPA: versión del agente del navegador

El monitoreo de SPA requiere una versión específica de SPA del fragmento del navegador, disponible para la versión 885 o superior del agente del navegador. Esta versión del agente está habilitada de forma predeterminada.

SPA: tipos browser

El monitoreo de SPA requiere la API del navegadoraddEventListener y la API de sincronización de navegación. Ambas API están disponibles en todos los navegadores modernos, incluidos Google Chrome, Mozilla Firefox, Apple Safari y Microsoft Internet Explorer (IE) versiones 9 o superiores.

SPA: requisitos framework

Debido a que la instrumentación SPA funciona envolviendo API browser de bajo nivel, es independiente framework . La instrumentación SPA es compatible con la mayoría de los marcos SPA, como Angular, Backbone, Ember y React. También puede instrumentar solicitudes realizadas mediante JSONP.

A continuación se detallan problemas de compatibilidad conocidos:

  • Si su aplicación usa AngularJS y desea utilizar las capacidades de monitoreo de SPA del navegador, las versiones de Zone.js 0.6.18-0.6.24 no son compatibles con el agente SPA.
  • La biblioteca html2pdf.js no es compatible con el agente SPA.
  • Las versiones angulares 12 a 14 contienen una limitación en cuanto al tamaño de los elementos de script individuales contenidos en la fuente HTML del índice. Consulte esta página de resolución de problemas para obtener más información.
  • Next.JS tiene una incompatibilidad conocida desde la versión 13.3.2-canary.2 donde el uso del enrutador de la aplicación puede provocar que los enlaces de la página no funcionen. Consulte esta página de resolución de problemas para obtener más información.

SPA: Seguridad para fragmentos de hash

Recopilamos y guardamos fragmentos de hash de las URL de cambio de ruta. Si utiliza hash para pasar datos privados o confidenciales, esos datos pueden ser visibles para el usuario de su cuenta New Relic. Siga las pautas de seguridad del navegador con la recopilación y generación de informes de datos.

Consideraciones sobre la política de seguridad de contenido (CSP)

Para obtener un rendimiento métrico preciso del navegador, nuestro monitoreo de navegador requiere el uso de un pequeño fragmento de JavaScript en línea. New Relic revisa cuidadosamente el JavaScript en línea para evitar secuencias de comandos entre sitios (XSS) y otras vulnerabilidades potenciales.

El nivel 2 de la política de seguridad de contenido agrega restricciones a los tipos de JavaScript permitidos, como el script en línea. También limita qué dominio puede cargar scripts durante la carga de la página.

Importante

Si su sitio web no permite la ejecución de ningún JavaScript alojado por terceros, debe solicitar una excepción de CSP a través de los procedimientos estándar de su organización para poder instalar el agente de monitoreo de navegador.

Al solicitar una excepción de CSP, siga los procedimientos estándar de su organización para comunicarse con su equipo web o de seguridad. Las excepciones de CSP para su caso de uso dependen de la versión del agente del navegador que esté ejecutando actualmente. Siempre recomendamos actualizar a la última versión del agente del navegador.

Puede agregar todas estas excepciones a la directiva alternativa default-src (en lugar de script-src y connect-src). El agente del navegador requiere las siguientes excepciones de CSP:

Excepción CSP

Comentarios

unsafe-inline

Agréguelo a la directiva script-src o a la directiva alternativa default-src . Esto es necesario porque el agente se instala incluyendo un script en línea.

https://js-agent.newrelic.com

Agréguelo a la directiva script-src o a la directiva alternativa default-src . Aquí es donde se alojan los archivos de script adicionales que requiere el agente.

*.nr-data.net

El agente intenta enviar carga a subdominios de nr-data.net, que pueden variar según el tipo de cuenta. Si *.nr-data.net es demasiado inclusivo para sus requisitos, será necesario agregar cada subdominio individual:

  • Cuentas basadas en EE. UU.:

    • https://bam.nr-data.net
    • https://bam-cell.nr-data.net
  • Cuentas basadas en la UE:

    • https://bam.eu01.nr-data.net
  • Cuentas compatibles con FedRAMP:

    • https://gov-bam.nr-data.net
  • Agréguelo a la directiva connect-src o a la directiva alternativa default-src . La directiva connect-src afecta las URL que el script puede llamar (por ejemplo, usando la interfaz XMLHttpRequest). Si tiene restricciones de CSP específicamente en torno a esta directiva, agregue esta URL como excepción.

nonce apoyo

A partir de agente del browser 1.247.0, el agente respetará un atributo nonce adjunto al script en línea al cargar fragmentos de código adicionales. Si su sitio o infraestructura es capaz de inyectar un atributo nonce en el script del agente del navegador en línea, solo necesitará solicitar una excepción CSP para connect-src.

Importante

Nuestro soporte integrado nonce no se aplica al uso del paquete npm agente del navegador. Con el paquete npm, el agente pasa a formar parte del código de su sitio o aplicación. Cualquier fragmento adicional cargado se realizará a través del código de su aplicación y usted tiene control total sobre cuándo y si se usa un atributo nonce .

Algunos agentes APM capaces de inyectar el agente del navegador también admiten agregar un atributo nonce al script inyectado.

Agente APM

Versión mínima

Nota de soporte

Go

2.5.0

Admite la inyección del fragmento de JavaScript a través de la API Transaction.BrowserTimingHeader . Deberá escribir código adicional para modificar el elemento del script y agregar el atributo nonce . Consulte Agregar monitoreo de navegador para aplicaciones Go.

Java

7.6.0

Admite agregar nonce a través de las API getBrowserTimingHeader y getBrowserTimingFooter . Consulte los documentos del agente de monitoreo de Java del navegador.

.NET

8.39.0.0

Admite agregar nonce a través de la API GetBrowserTimingHeader . Consulte los documentos de monitoreo del navegador del agente .NET.

Node.js

4.3.0

Admite agregar nonce a través de la API getBrowserTimingHeader . Consulte los documentos de monitoreo del navegador del agente Node.js.

Ruby

7.1.0

Admite agregar nonce a través de la API browser_timing_header . Consulte los documentos de monitoreo del navegador del agente Ruby.

Soporte de proxy

Importante

Esta característica está actualmente disponible para aquellos que utilizan los métodos de instalación browser copiar/pegar o npm. Actualmente no hay opciones de configuración de UI o NerdGraph disponibles. Seguimos trabajando para mejorar el acceso a estas y otras opciones de configuración.

A partir del agente del navegador 1.240.0, el agente se puede configurar para enviar solicitudes de red a través de otra combinación de dominio y ruta que usted controle. Dependiendo de su configuración de proxy y de CSP, es posible que no necesite solicitar excepciones para agregar el dominio New Relic a script-src y connect-src. Consulte nuestros documentos de proxy para obtener más información, incluida una guía sobre cómo configurar el agente.

Integridad de los subrecursos (SRI)

El agente del navegador utiliza la división de código para hacer que el fragmento de código en línea sea lo más pequeño posible. El código adicional necesario para que el agente funcione se carga en tiempo de ejecución desde nuestra red de entrega de contenido (CDN). Como capa adicional de seguridad, comenzando con agente del browser 1.247.0, el fragmento del agente contiene hash de todos los fragmentos de código adicionales que podrían cargarse durante el tiempo de ejecución. El browser utiliza estos hash para verificar que el código cargado desde la CDN no se haya modificado involuntariamente, ya sea en la CDN o durante el tránsito mediante un ataque de intermediario.

Importante

El hash SRI no se aplica al uso del paquete npm agente del navegador. Con el paquete npm, el agente se convierte en parte del código de su sitio o aplicación, lo que invalida nuestro hash generado.

Para obtener más información sobre cómo funciona la seguridad SRI, consulte este artículo de MDN.

Copyright © 2024 New Relic Inc.

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