Configuración del Recopilador de datos de Node.js autónomo para aplicaciones locales

Si ha instalado la aplicación Node.js en un entorno local, debe configurar el Recopilador de datos de Node.js para recopilar información sobre la aplicación Node.js.

Antes de empezar

  1. Asegúrese de que la aplicación Node.js puede ejecutarse correctamente de forma local. El Recopilador de datos de Node.js autónomo puede supervisar Node.js V8.0.0 y fixpacks futuros, V10.0.0 y fixpacks futuros y V12.0.0 y fixpacks futuros.
  2. Descargue el paquete de recopilador de datos del sitio web de IBM® Marketplace. Para obtener instrucciones detalladas, consulte Descarga de los agentes y recopiladores de datos.

Procedimiento

  1. Extraiga los archivos del paquete del recopilador de datos. El paquete nodejs_datacollector_8.1.4.0.6.tgz está incluido en el directorio extraído.
  2. Determine el directorio de inicio de la aplicación.
    • Para aplicaciones Node.js típicas, si utiliza el mandato node app.js para iniciar la aplicación Node.js y el archivo principal app.js se encuentra en el directorio /root/nodejs_app, el directorio de inicio de la aplicación es /root/nodejs_app.
    • Para miembros de colectivo en el entorno de IBM API Connect, ejecute el mandato wlpn-server list para visualizar la lista de todos los miembros de colectivo en la misma máquina. El directorio de inicio del miembro de colectivo está en el formato siguiente:
      directorio_usuario/nombre_miembro-colectivo/package
      Por ejemplo, si obtiene /root/wlpn/rock-8345a96-148538-1/package como salida de mandato, /root/wlpn es el directorio de usuario y rock-8345a96-148538-1 es el nombre de miembro de colectivo.
    • Para aplicaciones de Developer Portal en el entorno de IBM API Connect, puede ejecutar el mandato ps -ef | grep node para encontrar el directorio de inicio. Si obtiene la salida de mandato siguiente, por ejemplo, el directorio de inicio es /home/admin/bgsync y el archivo principal de la aplicación es rest_server.js:
      admin 19085 1 0 Jun25 ?  00:06:53 /usr/local/bin/node /home/admin/bgsync/rest_server.js
  3. En el directorio inicial de la aplicación, ejecute el mandato siguiente para extraer archivos del paquete recopilador de datos:
    tar -zxf nodejs_datacollector_8.1.4.0.6.tgz
  4. Extraiga el archivo ibmapm.tgz en la carpeta nodejs_dc ejecutando el mandato siguiente:
    tar -zxf nodejs_dc/ibmapm.tgz
    Obtendrá una carpeta ibmapm.
  5. Ejecute el mandato siguiente para instalar el recopilador de datos en su aplicación:
    npm install ./ibmapm
  6. Añada la línea siguiente al principio del archivo principal de la aplicación Node.js:
    require('ibmapm');
    • Si inicia la aplicación ejecutando el mandato app.js, app.js es el archivo principal de la aplicación.
    • Para miembros de colectivo en el entorno de IBM API Connect, el archivo principal está definido en el archivo package.json, en el directorio de inicio o en sus subcarpetas. De forma predeterminada, el archivo principal es directorio_inicio/server/server.js, donde directorio_inicio es el directorio de inicio del miembro de colectivo.
    • Para aplicaciones de Developer Portal en el entorno de IBM API Connect, puede ejecutar el mandato ps -ef | grep node para buscar el archivo principal. Si obtiene la salida de mandato siguiente, por ejemplo, el archivo principal de la aplicación es rest_server.js.
      admin 19085 1 0 Jun25 ?  00:06:53 /usr/local/bin/node /home/admin/bgsync/rest_server.js
  7. Reinicie la aplicación.
    Consejo:
    • Para reiniciar el miembro de colectivo, ejecute el mandato wlpn-server stop nombre_miembro_colectivo. El miembro de colectivo se reinicia automáticamente después de ejecutar este mandato. Si no se reinicia, ejecute el mandato wlpn-server start nombre_miembro_colectivo para reiniciarlo manualmente.
    • Para reiniciar las aplicaciones de Developer Portal, ejecute primero el mandato /etc/init.d/restservice stop para detener la aplicación y a continuación ejecute el mandato /etc/init.d/restservice start para iniciarla.

Resultados

El recopilador de datos se ha configurado y está conectado al Servidor de Cloud APM.

Qué hacer a continuación

Recuerde: Para añadir su aplicación a la Consola de Cloud APM, elija Node.js Runtime en el editor de aplicaciones.