Instalar el agente de APM Insight Node.js


Para instalar el agente APM Insight Node.js, siga las instrucciones que se dan a continuación:

  1. En la pestaña APM Insight del cliente web de Applications Manager > Tarjeta de ayuda > copie la clave de licencia que se encuentra allí.
  2. Descargue el archivo del agente APM Insight Node.js (apm_insight_agent_nodejs.zip) de la página de descarga y extráigalo en el servidor Node.js.
  3. Abra su aplicación Node.js.
  4. Acceda al administrador de paquetes de nodos (NPM).
  5. Utilice el siguiente comando para instalar un agente APM Insight Node.js desde NPM.

    npm install <Node.js-Agent-unzipped-path>/agent_minified

    Ejemplo:

    npm install /users/joe/agent_minified

    Si desea implementar el agente APM Insight en todas las aplicaciones de Node.js en la computadora, use la opción global a través del indicador -g .

    npm install -g <Node.js-Agent-unzipped-path>/agent_minified

    Ejemplo:

    npm install -g /users/joe/agent_minified

    Esto creará un directorio de APM Insight en node_modules .

  6. Incluya el siguiente código en la primera línea del código fuente de su aplicación Node.js, antes de cualquier otra declaración require. Reemplace las variables con los valores de su configuración. 

    require('apminsight')({
      licenseKey : '[LICENSE-KEY]',
      appName : '[APPLICATION-NAME]',
      port : [APPLICATION-PORT],
      apmHost: '[APM-HOST-NAME]',
      apmPort: [APM-SSL-PORT]
    })

    Ejemplo:

    require('apminsight')({
      licenseKey : 'APMI_ee42094f83dd841d16b9c56796c22b63bef00ac6918f547280947d1f6c2be1ea',
      appName : 'Insight_NodeJS',
      port : 3000,
      apmHost: 'localhost',
      apmPort: 8443 
    })

  7. Si usa conexiones proxy, ingrese este código en su lugar:

    require('apminsight')({
      licenseKey : '[LICENSE-KEY]',
      appName : '[APPLICATION-NAME]',
      port : [APPLICATION-PORT],
      apmHost: '[APM-HOST-NAME]',
      apmPort: [APM-SSL-PORT]
      proxyServerHost : '[PROXY-SERVER]',
      proxyServerPort : [PROXY-PORT],
      proxyAuthUser : '[PROXY-USERNAME]',
      proxyAuthPassword : '[PROXY-PASSWORD]'
    })

  8. Guarde el archivo y reinicie su aplicación.

Nota:
1. El agente de APM Insight Nodejs es incompatible con otras herramientas de creación de perfiles, como ejecutar el proceso de nodo con el modo de depuración (conmutador --inspect). 
2. Si su aplicación utiliza el módulo de clúster, coloque la instrucción require en los procesos maestro y trabajador.