帮助手册 APM Node.js 安装 Node.js 代理

安装 Node.js 代理

要安装 APM Insight Node.js 代理,请按照以下说明进行操作。

注意:下面给出的说明适用于 APM insight Node.js 代理版本 2.0。

有关 APM Insight 代理版本 1.0 的安装说明,请参阅此处。 

安装步骤:

  1. 打开您的 Node.js 应用程序。
  2. 访问节点数据包管理器 (NPM)。
  3. 使用命令npm i apminsight --save 从 NPM 安装 APM Insight Node.js 代理。这将在node_modules下创建一个 APM Insight 目录。
  4. 在与应用程序启动文件相同的目录中创建一个名为apminsightnode.json的新文件。在文件中添加以下代码片段。
    {licenseKey : '<license-key>',
    appName : '<application-name>',
    port : <application-port> }

    如果使用代理:
    {licenseKey : '<license-key>',
    appName : '<application-name>',
    port : <application-port>,
    proxyServerHost : '<proxy-server>',
    proxyServerPort : <proxy-port>,
    proxyAuthUser : '<proxy-user-name>',
    proxyAuthPassword : '<proxy-password>'}
  5. 在 Node.js 应用程序启动文件的第一行中包含以下代码。
    如果使用 Common JS:

    require('apminsight')()
    如果使用 ES:
    import apminsight from 'apminsight';
    apminsight.config()
  6. 将许可密钥复制并粘贴到 apminsightnode.json 文件中。
  7. 重新启动您的应用程序并进行少量事务以查看 APM Insight 客户端中的数据。 
注意:
  • 如果您无法在 apminsightnode.json 文件中添加应用程序端口,您可以将其添加到您的应用程序启动文件中,如下所述。但是,其他参数(如许可密钥和应用程序名称)应仅添加到 apminsightnode.json 文件中。
    在应用程序启动文件中添加应用程序端口:
require(‘apminsight’)
(
{port:<application port>}
)
  • 您可以使用以下许可密钥将许可密钥、应用程序名称和端口等配置值设置为环境变量:
    • License key - APMINSIGHT_LICENSE_KEY 
    • Appname - APMINSIGHT_APP_NAME 
    • Port - APMINSIGHT_APP_PORT

APM Insight Node.js 版本 1.xx:

我们强烈建议您下载最新版本的 APM Insight Node.js 代理。但如果您想下载代理版本 1.xx,出于某些特定原因,请参考以下给出的步骤。 

安装说明 - 代理版本 1.xx

  1. 打开您的 Node.js 应用程序。
  2. 访问节点数据包管理器 (NPM)。
  3. 使用命令npm i apminsight --save从 NPM 安装 APM Insight Node.js 代理。这将在 node_modules 下创建一个 APM Insight 目录。
  4. 在您的 Node.js 应用程序启动文件的第一行中包含以下代码:
    require('apminsight')({
    licenseKey : '<device-key>',
    appName : '<application-name>',
    port : <application-port>
    })
    示例: require('apminsight')({
    licenseKey : 'sdafokjsoamdomkoamds',
    appName : 'myapp',
    port : 3000
    })
  5. 如果您使用代理连接,请输入此代码:
    require('apminsight')({
    licenseKey : '<device-key>',
    appName : '<application-name>',
    port : <application-port>  
    proxyServerHost : '<proxy-server>',
    proxyServerPort : <proxy-port>,
    proxyAuthUser : '<proxy-user-name>',
    proxyAuthPassword : '<proxy-password>' })

注意:您可以通过登录 Site24x7 然后转到管理>开发人员>设备密钥来找到您的许可密钥。

  1. 重新启动您的应用程序。

 

帮助手册 APM Node.js 安装Node.js agent