为本地应用程序配置独立 Node.js 数据收集器

如果已在本地环境中安装 Node.js 应用程序,那么必须配置 Node.js 数据收集器以收集有关 Node.js 应用程序的信息。

开始之前

  1. 确保 Node.js 应用程序可以在本地成功运行。独立 Node.js 数据收集器可监视 Node.js V8.0.0 和未来修订包、V10.0.0 和未来修订包以及 V12.0.0 和未来修订包。
  2. IBM® Passport Advantage® Web 站点下载数据收集器软件包。有关详细指示信息,请参阅下载指示信息
  3. 使用安装 Cloud APM 服务器的系统上的 make_configuration_packages.shconfigure_agent_images.sh 脚本来配置数据收集器软件包。有关详细的指示信息,请参阅配置下载的映像

过程

  1. 从数据收集器软件包抽取文件。已抽取的目录中包含 nodejs_datacollector_8.1.4.0.6.tgz 软件包。
  2. 确定应用程序的主目录。
    • 对于典型 Node.js 应用程序,如果使用 node app.js 命令来启动 Node.js 应用程序,且 app.js 主文件位于 /root/nodejs_app 目录中,那么 /root/nodejs_app 是应用程序的主目录。
    • 对于 IBM API Connect 环境中的集合成员,运行 wlpn-server list 命令以显示同一台机器上的所有集合成员的列表。集合成员的主目录采用以下格式:
      user_directory/collective-member_name/package
      例如,如果命令输出为 /root/wlpn/rock-8345a96-148538-1/package,那么 /root/wlpn 是用户目录,rock-8345a96-148538-1 是集合成员名称。
    • 对于 IBM API Connect 环境中的开发人员门户网站应用程序,可以运行 ps -ef | grep node 命令来查找主目录。例如,假设获得以下命令输出,那么主目录是 /home/admin/bgsync,应用程序的主文件是 rest_server.js
      admin 19085 1 0 Jun25 ?  00:06:53 /usr/local/bin/node /home/admin/bgsync/rest_server.js
  3. 从应用程序的主目录,运行以下命令从数据收集器软件包中抽取文件:
    tar -zxf nodejs_datacollector_8.1.4.0.6.tgz
  4. 通过运行以下命令,解压缩 nodejs_dc 文件夹中的 ibmapm.tgz 文件:
    tar -zxf nodejs_dc/ibmapm.tgz
    这将创建 ibmapm 文件夹。
  5. 运行以下命令将数据收集器安装到应用程序:
    npm install ./ibmapm
  6. 将以下行添加到 Node.js 应用程序的主文件开头:
    require('ibmapm');
    • 如果您通过运行 node app.js 命令来启动应用程序,那么应用程序的主文件是 app.js
    • 对于 IBM API Connect 环境中的集合成员,主文件在主目录或其子文件夹中的 package.json 文件中定义。缺省情况下,主文件是 home_directory/server/server.js,其中,home_directory 是集合成员的主目录。
    • 对于 IBM API Connect 环境中的开发人员门户网站应用程序,可以运行 ps -ef | grep node 命令来查找主文件。例如,假设获得以下命令输出,那么应用程序的主文件是 rest_server.js
      admin 19085 1 0 Jun25 ?  00:06:53 /usr/local/bin/node /home/admin/bgsync/rest_server.js
  7. 重新启动您的应用程序。
    提示:
    • 要重新启动集合成员,请运行 wlpn-server stop collective_member_name 命令。集合成员将在您运行该命令之后自动重新启动。如果没有启动,请运行 wlpn-server start collective_member_name 命令进行手动重新启动。
    • 要重新启动开发人员门户网站应用程序,首先运行 /etc/init.d/restservice stop 命令来停止应用程序,然后运行 /etc/init.d/restservice start 命令进行启动。

结果

此数据收集器已配置完成,并已连接到 Cloud APM 服务器

下一步做什么

切记: 要将应用程序添加到 Cloud APM 控制台中,请在应用程序编辑器中选择 Node.js 运行时