@alicloud/agenthub

2.0.1 • Public • Published

agenthub

agenthub 是由 Node.js 性能平台提供的 agent 命令程序,用于协助您的 Node 应用性能数据上报和问题诊断。

  • Build Status
  • dependencies Status

安装

$ npm install @alicloud/agenthub -g

以上命令会将 agenthub 安装为一个全局的命令行工具。

使用

agenthub 需要一个配置文件来进行使用,agenthub 仅会在配置指定下的目录执行命令或读取日志。

极简配置

最简单的配置只需要传入 appid 和 secret 即可,格式如下:

{
  "appid": "<YOUR APPID>",
  "secret": "<YOUR SECRET>",
}

保存为 config.json ,完成配置后,请使用以下命令进行执行:

$ nohup agenthub config.json &

agenthub 将以常驻进程的方式执行。部署完成后,请访问 https://node.console.aliyun.com/ 查看您的应用详情。如果一切正常,稍等片刻(1分钟)即可收到你的应用性能数据。

启动 agenthub

在 agenthub 2.0 中,我们可以不依赖 nohup 命令即可实现启动,启动命令如下:

$ agenthub start config.json
agenthub has started(pid: 60039).
// 如需查看日志
$ cat ~/.agenthub.log

查看运行的 agenthub

$ agenthub list
|- App ID -|- PID -|---- Start Time -----|--- Config Path ------------------------------------|
|      886 | 60039 | 2018-03-09 15:15:19 | /path/to/config.json |
|----------|-------|---------------------|----------------------------------------------------|

关闭 agenthub

$ agenthub stop all
$ agenthub stop <appid>

详细配置

详细配置如下所示:

{
  "server": "<SERVER IP>:8080",
  "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的路径",
    "可选"
  ]
}

error_log 配置完成后您可以在 Node.js 性能平台上看到规整后的错误日志信息;packages 配置完成后您可以看到项目的版本依赖,以及对应的安全风险提示。

配置中的#YYYY#、#MM#、#DD#、#HH#是通配符,如果您的异常日志是按时间生成的,请使用它。

联系我们

所有使用中遇到的问题,请咨询钉钉群:11794270。

License

MIT

Readme

Keywords

Package Sidebar

Install

npm i @alicloud/agenthub

Weekly Downloads

1,455

Version

2.0.1

License

MIT

Unpacked Size

13.8 kB

Total Files

8

Last publish

Collaborators

  • console-fe
  • aliyunsdkteam
  • pagecao
  • fengmk2
  • jacksontian