addRelease

Sintaxis

newrelic.addRelease(string $release_name, string $release_id)

Agrega un nombre y una identificación únicos para identificar versiones con múltiples paquetes de JavaScript en la misma página.

Requisitos

• Browser Pro o agente Pro+SPA (v1016 o superior)

• Si está utilizando npm para instalar el agente del navegador, debe habilitar la característica jserrors al crear una instancia de la clase BrowserAgent . En la matriz features , agregue lo siguiente:

  import { JSErrors } from '@newrelic/browser-agent/features/jserrors';
  
  const options = {
    info: { ... },
    loader_config: { ... },
    init: { ... },
    features: [
      JSErrors
    ]
  }

  Copia

  Para obtener más información, consulte la documentación de instalación del navegador npm.

Descripción

En monitoreo de browser, una versión es una forma de etiquetar errores con información sobre qué versión de su aplicación se está ejecutando actualmente. Esto es útil para sitios donde los componentes compartidos pertenecen a diferentes equipos, o donde se implementan múltiples aplicaciones de forma independiente pero se ejecutan en la misma página.

Las aplicaciones web modernas tienen muchas partes interconectadas, por lo que una aplicación puede tener varias versiones (con diferentes nombres) asociadas con la misma carga de página. Por ejemplo, puede utilizar lanzamientos para:

• Vea las diferencias entre los errores de una versión antigua almacenada en caché de su aplicación y los errores provenientes de una nueva versión.
• Identifique problemas encontrados durante las pruebas A/B, implementaciones lentas, indicadores de características y otros métodos de implementación avanzados.
• Determine qué versión de un mapa fuente del navegador utilizar.

Si la URL de su JavaScript no es única, debe especificar un nombre de versión y un identificador con esta llamada API al agente del navegador. Esta información también es necesaria al publicar mapas de origen en el servicio de almacenamiento. Esta API agrega una ID para monitorear el navegador para identificar versiones con múltiples paquetes de JavaScript en la misma página.

Si la URL del paquete JavaScript de su aplicación is unique cada vez que implementa su código, el monitoreo del navegador no requiere ninguna información adicional para identificar su versión. Por ejemplo, algunas herramientas de implementación de frontend utilizan el número de compilación de Jenkins o git commit sha en el nombre de archivo del código de implementación. Estos son suficientes para determinar de forma única la versión que provocó el error.

Tan pronto como sea posible después de que se cargue su página, llame al newrelic.addRelease(). Todos los errores que vea el agente del navegador estarán asociados con esa versión del código JavaScript.

Parámetros

Ejemplos

SHA corto actual

newrelic.addRelease('checkout page', 'a818994')

Versionado semántico

newrelic.addRelease('jquery.min.js', 'v3.1.1')