O agente Node.js do New Relic coleta os principais dados da fração de tempo de métrica da máquina virtual (VM) do Node.js. Essas métricas fornecem insights sobre o comportamento da VM do Node.js e ajudam você a melhorar o desempenho do seu aplicativo. O agente também coleta métricas de CPU, que frequentemente são analisadas em conjunto com as métricas de coleta de lixo (GC).
O que você precisa
A partir da versão 14.11.0 do agente, o agente é fornecido com uma rotina de coleta de métricas de VM nativa em JavaScript diretamente no agente. Antes desta versão, o agente exigia um módulo nativo adicional para coletar dados da fração de tempo de métrica da VM do Node.js relacionados à coleta de lixo, memória e CPU.
Recomendamos atualizar para a versão mais recente do agente para aproveitar a coleta de métricas integrada. O restante deste documento presumirá isso e não fará referência ao módulo nativo descontinuado.
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.
A quantidade de tempo gasto na coleta de lixo (todos os tipos usados pela V8) pelo seu processo Node.js. O tempo é medido como uma métrica cumulativa, como GC/System/Pauses e agrupado por tipo de coleta de lixo, como GC/<type>.
Os possíveis tipos de coleta de lixo incluem:
GC type
Description
Scavenge
O método de coleta de lixo mais comum. O Node.js normalmente acionará um deles sempre que a VM estiver ociosa.
MarkSweepCompact
O tipo mais pesado de coleta de lixo que o V8 pode fazer. Se você observar muitas dessas coisas acontecendo, precisará manter menos objetos em seu processo ou aumentar o limite de heap do V8.
IncrementalMarking
Uma coleta de lixo em fases que intercala a coleta com a lógica do aplicativo para reduzir o tempo que o aplicativo fica pausado. Somente no Node.js v6 ou superior.
ProcessWeakCallbacks
Após ocorrer uma coleta de lixo, o V8 chamará qualquer retorno de chamada de referência fraca registrado para objetos que foram liberados. Essa medida vai do início do primeiro retorno de chamada fraco até o final do último para uma determinada coleta de lixo. Somente no Node.js v6 ou superior.
O agente New Relic Node.js coleta as seguintes métricas relacionadas ao uso de memória:
Metric
Description
Memory/Physical
A memória física total (em MB) usada pelo processo Node.js. Ele é registrado usando a API process.memoryUsage().rss Node.js.
Memory/Heap/Max
O heap total (em MB) alocado pela V8 para armazenar objetos Javascript. Ele é registrado usando a API process.memoryUsage().heapTotal Node.js.
Memory/Heap/Used
A quantidade de heap V8 (em MB) usada atualmente pelo aplicativo. Ele é registrado usando a API process.memoryUsage().heapUsed Node.js.
Memory/Heap/Free
A quantidade de memória V8 (em MB) alocada, mas não usada. Esta é uma métrica derivada (heapTotal - heapUsed).
Memory/NonHeap/Used
A quantidade de memória diferente do heap V8 (em MB). Esta é uma métrica derivada (rss - heapTotal). Essa métrica é útil para localizar vazamentos de memória fora do heap V8; por exemplo, com buffers ou fluxos.
O agente coleta as seguintes métricas relacionadas à CPU:
Metric
Description
CPU/User Time
O tempo gasto pela CPU executando o código do usuário. É gravado em segundos.
CPU/User/Utilization
O tempo gasto na execução do código do usuário (CPU/User Time) dividido pelo tempo transcorrido e pelo número de processadores lógicos. Como o tempo de execução do Node.js sempre usa apenas um núcleo, o valor máximo relatado por esta métrica será 100 dividido pelo número de núcleos.
CPU/System Time
O tempo gasto pela CPU no kernel do sistema em relação ao processo Node.js.
CPU/System/Utilization
O tempo gasto no kernel do sistema (CPU/System Time) dividido pelo tempo transcorrido e pelo número de processadores lógicos. Como o tempo de execução do Node.js sempre usa apenas um núcleo, o valor máximo relatado por esta métrica será 100 dividido pelo número de núcleos.
O agente coleta a seguinte métrica do loop de eventos:
Metric
Description
Nodejs/EventLoop/CPU/Usage
O tempo total de CPU gasto na execução ativa em cada tick do loop de evento. Isso inclui a execução do retorno de chamada do seu aplicativo, mas também do próprio tempo de execução. Relatado em unidades de segundos.
Um tick de loop de evento anormalmente longo indica execução síncrona ininterrupta que pode ser um destino para otimização; por exemplo, chamadas process.nextTick recursivas).