ajouterRelease

Syntaxe

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

Ajoute un nom et un identifiant uniques pour identifier la sortie avec plusieurs bundles JavaScript sur la même page.

Exigences

• Agent navigateur Pro ou Pro+SPA (v1016 ou supérieur)

• Si vous utilisez npm pour installer l'agent du navigateur, vous devez activer la fonctionnalité jserrors lors de l'instanciation de la classe BrowserAgent . Dans l'éventail features , ajoutez ce qui suit :

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

  Copier

  Pour plus d'informations, consultez la documentation d'installation du navigateur npm.

Description

Dans monitoring de navigateurs, une sortie est un moyen de tag les erreurs avec des informations sur la version de votre application en cours d'exécution. Ceci est utile pour les sites où les composants partagés appartiennent à différentes équipes ou où plusieurs applications sont déployées indépendamment mais exécutées sur la même page.

Les applications Web modernes comportent de nombreuses parties interconnectées, de sorte qu'une application peut avoir plusieurs sorties (avec des noms différents) associées au même chargement de page. Par exemple, vous pouvez utiliser sortie pour :

• Découvrez les différences entre les erreurs d'une ancienne version en cache de votre application et les erreurs provenant d'une nouvelle version.
• Identifiez les problèmes détectés lors des tests A/B, des déploiements lents, des indicateurs de fonctionnalités et d’autres méthodes de déploiement avancées.
• Déterminez quelle version d’une carte source de navigateur utiliser.

Si l'URL de votre JavaScript n'est pas unique, vous devez spécifier un nom de sortie et un identifiant avec cet appel d'API à l'agent du navigateur. Ces informations sont également requises lors de la publication de cartes sources sur le service de stockage. Cette API ajoute un identifiant pour monitoring les navigateurs afin d'identifier les sorties avec plusieurs bundles JavaScript sur la même page.

Si l'URL du bundle JavaScript de votre application is unique à chaque fois que vous déployez votre code, monitoring des navigateurs ne nécessite aucune information supplémentaire pour identifier votre sortie. Par exemple, certains outils de déploiement front-end utilisent le numéro de build Jenkins ou git commit sha dans le nom de fichier du code de déploiement. Ceux-ci suffisent à déterminer de manière unique la sortie qui a provoqué l’erreur.

Dès que possible après le chargement de votre page, appelez newrelic.addRelease(). Toutes les erreurs que l’agent du navigateur voit seront associées à cette version du code JavaScript.

Paramètres

Exemples

SHA court actuel

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

Versionnage sémantique

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