addRelease

Sintaxe

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

Adiciona um nome e ID exclusivos para identificar versões com vários pacotes JavaScript na mesma página.

Requisitos

• Agente browser Pro ou Pro+SPA (v1016 ou superior)

• Se estiver usando o npm para instalar o agente browser, você deverá ativar o recurso jserrors ao instanciar a classe BrowserAgent . Na matriz features , adicione o seguinte:

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

  Copiar

  Para obter mais informações, consulte a documentação de instalação do browser npm.

Descrição

Em monitoramento de browser, uma versão é uma forma de tag erros com informações sobre qual versão do seu aplicativo está em execução no momento. Isso é útil para sites onde os componentes compartilhados pertencem a equipes diferentes ou onde vários aplicativos são implantados de forma independente, mas executados na mesma página.

Os aplicativos da web modernos têm muitas partes interconectadas, portanto, um aplicativo pode ter várias versões (com nomes diferentes) associadas ao mesmo carregamento de página. Por exemplo, você pode usar versões para:

• Veja as diferenças entre os erros de uma versão antiga em cache do seu aplicativo e os erros provenientes de uma nova versão.
• Identifique problemas encontrados durante testes A/B, implementações lentas, sinalizadores de recursos e outros métodos avançados de implantação.
• Determine qual versão de um mapa de origem do browser usar.

Se a URL do seu JavaScript não for exclusiva, você deverá especificar um nome de versão e um identificador com esta chamada de API para o agente browser. Estas informações também são necessárias ao publicar mapas de origem no serviço de armazenamento. Esta API adiciona um ID para monitoramento de Browser para identificar lançamentos com múltiplos pacotes JavaScript na mesma página.

Se o URL do pacote JavaScript do seu aplicativo is unique sempre que você implantar seu código, o monitoramento do browser não exigirá nenhuma informação adicional para identificar sua versão. Por exemplo, algumas ferramentas de implantação de front-end usam o número de compilação do Jenkins ou git commit sha no nome do arquivo do código de implantação. Estes são suficientes para determinar exclusivamente a versão que causou o erro.

Assim que possível após o carregamento da sua página, chame newrelic.addRelease(). Todos os erros que o agente browser vê serão associados a essa versão do código JavaScript.

Parâmetro

Exemplos

SHA curto atual

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

Versionamento semântico

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