PM2 Node 应用进程管理器入门

2023-05-08  本文已影响0人  羋学僧

PM2简介

PM2是常用的node进程管理工具,它可以提供node.js应用管理,如自动重载、性能监控、负载均衡等。同类工具有Supervisor、Forever等。

pm2是一个进程管理工具,可以用它来管理你的node进程,并查看node进程的状态,当然也支持性能监控,进程守护,负载均衡等功能。pm2基本是Nodejs应用程序不二的守护进程选择,事实上它并不仅仅可以启动Nodejs的程序,只要是一般的脚本的程序它同样可以胜任。

pm2的主要特性

PM2安装

使用PM2需要npm全局安装。

npm install -g pm2

启动PM2项目

直接启动项目

参数说明:

pm2支持直接运行Node.js启动项目,如下:

pm2 start server/index.js

即可启动Node.js应用,成功后会看到打印的信息:

在表格中显示了应用的名称为server、id为0,应用名称和id都可以作为该应用的标识。

通过配置文件管理应用

PM2还支持通过配置文件管理应用,这种方式可以提供更丰富的配置,支持的配置格式是Javascript,JSON和YAML,具体可以查看文档

文件夹结构

PM2启动后,它将自动创建这些文件夹:

在Windows中,HOME环境变量可以是 HOMEDRIVE + $ HOMEPATH

查看应用列表(查看当前机器执行的所有进程)

pm2 list/ls/l

查看某个应用详情(查看某个进程信息)

查看当前机器上id为1的应用的详情

pm2 show app_name|app_id

或者

pm2 describe app_name|app_id

例如:

pm2 show 1

每个参数信息参考:
第一表是指进程的信息,比如status(状态)、restarts(重启次数)、uptime(运行时间)、script path(启动入口的路径)、script args(启动文件的参数)、error log path(错误日志的路径)、out log path(输出日志的路径)、exec mode(进程的模式)、watch&reload(是否开启监听文件变动重启)、unstable restarts(不稳定的重启次数)、heap size(堆内存)、heap usage(堆内存使用率)、used heap size(堆内存使用情况)、event loop latency(事件循环时延)、event loop latency p95(事件循环时延 第95分位)

重启

pm2 restart app.js

或者

pm2 restart app_name|app_name

例如:

pm2 restart 21

停止

停止特定的应用。可以先通过pm2 list获取应用的名字(--name指定的)或者进程id。

pm2 stop app_name|app_id

如果要停止所有应用,可以

pm2 stop all

删除

类似pm2 stop,如下

pm2 delete app_name|app_id
pm2 delete all

日志查看

除了可以打开日志文件查看日志外,还可以通过pm2 logs来查看实时日志。这点对于线上问题排查非常重要。

比如某个node服务突然异常重启了,那么可以通过pm2提供的日志工具来查看实时日志,看是不是脚本出错之类导致的异常重启。

查看指定应用程序日志:

pm2 logs app_name|app_id

例如:

pm2 logs 1

显示所有应用程序的日志:

pm2 logs

另外PM2提供了十分强大的日志管理功能,支持以多种方式查看日志。

指令tab补全

运行pm2 --help,可以看到pm2支持的子命令还是蛮多的,这个时候,自动完成的功能就很重要了。

运行如下命令。恭喜,已经能够通过tab自动补全了。细节可参考这里

pm2 completion install
source ~/.bash_profile

负载均衡

命令如下,表示开启三个进程。如果-i 0,则会根据机器当前核数自动开启尽可能多的进程。

pm2 start app.js -i 3 # 开启三个进程
pm2 start app.js -i max # 根据机器CPU核数,开启对应数目的进程 

参考文档:点击查看

开机自动启动

可以通过pm2 startup来实现开机自启动。细节可参考。大致流程如下

监控CPU/内存

运行如下命令,查看当前通过pm2运行的进程的状态。即可监控CPU和内存的使用情况,同时应用的报错信息也会打印在Global Logs窗口中,如下:

pm2 monit

内存使用超过上限自动重启

如果想要你的应用,在超过使用内存上限后自动重启,那么可以加上--max-memory-restart参数。(有对应的配置项)

pm2 start big-array.js --max-memory-restart 20M

更新pm2

官方文档

$ pm2 save # 记得保存进程状态
$ npm install pm2 -g
$ pm2 update

pm2 + nginx

无非就是在nginx上做个反向代理配置,直接贴配置。

upstream my_nodejs_upstream {
    server 127.0.0.1:3001;
}

server {
    listen 80;
    server_name my_nodejs_server;
    root /home/www/project_root;
    
    location / {
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header Host $http_host;
        proxy_set_header X-NginX-Proxy true;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_max_temp_file_size 0;
        proxy_pass http://my_nodejs_upstream/;
        proxy_redirect off;
        proxy_read_timeout 240s;
    }
}

官方文档

pm2编程接口

如果想把pm2的进程监控,跟其他自动化流程整合起来,pm2的编程接口就很有用了。细节可参考官方文档

模块扩展系统

pm2支持第三方扩展,嵌入了一个简单而强大的模块系统。

安装模块很简单:比如常用的log rotate等。可参考官方文档

 pm2 install <module_name>

保存/冻结进程

在重新启动时保存/冻结进程列表

pm2 save

监听代码变化/自动重启

可以监听代码保存,并更新应用

pm2 start app.js --watch

PM2不止监听app.js文件,还监听了它引用的所有模块,只要任意模块代码进行了保存,如键盘按下ctrl + s,或新建文件,PM2就会进行重启。 如果只想监听指定文件和目录,建议通过配置文件的watchignore_watch字段来设置。

如果需要忽略某些文件,则可以在配置文件中设置,如下:

{
  "watch": ["server", "client"],
  "ignore_watch" : ["node_modules", "client/img"],
  "watch_options": {
    "followSymlinks": false
  }
}
上一篇下一篇

猜你喜欢

热点阅读