阿里云Node.JS性能平台使用记录

阿里云Node.JS性能平台使用记录

1. 安装 Node.js 性能平台运行时
    Node.js 性能平台使用 tnvm 进行版本维护，采用如下命令安装 tnvm。
    wget -O- .sh | bash
    
    将 tnvm 添加到系统命令。根据上面命令最后的提示，针对不同操作系统，进行手工操作。例如 linux 系统下

    source ~/.bashrc
    
    利用 tnvm 安装需要版本的运行时。请参考 Node.js性能平台运行时版本 选择合适的运行时版本。

    查看远端版本
    tnvm ls-remote alinode
    
    安装需要版本：.html?spm=a2c4g.11186623.2.15.31a21c0ep322gE
    请根据版本对应关系，选择合适(与当前应用使用的 Node.js 版本一致)的 alinode 版本。
    tnvm
    
    使用vx.y.z的运行时
    tnvm
    
2. 安装 agenthub
    agenthub 是为 Node.js 性能平台的常驻代理服务，可以帮助执行一些监控和诊断的操作，并且它包含一组 Node.js 性能平台服务执行任务所需要的命令集合，Node.js 性能平台有且仅有执行这些命令的权限。

    agenthub 同时是一个 npm 命令行工具，通过如下命令可以完成安装：
    npm install @alicloud/agenthub -g
    
3. 配置和启动 agenthub
    agenthub 需要一个配置文件来进行使用，agenthub 仅会在配置指定下的目录执行命令或读取日志。
    最简单的配置只需要传入 appid 和 secret 即可，格式如下：

    {
      "appid": "",
      "secret": ""
    }
    其中您的应用 ID 和您的应用 Secret 请在应用设置页面获取。将上述配置保存为 config.json ，完成配置后，请使用以下命令进行执行：
    $ agenthub start config.json
    
    agenthub 将以常驻进程的方式执行，agenthub 运行日志文件为 ~/.agenthub.log 文件中。如果 agenthub 启动不成功，控制台将无法看到系统和进程详细信息，您可以以 DEBUG 方式启动 agenthub，查看 ~/.agenthub.log 日志来确定异常。
    DEBUG=* agenthub start config.json
    
    部署完成后，请访问 / 查看您的应用详情。如果一切正常，稍等片刻（1分钟）即可收到你的应用性能数据。
    
详细配置
详细配置如下所示：

注意: logdir 应该与 启动应用 时设置的环境变量 NODE_LOG_DIR 的值一致。
{
  "appid": "<YOUR APPID>",
  "secret": "<YOUR SECRET>",
  "logdir": "</path/to/your/log/dir>",
  "error_log": [
    "</path/to/your/error.log>",
    "您的应用在业务层面产生的异常日志的路径",
    "例如：/root/.logs/error.#YYYY#-#MM#-#DD#-#HH#.log",
    "可选"
  ],
  "packages": [
    "</path/to/your/package.json>",
    "可以输入多个package.json的路径",
    "可选"
  ],
  "disks": [
    "/",
    "/home/user"
    "可选"
  ],
  "agentidMode": "IP" “可选”
}
error_log 配置完成后您可以在 Node.js 性能平台上看到规整后的错误日志信息；

packages 配置完成后您可以看到项目的版本依赖，以及对应的安全风险提示;

disks 配置需要监控的磁盘，可以在系统监控监控数据查看;

agentidMode 设置为IP时，实例 ID 会添加部分 IP 信息，主要用于多个容器 hostname 相同的场景。
配置中的#YYYY#、#MM#、#DD#、#HH#是通配符，如果您的异常日志是按时间生成的，请使用它。

4. 启动应用
    使用安装好的 Node.js 性能平台的 runtime 启动并监控应用。
    直接启动应用
        NODE_LOG_DIR=/tmp ENABLE_NODE_LOG=YES node app.js
        
    使用pm2管理的应用
        NODE_LOG_DIR=/tmp ENABLE_NODE_LOG=YES pm2 start app.js
        
        NODE_LOG_DIR=/tmp ENABLE_NODE_LOG=YES pm2 start app.js /home/game-server/app.js --name lkpy-server-1 --cwd /home/game-server -- env=development id=lkpy-server-1 127.0.0.1 port=6360 serverType=lkpy roomName=初级场