Sirva seu Nerdpack localmente quando ele ainda estiver em desenvolvimento e você não estiver pronto para compartilhá-lo com outras pessoas. Você usará os recursos da sua própria máquina, mas verá o Nerdpack na plataforma New Relic como veria se fosse publicado.
Atualize sua CLI
Antes de executar qualquer comando, certifique-se de ter a versão mais recente da CLI:
$nr1 updateSirva seu Nerdpack localmente
Na pasta raiz do seu Nerdpack, execute o comando nerdpack:serve :
$nr1 nerdpack:serveSe você atendeu seu Nerdpack com sucesso, deverá ver alguns resultados de sucesso, incluindo:
✔ Server ready! Test it at: https://one.newrelic.com/?nerdpacks=local↩ Server will reload automatically if you modify any file!Enquanto seu Nerdpack estiver sendo servido localmente, o servidor recarregará automaticamente seu Nerdpack quando detectar que você modificou um arquivo. Isso não inclui o arquivo de metadados nr1.json ou o arquivo de estilos styles.css. Se você atualizar esses arquivos, será necessário parar o servidor local com CTRL+C e reiniciá-lo com nr1 nerdpack:serve.
Vá para https://one.newrelic.com/?nerdpacks=local. New Relic requer a string de consulta ?nerdpacks=local para carregar Nerdpacks servidos localmente.
Vá para one.newrelic.com > All capabilities > Apps. Esteja você criando um aplicativo New Relic ou uma visualização personalizada, você encontrará seu projeto em Apps.
Se você estiver servindo um Nerdpack com um iniciador e um Nerdlet, encontrará seu aplicativo local em Your apps:. Se você estiver servindo um Nerdpack com visualização, vá para Favorite apps > Custom Visualizations.
Dica
Se as Custom Visualizations não estiverem favoritas, você poderá encontrá-las em Your apps.
Em Custom Visualizations, você verá sua visualização. Esteja você servindo um Nerdpack para um aplicativo ou uma visualização, você verá um indicador </> Local no bloco da interface. Use isto para distinguir entre Nerdpacks publicados e Nerdpacks servidos localmente.
Quando estiver pronto para parar de servir seu Nerdpack localmente, digite CTRL+C no terminal onde o servidor está sendo executado.
Resolva problemas de acesso ao seu Nerdpack local
Às vezes, ao servir seu Nerdpack localmente, você pode encontrar problemas. Você pode não conseguir servir seu Nerdpack devido a bugs em seu código. Ou você pode servir seu Nerdpack com sucesso, mas não conseguir encontrá-lo no New Relic. Considere algumas soluções comuns para resolver esses problemas.
Depure seu aplicativo
Ao tentar servir seu Nerdpack localmente, leia atentamente a saída do seu comando nr1 . Você pode receber resultados de sucesso, incluindo:
✔ Server ready! Test it at: https://one.newrelic.com/?nerdpacks=local↩ Server will reload automatically if you modify any file!No entanto, a saída pode mostrar alguns erros no seu Nerdpack. Também pode ajudá-lo a visualizar resultados mais detalhados. Use o comando --verbose para mostrar mais conteúdo:
$nr1 nerdpack:serve --verboseMostrar Nerdpacks servidos localmente
Se você não encontrar seu Nerdpack no New Relic, certifique-se de usar a string de consulta ?nerdpacks=local . Caso contrário, a New Relic não carregará seu Nerdpack servido localmente na plataforma.
Verifique seu perfil local
Com nr1, você pode definir um perfil padrão do New Relic. Este perfil é usado para todos os comandos, a menos que especificado de outra forma com a opção --profile do comando. Ao servir seu Nerdpack com nr1 nerdpack:serve, você deve estar conectado ao mesmo perfil no New Relic com o qual está servindo localmente.
Portanto, se você não encontrar seu Nerdpack no New Relic e estiver usando a string de consulta correta, compare seu perfil local com o perfil que você está usando no browser para ter certeza de que são iguais.
Acesse seu browser proxy
Geralmente, você não precisa saber como o código do seu aplicativo é carregado no New Relic. Mas entender como funciona pode ajudá-lo a resolver problemas com seu servidor local.
Quando você executa nr1 nerdpack:serve, seu código é servido pela sua máquina local usando um subdomínio nr-local.net. Este domínio aponta para 127.0.0.1 e usa uma variedade de portas para conexão, incluindo 9973.
Para carregar um Nerdpack na plataforma, seja ele servido localmente ou publicado no catálogo de observabilidade Instant , New Relic usa um <IFRAME> e um domínio separado (um subdomínio de nr-ext.net), contando com a política de mesmo domínio para colocar o código em sandbox. .
Portanto, se você não encontrar seu Nerdpack no New Relic, estiver usando a string de consulta correta e o perfil correto, seu administrador de rede pode precisar habilitar o acesso a:
- Qualquer subdomínio de nr-local.net, ou, no mínimo, para qualquer domínio do formato
<UserId>.nr-local.net, onde<UserId>é um identificador de 32 caracteres hexadecimais exclusivo para o usuário logado na plataforma. Você pode usar[0-9a-f]{32}para discriminá-lo. - Qualquer subdomínio de
nr-ext.netou, pelo menos, qualquer domínio no formato de<NerdpackUuid>.g <NerdpackGid>.nr-ext.net, onde<NerdpackUuid>é o UUID atribuído ao seu pacote e<NerdpackGid>é zero ou um número inteiro positivo. Você pode usar0|[1-9]\d+para discriminá-lo.
Leitura adicional
Leia a documentação nr1 nerdpack:serve para saber mais. Ou veja a página de ajuda nr1 :
$nr1 nerdpack:serve --help