El agente Node.js de New Relic recopila datos clave de intervalo de tiempo de métrica de la máquina virtual Node.js (V8). Estas métricas le brindan información valiosa sobre el comportamiento de la máquina virtual (VM) de Node.js y lo ayudan a mejorar el rendimiento de su aplicación. El agente también recopila CPU métrica, que a menudo se analiza junto con la recolección de basura (GC) métrica.
Que necesitas
New Relic requiere un módulo nativo adicional para recopilar datos de intervalo de tiempo de métrica de máquina virtual (VM) de Node.js relacionados con la recolección de basura, la memoria y la CPU. A partir de Node.js v6.1.0 No es necesario que el módulo nativo recopile métricas de CPU, ya que el agente New Relic Node.js las recopila con process.cpuUsage().
El módulo nativo se puede utilizar con:
- New Relic Node.js versión 1.35.1 o superior
- Node.js v4 o superior
- npm v2.0.0 o superior
Para compilar el módulo nativo en su plataforma de despliegue, siga los procedimientos del paquetenode-gyp . Los requisitos previos para instalar módulos nativos de Node.js incluyen:
Plataforma | Requisitos previos |
|---|---|
Unix/Linux | Python (se recomienda v2.7, no se admite v3.xx), make, compilador C/C++ (como GCC) |
Mac OS | Python (se recomienda v2.7, no se admite v3.xx), Xcode |
Windows | Python (se recomienda v2.7, no se admite v3.xx), entorno de compilación de Visual C++ |
Si tiene problemas al instalar nuestro agente Node.js, siga los procedimientos de resolución de problemas de instalación .
Instalar el módulo nativo
A partir de la versión 2.0.0 del agente New Relic Node.js, el módulo nativo se ha convertido en una dependencia opcional que intenta instalarse automáticamente.
Durante la instalación, el módulo nativo primero intenta compilar desde el código fuente en la máquina de destino. Si la compilación falla, Node.js genera un rastreo del stack en la consola que normalmente puedes ignorar. Para entornos Linux que ejecutan versiones compatibles de Node, el agente intenta descargar e instalar un binario prediseñado.
Es posible evitar que el agente intente descargar e instalar un binario prediseñado. En cambio, solo intentará construir el módulo nativo. Haga esto configurando la variable de entorno NR_NATIVE_METRICS_NO_DOWNLOAD en true antes de la instalación con npm o Yarn.
$export NR_NATIVE_METRICS_NO_DOWNLOAD=true$npm install @newrelic/native-metrics$yarn add @newrelic/native-metricsAlternativamente, use el indicador --no-download que funciona con npm.
$npm install @newrelic/native-metrics --no-downloadSi la compilación falla con NR_NATIVE_METRICS_NO_DOWNLOAD=true o el indicador --no-download configurado, no se instalará el módulo nativo opcional.
Si se establecen ambas variables de entorno, NR_NATIVE_METRICS_NO_BUILD anulará NR_NATIVE_METRICS_NO_DOWNLOAD.
Si está utilizando una versión anterior, actualice a la última versión del agente o instale el módulo nativo manualmente:
Asegúrese de que esté instalada una versión compatible de Node.js. Recommendation: Utilice la última versión LTS. No utilice versiones inferiores a la versión mínima admitida para el módulo
@newrelic/native-metrics(v4 o superior).Para obtener todas las métricas disponibles actualmente, asegúrese de ejecutar el módulo
newrelicpara el agente 1.37.0 o superior.Windows users: Ejecute el siguiente comando:
bash$npm install --global windows-build-toolsSi este paso no funciona, siga la Opción 2 en el módulo node-gyp en GitHub para obtener instrucciones de instalación manual.
Para instalar el módulo métrico nativo, utilice cualquiera de estos métodos:
Ejecute el comando
npm install @newrelic/native-metrics --save.O
Agregue el módulo al archivo
package.jsonde su aplicación.
Reinicia tu aplicación.
El agente de Node.js detecta automáticamente si el módulo nativo métrica está instalado y comienza a utilizarlo. Si desea evitar por completo la instalación del módulo nativo, puede utilizar los siguientes argumentos npm o Yarn.
$npm install newrelic --no-optional$yarn add newrelic --ignore-optionalBinarios prediseñados
Para omitir el paso de compilación e intentar descargar solo un binario prediseñado y evitar ver errores de compilación en la consola, configure la variable de entorno NR_NATIVE_METRICS_NO_BUILD en true antes de la instalación.
$export NR_NATIVE_METRICS_NO_BUILD=trueSi trabaja detrás de un firewall, puede almacenar en caché los archivos binarios prediseñados configurando las variables de entorno NR_NATIVE_METRICS_DOWNLOAD_HOST y NR_NATIVE_METRICS_REMOTE_PATH antes de la instalación.
$export NR_NATIVE_METRICS_DOWNLOAD_HOST=http://your-internal-cache/$export NR_NATIVE_METRICS_REMOTE_PATH=path/to/download/folder/Una vez que haya configurado las variables de entorno, la instalación puede continuar.
$npm install @newrelic/native-metrics$yarn add @newrelic/native-metricsVer datos de la máquina virtual (VM) de Node.js
Para ver gráficos seleccionados con datos de máquina virtual (VM) de Node.js, vaya a one.newrelic.com > All capabilities > APM & services > (select an app) > Node VMs. Para obtener más información, consulte la página de estadísticas de la máquina virtual (VM) de Node.js.
Los datos también están disponibles en métrica y evento.
Detalles de medición
Sugerencia
No todos los datos se pueden recopilar en todas las versiones de Node.js. En general, obtendrá los datos más completos si tiene la versión LTS más reciente de Node.