O agente Node.js da New Relic coleta dados principais de métricas de fração de tempo da máquina virtual Node.js (V8). Essas métricas fornecem insights sobre o comportamento da VM Node.js e ajudam a melhorar o desempenho do seu aplicativo. O agente também coleta métricas de CPU, que muitas vezes são analisadas em conjunto com métricas de coleta de lixo (GC).
O que você precisa
O New Relic requer um módulo nativo adicional para coletar dados métricos de fração de tempo da VM Node.js relacionados à coleta de lixo, memória e CPU. A partir do Node.js v6.1.0 o módulo nativo não é necessário para coletar métricas de CPU, pois o agente New Relic Node.js as coleta com process.cpuUsage().
O módulo nativo pode ser usado com:
- New Relic Node.js versão 1.35.1 ou superior
- Node.js v4 ou superior
- npm v2.0.0 ou superior
Para compilar o módulo nativo em sua plataforma de implantação, siga os procedimentos do pacotenode-gyp . Os pré-requisitos para instalar módulos nativos do Node.js incluem:
Plataforma | Pré-requisitos |
|---|---|
Unix/Linux | Python (v2.7 recomendado, v3.xx não suportado), make, compilador C/C++ (como GCC) |
Mac OS | Python (v2.7 recomendado, v3.xx não compatível), Xcode |
Windows | Python (v2.7 recomendado, v3.xx não compatível), Visual C++ Build Environment |
Se você tiver problemas ao instalar nosso agente Node.js, siga os procedimentos de instalação de resolução de problemas .
Instale o módulo nativo
A partir da versão 2.0.0 do agente New Relic Node.js, o módulo nativo tornou-se uma dependência opcional que tenta ser instalada automaticamente.
Durante a instalação, o módulo nativo primeiro tenta compilar a partir da origem na máquina de destino. Se a compilação falhar, o Node.js gera um stack trace para o console que você normalmente pode ignorar. Para ambientes Linux que executam versões suportadas do Node, o agente tenta baixar e instalar um binário pré-construído.
É possível evitar que o agente tente baixar e instalar um binário pré-construído. Em vez disso, ele tentará apenas construir o módulo nativo. Faça isso definindo a variável de ambiente NR_NATIVE_METRICS_NO_DOWNLOAD como true antes da instalação com npm ou Yarn.
$export NR_NATIVE_METRICS_NO_DOWNLOAD=true$npm install @newrelic/native-metrics$yarn add @newrelic/native-metricsComo alternativa, use a sinalização --no-download que funciona com npm.
$npm install @newrelic/native-metrics --no-downloadSe a compilação falhar com NR_NATIVE_METRICS_NO_DOWNLOAD=true ou o sinalizador --no-download definido, o módulo nativo opcional não será instalado.
Se ambas as variáveis de ambiente forem definidas, NR_NATIVE_METRICS_NO_BUILD substituirá NR_NATIVE_METRICS_NO_DOWNLOAD.
Se você estiver usando uma versão mais antiga, atualize para a versão mais recente do agente ou instale o módulo nativo manualmente:
Certifique-se de que uma versão compatível do Node.js esteja instalada. Recommendation: Use a versão LTS mais recente. Não use versões inferiores à versão mínima suportada para o módulo
@newrelic/native-metrics(v4 ou superior).Para obter todas as métricas disponíveis atualmente, verifique se você está executando o módulo
newrelicpara o agente 1.37.0 ou superior.Windows users: Execute o seguinte comando:
bash$npm install --global windows-build-toolsSe esta etapa não funcionar, siga a Opção 2 no módulo node-gyp no GitHub para obter instruções de instalação manual.
Para instalar o módulo métrica nativo, use um destes métodos:
Execute o comando
npm install @newrelic/native-metrics --save.OU
Adicione o módulo ao arquivo
package.jsondo seu aplicativo.
Reinicie seu aplicativo.
O agente Node.js detecta automaticamente se o módulo métrica nativo está instalado e começa a utilizá-lo. Se quiser evitar completamente a instalação do módulo nativo, você pode usar os seguintes argumentos npm ou Yarn.
$npm install newrelic --no-optional$yarn add newrelic --ignore-optionalBinários pré-construídos
Para ignorar a etapa de compilação e tentar fazer download apenas de um binário pré-compilado e para evitar erros de compilação no console, defina a variável de ambiente NR_NATIVE_METRICS_NO_BUILD como true antes da instalação.
$export NR_NATIVE_METRICS_NO_BUILD=trueSe estiver trabalhando atrás de um firewall, você poderá armazenar em cache binários pré-criados definindo as variáveis de ambiente NR_NATIVE_METRICS_DOWNLOAD_HOST e NR_NATIVE_METRICS_REMOTE_PATH antes da instalação.
$export NR_NATIVE_METRICS_DOWNLOAD_HOST=http://your-internal-cache/$export NR_NATIVE_METRICS_REMOTE_PATH=path/to/download/folder/Depois de definir as variáveis de ambiente, a instalação poderá prosseguir.
$npm install @newrelic/native-metrics$yarn add @newrelic/native-metricsVer dados da VM Node.js
Para visualizar gráficos selecionados com dados de VM Node.js, acesse one.newrelic.com > All capabilities > APM & services > (select an app) > Node VMs. Para obter mais informações, consulte a página de estatísticas de VM do Node.js.
Os dados também estão disponíveis em métricas e eventos.
Detalhes de medição
Dica
Nem todos os dados podem ser coletados em todas as versões do Node.js. Em geral, você obterá os dados mais completos se estiver usando a versão LTS mais recente do Node.