Notre prend en charge le téléchargement de cartes sources.
La prise en charge des cartes sources est principalement utile pour « décoder » du JavaScript minifié. Le JavaScript minifié génère pour la plupart des traces d'appels d'erreur inutiles sur la page Errors du navigateur. Le téléchargement de cartes sources convertit ces erreurs en traces d'appels compréhensibles, avec des références utiles aux lignes de code. Cette fonctionnalité peut également être utile pour le code JavaScript groupé ou transpilé.
Le navigateur vous offre deux options pour utiliser les cartes sources :
- Télécharger des cartes sources via l'UI du navigateur
- Publier des cartes sources sur le navigateur via l'API
Ce document expliquera la première méthode : comment télécharger des cartes sources via l'UI, ainsi qu'une aide générale au dépannage. Pour obtenir des instructions sur l'utilisation de la méthode API, consultez Envoyer des cartes sources via l'API.
Importer des cartes sources via l'UI de New Relic
Vous pouvez faire glisser et déposer, ou télécharger, un fichier de carte source dans l'UI du navigateur pour l'associer à un fichier JavaScript spécifique. New Relic convertira ensuite la trace d'appels minifiée en trace non minifiée et en code source visible sur la page Erreurs.
- Téléchargez votre carte source sur votre machine locale.
- Accédez à one.newrelic.com > All capabilities > Browser > (select an app) > Errors, puis cliquez sur un groupe d’erreurs. (Ne sélectionnez pas un groupe étiqueté Errors without a stack trace.)
- Dans la section Stack trace , cliquez sur le Upload source map.
- Dans la fenêtre contextuelle de recherche de fichiers, sélectionnez votre fichier source. Un cadre d'erreur avec une bande grise sur le côté gauche indique un JS minifié. Une bande bleue indique qu'une carte source a été appliquée.
Les autres fonctionnalités du cadre d'erreur JS incluent :
If you want to... | Do this... |
|---|---|
Voir plus de code environnant | Sélectionnez |
Voir les informations du fichier original et minifié |
|
Supprimer une carte source | À partir d'un cadre trace d'appels développé, sélectionnez Remove file. |
Dépannage
les traces d'appels sont toujours minifiées
Si vous avez téléchargé des cartes sources sur New Relic et que vous voyez toujours des traces d'appels minifiées, il y a quelques éléments à vérifier. L'utilisation de l'API est le meilleur moyen d'enquêter sur les problèmes potentiels, en répertoriant ou en supprimant les cartes sources publiées.
Typical problems | Troubleshooting tips |
|---|---|
Incompatibilité d'URL | Chaque image de la trace d'appels est associée à une URL JavaScript spécifique. Cette URL doit correspondre à l’URL JavaScript qui a été utilisée lors de la publication de la carte source. Assurez-vous que ces URL correspondent exactement. |
incompatibilité nom/ID de sortie | Si l'URL JavaScript n'est pas versionnée lorsque vous affichez vos ressources frontend, un nom de sortie et un ID de sortie doivent être spécifiés à l'aide de la méthode API |
Erreur 409 : | Si un fichier de carte source pour une URL JavaScript particulière est téléchargé sans nom de sortie ou ID spécifié, New Relic traite l'URL comme un identifiant unique. Pour résoudre ce problème, supprimez la carte source qui contient des valeurs de nom et d'ID de sortie NULL et téléchargez à nouveau toutes les versions de cette URL, y compris ces paramètres. Cela permettra plusieurs versions de cartes sources pour une URL JS particulière. |
Composant | Votre fichier de modélisation doit contenir le composant Si le composant |
Impossible de générer des cartes sources
Vous avez même des difficultés à générer des cartes sources ? Chaque système de construction possède ses propres instructions pour générer des cartes sources. Pour plus de détails spécifiques, veuillez consulter la documentation de votre outil particulier. Vous trouverez ci-dessous les instructions de génération de cartes sources pour deux systèmes de build populaires :