Sirve tu Nerdpack localmente cuando aún esté en desarrollo y no estés listo para compartirlo con otros. Emplearás los recursos de tu propia máquina, pero verás el Nerdpack en la plataforma New Relic como lo verías si estuviera publicado.
Actualice su CLI
Antes de ejecutar cualquier comando, cerciorar de tener la última versión de la CLI:
$nr1 updateSirve tu Nerdpack localmente
En la carpeta raíz de tu Nerdpack, ejecuta el comando nerdpack:serve :
$nr1 nerdpack:serveSi sirvió con éxito su Nerdpack, debería ver algunos resultados exitosos, que incluyen:
✔ Server ready! Test it at: https://one.newrelic.com/?nerdpacks=local↩ Server will reload automatically if you modify any file!Mientras su Nerdpack se sirve localmente, el servidor recargará automáticamente su Nerdpack cuando detecte que modificó un archivo. Esto no incluye el archivo de metadatos nr1.json ni el archivo de estilos styles.css. Si actualiza esos archivos, debe detener su servidor local con CTRL+C y resetear con nr1 nerdpack:serve.
Vaya a https://one.newrelic.com/?nerdpacks=local. New Relic requiere la cadena de consulta ?nerdpacks=local para cargar Nerdpacks servidos localmente.
Vaya a one.newrelic.com > All capabilities > Apps. Ya sea que esté creando una aplicación New Relic o una visualización personalizada, encontrará su proyecto en Apps.
Si estás sirviendo un Nerdpack con un pícher y un Nerdlet, encontrarás tu aplicación local en Your apps:. Si está ofreciendo un Nerdpack con una visualización, vaya a Favorite apps > Custom Visualizations.
Sugerencia
Si Custom Visualizations no está entre sus favoritos, puede encontrarlas en Your apps.
Desde Custom Visualizations, verá su visualización. Ya sea que estés entregando un Nerdpack para una aplicación o una visualización, verás un indicador </> Local en el mosaico UI . Emplee esto para distinguir entre Nerdpacks publicados y Nerdpacks servidos localmente.
Cuando esté listo para dejar de servir su Nerdpack localmente, escriba CTRL+C en su terminal donde se está ejecutando el servidor.
Resuelve problemas al acceder a tu Nerdpack local
A veces, cuando entregas tu Nerdpack localmente, puedes encontrarte con problemas. Es posible que no puedas entregar tu Nerdpack debido a errores en tu código. O bien, puedes entregar exitosamente tu Nerdpack pero no poder encontrarlo en New Relic. Considere algunas soluciones comunes para resolver estos problemas.
Depura tu aplicación
Cuando intentes servir tu Nerdpack localmente, lee atentamente el resultado de tu comando nr1 . Es posible que reciba resultados exitosos, que incluyen:
✔ Server ready! Test it at: https://one.newrelic.com/?nerdpacks=local↩ Server will reload automatically if you modify any file!Sin embargo, el resultado puede mostrar algunos errores en su Nerdpack. También puede ayudarlo a ver resultados más detallados. Emplee el comando --verbose para mostrar más contenido:
$nr1 nerdpack:serve --verboseMostrar Nerdpacks servidos localmente
Si no encuentra su Nerdpack en New Relic, cerciorar de estar usando la cadena de consulta ?nerdpacks=local . Si no es así, New Relic no cargará su Nerdpack servido localmente en la plataforma.
Consulta tu perfil local
Con nr1, puedes establecer un perfil predeterminado de New Relic. Este perfil se emplea para todos los comandos a menos que se especifique lo contrario con la opción --profile del comando. Cuando sirves tu Nerdpack con nr1 nerdpack:serve, debes iniciar sesión en el mismo perfil en New Relic con el que estás sirviendo localmente.
Entonces, si no encuentras tu Nerdpack en New Relic y estás usando la cadena de consulta correcta, compara tu perfil local con el perfil que estás usando en el browser para cerciorarte de que sean iguales.
Accede a tu browser proxy
Generalmente, no necesita saber cómo se carga el código de su aplicación en New Relic. Pero comprender cómo funciona puede ayudarlo a resolver problemas con su servidor local.
Cuando ejecuta nr1 nerdpack:serve, su máquina local entrega su código mediante un subdominio nr-local.net. Este dominio apunta a 127.0.0.1 y emplea una variedad de puertos para conectarse, incluido el 9973.
Para cargar un Nerdpack en la plataforma, ya sea servido localmente o publicado en el catálogo de observabilidad Instant , New Relic usa un <IFRAME> y un dominio separado (un subdominio de nr-ext.net), confiando en la política del mismo dominio para proteger el código. .
Entonces, si no encuentra su Nerdpack en New Relic, está usando la cadena de consulta correcta y está usando el perfil correcto, es posible que su administrador de red deba habilitar el acceso a:
- Cualquier subdominio de nr-local.net, o, como mínimo, a cualquier dominio con la forma
<UserId>.nr-local.net, donde<UserId>es un identificador de 32 caracteres hexadecimales que es único para el usuario que inicia sesión en la plataforma. Puedes usar[0-9a-f]{32}para discriminarlo. - Cualquier subdominio de
nr-ext.neto, como mínimo, a cualquier dominio con la forma<NerdpackUuid>.g <NerdpackGid>.nr-ext.net, donde<NerdpackUuid>es el UUID asignado a su paquete y<NerdpackGid>es cero o un número entero positivo. Puedes usar0|[1-9]\d+para discriminarlo.
Otras lecturas
Lea la documentación de nr1 nerdpack:serve para obtener más información. O bien, consulte la página de ayuda nr1 :
$nr1 nerdpack:serve --help