Configuración del Agente de Node.js

Debe añadir un recopilador de datos de agente a la aplicación Node.js y reiniciarlo para que el agente pueda empezar a supervisar la aplicación.

1. Asegúrese de que el ID de usuario que se utiliza para ejecutar el servidor de aplicaciones tiene permiso completo en el directorio dir_instalación del agente.
2. Vaya al directorio dir_instalación/bin y ejecute el mandato siguiente:

   ./nodejs-agent.sh config

3. Siga las solicitudes para especificar valores para las siguientes opciones de configuración:

   KNJ_NODEJS_RUNTIME_BIN_LOCATION

   El directorio a la carpeta bin del tiempo de ejecución de Node.js. El directorio predeterminado es /usr/local/bin.

   KNJ_NPM_RUNTIME_BIN_LOCATION

   El directorio a la carpeta bin del mandato npm. El directorio predeterminado es /usr/local/bin.

   KNJ_NPM_LIB_LOCATION

   El directorio a la carpeta lib del directorio de instalación global del paquete npm. El directorio predeterminado es /usr/local/lib. Por ejemplo, si instala el paquete npm ejecutando el mandato npm install -g, el paquete se instala en /inicio_nodejs/lib/node_modules y KNJ_NPM_LIB_LOCATION es /inicio_nodejs/lib.

   CP_PORT

   El puerto que el agente utiliza para escuchar los datos de los clientes de socket. El valor 0 indica que se utilizará un puerto efímero. El valor predeterminado es 63336.

   Nota: no utilice un número de puerto que ya se utilice en el sistema. Para comprobar si el puerto ya se está utilizando, ejecute el mandato netstat -apn | grep número_puerto.

4. Inicie el agente ejecutando el mandato siguiente:

   ./nodejs-agent.sh start

5. Compruebe que el Agente de Node.js se ha iniciado correctamente. Si el agente se ha iniciado correctamente, se generará la carpeta KNJ_NPM_LIB_LOCATION/node_modules/ibmapm.
6. En función de la oferta de que disponga y sus requisitos, inserte una de las entradas siguientes en el archivo .js de la aplicación Node.js para configurar los recopiladores de datos de agente:
   Nota: sólo puede añadirse una entrada a la aplicación Node.js para habilitar las prestaciones de recopilador de datos de agente. Además, si habilita prestaciones que no estén incluidas en la oferta, puede producirse una sobrecarga innecesaria, disminuyendo la eficiencia de ejecución de la aplicación.
   • Si sólo dispone de prestaciones de supervisión de recursos, puede añadir el recopilador de datos de recurso. Para añadirlo, inserte la línea siguiente al principio del archivo de aplicación Node.js:

     require('KNJ_NPM_LIB_LOCATION/node_modules/ibmapm');

     Si el valor de KNJ_NPM_LIB_LOCATION en el entorno es /usr/local/lib, la línea será

     require('/usr/local/lib/node_modules/ibmapm');

   • Si dispone de prestaciones de diagnóstico además de las prestaciones de supervisión a nivel de recurso, puede elegir añadir uno de los siguientes recopiladores de datos de agente:
     • Para añadir el recopilador de datos de rastreo de método, inserte la línea siguiente al principio del archivo de aplicación Node.js:

       require('KNJ_NPM_LIB_LOCATION/node_modules/ibmapm/methodtrace.js');

     • Para añadir el recopilador de datos de diagnóstico, inserte la línea siguiente al principio del archivo de aplicación Node.js:

       require('KNJ_NPM_LIB_LOCATION/node_modules/ibmapm/deepdive.js');

     • Para añadir el recopilador de datos de supervisión de recursos, inserte la línea siguiente al principio del archivo de aplicación Node.js:

       require('KNJ_NPM_LIB_LOCATION/node_modules/ibmapm');

     Para garantizar el mejor rendimiento, añada el recopilador de datos de rastreo de método sólo a efectos de depuración.

   Nota: El código de los plug-ins cambia a partir de Cloud APM Marzo de 2017. Si actualiza el agente desde versiones anteriores, debe actualizar el código de los recopiladores de datos existentes en las aplicaciones para que la capacidad de supervisión funcione correctamente.
7. Reinicie la aplicación Node.js para inhabilitar los plug-in de recopilador de datos de agente.