Proposez votre Nerdpack localement lorsqu'il est encore en développement et que vous n'êtes pas prêt à le partager avec d'autres. Vous utiliserez les ressources de votre propre machine, mais vous verrez le Nerdpack sur la plateforme New Relic comme s'il était publié.
Mettez à jour votre CLI
Avant d’exécuter des commandes, assurez-vous que vous disposez de la dernière version de la CLI :
$nr1 updateServez votre Nerdpack localement
Dans le dossier racine de votre Nerdpack, exécutez la commande nerdpack:serve :
$nr1 nerdpack:serveSi vous avez réussi à servir votre Nerdpack, vous devriez voir des résultats positifs, notamment :
✔ Server ready! Test it at: https://one.newrelic.com/?nerdpacks=local↩ Server will reload automatically if you modify any file!Pendant que votre Nerdpack est servi localement, le serveur rechargera automatiquement votre Nerdpack lorsqu'il détectera que vous avez modifié un fichier. Cela n'inclut pas le fichier de métadonnées nr1.json ni le fichier de styles styles.css. Si vous mettez à jour ces fichiers, vous devez arrêter votre serveur local avec CTRL+C et le redémarrer avec nr1 nerdpack:serve.
Accédez à https://one.newrelic.com/?nerdpacks=local. New Relic nécessite la chaîne de requête ?nerdpacks=local pour charger les Nerdpacks servis localement.
Aller à one.newrelic.com > All capabilities > Apps. Que vous créiez une application New Relic ou une visualisation personnalisée, vous trouverez votre projet sous Apps.
Si vous utilisez un Nerdpack avec un lanceur et un Nerdlet, vous trouverez votre application locale sous Your apps:. Si vous proposez un Nerdpack avec une visualisation, allez à Favorite apps > Custom Visualizations.
Conseil
Si Custom Visualizations ne sont pas ajoutées à vos favoris, vous pouvez les trouver sous Your apps.
À partir de Custom Visualizations, vous verrez votre visualisation. Que vous proposiez un Nerdpack pour une application ou une visualisation, vous verrez un indicateur </> Local sur sa mosaïque d'interface utilisateur. Utilisez ceci pour faire la distinction entre les Nerdpacks publiés et les Nerdpacks servis localement.
Lorsque vous êtes prêt à arrêter de servir votre Nerdpack localement, tapez CTRL+C dans votre terminal sur lequel le serveur s'exécute.
Résoudre les problèmes d'accès à votre Nerdpack local
Parfois, lorsque vous servez votre Nerdpack localement, vous pouvez rencontrer des problèmes. Vous ne pourrez peut-être pas servir votre Nerdpack en raison de bugs dans votre code. Ou bien, vous pouvez réussir à servir votre Nerdpack mais ne pas pouvoir le retrouver dans New Relic. Envisagez quelques solutions courantes pour résoudre ces problèmes.
Déboguer votre application
Lorsque vous essayez de servir votre Nerdpack localement, lisez attentivement la sortie de votre commande nr1 . Vous pouvez recevoir des résultats de réussite, notamment :
✔ Server ready! Test it at: https://one.newrelic.com/?nerdpacks=local↩ Server will reload automatically if you modify any file!Cependant, la sortie peut afficher quelques erreurs dans votre Nerdpack à la place. Cela peut également vous aider à visualiser une sortie plus détaillée. Utilisez la commande --verbose pour afficher plus de contenu :
$nr1 nerdpack:serve --verboseAfficher les Nerdpacks servis localement
Si vous ne trouvez pas votre Nerdpack dans New Relic, assurez-vous d'utiliser la chaîne de requête ?nerdpacks=local . Si ce n'est pas le cas, New Relic ne chargera pas votre Nerdpack servi localement sur la plateforme.
Vérifiez votre profil local
Avec nr1, vous pouvez définir un profil New Relic par défaut. Ce profil est utilisé pour toutes les commandes, sauf indication contraire avec l'option --profile de la commande. Lorsque vous servez votre Nerdpack avec nr1 nerdpack:serve, vous devez être connecté au même profil dans New Relic que celui avec lequel vous servez localement.
Donc, si vous ne trouvez pas votre Nerdpack dans New Relic et que vous utilisez la bonne chaîne de requête, comparez votre profil local avec le profil que vous utilisez dans le navigateur pour vous assurer qu'ils sont identiques.
Accédez à votre navigateur proxy
En règle générale, vous n'avez pas besoin de savoir comment votre code d'application est chargé dans New Relic. Mais comprendre son fonctionnement peut vous aider à résoudre les problèmes avec votre serveur local.
Lorsque vous exécutez nr1 nerdpack:serve, votre code est diffusé par votre machine locale à l'aide d'un sous-domaine nr-local.net. Ce domaine pointe vers 127.0.0.1 et utilise une variété de ports pour se connecter, y compris 9973.
Pour charger un Nerdpack dans la plateforme, qu'il soit diffusé localement ou publié dans le catalogue Instant Observability , New Relic utilise un <IFRAME> et un domaine distinct (un sous-domaine de nr-ext.net), en s'appuyant sur la politique du même domaine pour sandboxer le code.
Donc, si vous ne trouvez pas votre Nerdpack dans New Relic, que vous utilisez la bonne chaîne de requête et que vous utilisez le bon profil, votre administrateur réseau devra peut-être activer l'accès à :
- Tout sous-domaine de nr-local.net, ou, à tout le moins, à tout domaine de la forme
<UserId>.nr-local.net, où<UserId>est un identifiant de 32 caractères hexadécimaux propre à l'utilisateur connecté à la plateforme. Vous pouvez utiliser[0-9a-f]{32}pour le discriminer. - Tout sous-domaine de
nr-ext.net, ou, à tout le moins, tout domaine sous la forme de<NerdpackUuid>.g <NerdpackGid>.nr-ext.net, où<NerdpackUuid>est l'UUID attribué à votre package et<NerdpackGid>est zéro ou un entier positif. Vous pouvez utiliser0|[1-9]\d+pour le discriminer.
Lectures complémentaires
Lisez la documentation nr1 nerdpack:serve pour en savoir plus. Ou, consultez la page d'aide nr1 :
$nr1 nerdpack:serve --help