Instale o agente Node.js.

Para concluir uma instalação básica do agente Node.js, você pode usar nossa instalação guiada para uma instalação automatizada (escolha UE se estiver na UE) ou seguir as instruções neste documento. De qualquer forma, você precisa de uma conta New Relic, caso ainda não tenha uma. (É grátis, para sempre!)

Nosso agente Node.js está disponível publicamente no repositório Node gerenciador de pacote (npm), bem como no GitHub.

Instale o agente Node.js.

Para instalar o agente Node.js:

1. Crie uma conta New Relic . Não tem um? Cadastre-se gratuitamente! Não é necessário cartão de crédito.

2. Certifique-se de atender ao requisito do sistema. Em particular, certifique-se de usar uma versão compatível do Node.js.

3. Use o comando npm install newrelic para cada aplicativo que você deseja monitor. Se seu aplicativo estiver usando um desses módulos do Apollo Server, instale nosso plug-in Apollo com npm install @newrelic/apollo-server-plugin. Mais detalhes sobre o uso @newrelic/apollo-server-plugin podem ser encontrados aqui.

   Importante

   Se você estiver usando Next.js, veja este exemplo de um aplicativo Next.js

4. De node_modules/newrelic, copie newrelic.js para o diretório raiz do seu aplicativo.

5. Configure o agente por meio do arquivo newrelic.js ou da variável de ambiente:

   • Personalize a configuração license_key com chave de licença.
   • Personalize a configuração app_name com um ou mais nomes de aplicativos significativos.

6. Adicione -r newrelic ao script de inicialização do seu aplicativo. Por exemplo, se o ponto de entrada do seu aplicativo for ./dist/server.js , você usaria o sinalizador require da seguinte forma:

   bash

   Copiar

   $
   node -r newrelic ./dist/server.js

   Um exemplo de comando Docker :

   CMD ["node", "-r", "newrelic", "server.js"]

   Copiar

   Importante

   Para um aplicativo Next.js, carregue nosso agente via NODE_OPTIONS:

   CMD ["NODE_OPTIONS='-r newrelic'", "next", "start"]

   Copiar

   Se você estiver usando Nest.JS e o comando nest start para iniciar o aplicativo, modifique seu binário de inicialização para carregar o agente New Relic: nest start --exec 'node -r newrelic'. Aqui está um exemplo de aplicativo Nest.js

   Mais informações sobre a opção de linha de comando do Node.js -r aqui.

   Importante

   Se não for possível usar o sinalizador require -r , você também poderá usar require('newrelic') como a primeira linha do módulo principal do seu aplicativo. Note Se você estiver usando Babel ou um transpilador semelhante require('newrelic') causará problemas de instrumentação.

   Se nenhuma dessas opções funcionar para você (por exemplo, carregar chave de API de forma assíncrona de um local remoto durante o aplicativo inicialização), você também pode adicionar instrumentação de estoque a um módulo suportado já carregado usando newrelic.instrumentLoadedModule:

   // module loaded before newrelic
   const expressModule = require('express');
   
   // load the agent
   const newrelic = require('newrelic');
   
   // instrument express after the agent has been loaded
   newrelic.instrumentLoadedModule(
     'express',    // the module's name, as a string
     expressModule // the module instance
   );

   Copiar

7. Opcional: para obter estatísticas adicionais no nível do tempo de execução do Node.js, certifique-se de que o pacote@newrelic/native-metrics esteja instalado.

8. Gere algum tráfego e aguarde alguns minutos para que os dados apareçam na interface do APM.

Você pode personalizar ainda mais o comportamento do seu agente por meio de newrelic.js ou de uma variável de ambiente. Para manter a configuração do agente separada do seu aplicativo, edite a variável ambientalNEW_RELIC_HOME .

Para mais informações, consulte nossa documentação da API.

Visualize o log do seu APM e dados de infraestrutura

Você também pode reunir os dados do seu log e da aplicação para tornar a resolução de problemas mais fácil e rápida. Com os logs contextualizados, você pode ver a mensagem do log relacionada aos seus erros e rastrear diretamente na interface do seu aplicativo. Você também pode ver o logs contextualizados dos dados da sua infraestrutura, como cluster do Kubernetes. Não há necessidade de mudar para outra página de interface.

Mantenha seu agente Node.js atualizado

Para garantir que você tenha a versão mais atualizada do New Relic, consulte as notas de versão do Node.js. Quando aplicável, as notas de versão incluem um link para download com instruções sobre como atualizar o agente Node.js.

Resolução de problemas

Depois de atualizar o agente, gere algum tráfego e aguarde alguns minutos. Se nenhum dado aparecer na interface do New Relic, consulte os procedimentos de resolução de problemas.