- 1.1 序言
- 1.2 原理
- 1.3 开发必读
- 1.4 入门指引
- 1.4.1 特性
- 1.4.2 简单的开发示例
- 1.5 安装
- 1.5.1 环境要求
- 1.5.2 下载安装
- 1.5.3 启动停止
- 1.6 开发流程
- 1.6.1 开发前必读
- 1.6.2 目录结构
- 1.6.3 开发规范
- 1.6.4 基本流程
- 1.7 通讯协议
- 1.7.1 通讯协议作用
- 1.7.2 定制通讯协议
- 1.7.3 一些例子
- 1.8 Worker类
- 1.8.1 构造函数
- 1.8.2 属性
- 1.8.2.1 id
- 1.8.2.2 count
- 1.8.2.3 name
- 1.8.2.4 protocol
- 1.8.2.5 transport
- 1.8.2.6 reusePort
- 1.8.2.7 connections
- 1.8.2.8 stdoutFile
- 1.8.2.9 pidFile
- 1.8.2.10 logFile
- 1.8.2.11 user
- 1.8.2.12 reloadable
- 1.8.2.13 daemonize
- 1.8.2.14 globalEvent
- 1.8.3 回调属性
- 1.8.3.1 onWorkerStart
- 1.8.3.2 onWorkerReload
- 1.8.3.3 onConnect
- 1.8.3.4 onMessage
- 1.8.3.5 onClose
- 1.8.3.6 onBufferFull
- 1.8.3.7 onBufferDrain
- 1.8.3.8 onError
- 1.8.4 接口
- 1.8.4.1 runAll
- 1.8.4.2 stopAll
- 1.8.4.3 listen
- 1.9 TcpConnection类
- 1.9.1 属性
- 1.9.1.1 id
- 1.9.1.2 protocol
- 1.9.1.3 worker
- 1.9.1.4 maxSendBufferSize
- 1.9.1.5 defaultMaxSendBufferSize
- 1.9.1.6 defaultMaxPackageSize
- 1.9.2 回调属性
- 1.9.2.1 onMessage
- 1.9.2.2 onClose
- 1.9.2.3 onBufferFull
- 1.9.2.4 onBufferDrain
- 1.9.2.5 onError
- 1.9.3 接口
- 1.9.3.1 send
- 1.9.3.2 getRemoteIp
- 1.9.3.3 getRemotePort
- 1.9.3.4 close
- 1.9.3.5 destroy
- 1.9.3.6 pauseRecv
- 1.9.3.7 resumeRecv
- 1.9.3.8 pipe
- 1.10 AsyncTcpConnection类
- 1.10.1 __construct
- 1.10.2 connect
- 1.10.3 reconnect
- 1.10.4 transport
- 1.11 AsyncUdpConnection类
- 1.11.1 __construct
- 1.11.2 connect
- 1.11.3 send
- 1.11.4 close
- 1.12 Timer定时器类
- 1.12.1 add
- 1.12.2 del
- 1.12.3 定时器注意事项
- 1.14 调试
- 1.14.1 基本调试
- 1.14.2 status命令查看运行状态
- 1.14.3 调试busy进程
- 1.14.4 网络抓包
- 1.14.5 跟踪系统调用
- 1.15 常用组件
- 1.15.1 GlobalData数据共享组件
- 1.15.1.1 GlobalDataServer
- 1.15.1.2 GlobalDataClient
- 1.15.1.2.1 add
- 1.15.1.2.2 cas
- 1.15.1.2.3 increment
- 1.15.2 Channel分布式通讯组件
- 1.15.2.1 ChannelServer
- 1.15.2.2 channelClient
- 1.15.2.2.1 connect
- 1.15.2.2.2 on
- 1.15.2.2.3 publish
- 1.15.2.2.4 unsubsribe
- 1.15.2.3 例子-集群推送
- 1.15.2.4 例子-分组发送
- 1.15.3 FileMonitor文件监控组件
- 1.15.4 MySQL组件
- 1.15.4.1 workerman/mysql
- 1.15.4.2 react/mysql(异步)
- 1.15.4.3 其它数据库类
- 1.15.5 redis组件
- 1.15.5.1 react/redis
- 1.15.6.1 workerman/http-client
- 1.15.6.2 react/http-client
- 1.15.7 异步消息队列组件
- 1.15.7.1 react/zmq
- 1.15.7.2 react/stomp
- 1.15.8 异步MQTT组件
- 1.15.8.1 workemran/mqtt
- 1.15.9.1 react/dns
- 1.15.10 memcache
- 1.16 常见问题
- 1.16.1 心跳
- 1.16.2 客户端连接失败原因
- 1.16.3 是否支持多线程
- 1.16.4 与其它框架整合
- 1.16.5 运行多个workerman
- 1.16.6 支持哪些协议
- 1.16.7 如何设置进程数
- 1.16.8 查看客户端连接数
- 1.16.9 对象和资源的持久化
- 1.16.10 例子无法工作
- 1.16.11 启动失败
- 1.16.12 停止失败
- 1.16.13 支持多少并发
- 1.16.14 更改代码不生效
- 1.16.15 向指定客户端发送数据
- 1.16.16 如何主动推送消息
- 1.16.17 在其它项目中推送
- 1.16.18 如何实现异步任务
- 1.16.19 status里send_fail的原因
- 1.16.20 Windows下开发Linux下部署
- 1.16.21 是否支持socket.io
- 1.16.22 终端关闭导致workerman关闭
- 1.16.23 与nginx apache的关系
- 1.16.24 禁用函数检查
- 1.16.25 平滑重启原理
- 1.16.26 为Flash开843端口
- 1.16.27 如何广播数据
- 1.16.28 如何建立udp服务
- 1.16.29 监听ipv6
- 1.16.30 关闭未认证的连接
- 1.16.31 传输加密-ssl/tls
- 1.16.32 创建wss服务
- 1.16.33 创建https服务
- 1.16.34 workerman作为客户端
- 1.16.35 作为ws/wss客户端
- 1.16.36 微信小程序
- 1.16.37 PHP的几种回调写法
- 1.16.38 透过代理获取客户端真实ip
- 1.16.39 开机启动
- 1.16.40 接收和发送16进制数据
- 1.16.41 接收一定请求后重启
- 1.16.42 win下初始化多个worker
- 1.17.1 优化Linux内核
- 1.17.2 压力测试
- 1.17.3 安装扩展
- 1.17.4 websocket协议
- 1.17.5 ws协议
- 1.17.6 text协议
- 1.17.7 frame协议
- 1.17.8 不支持的函数/特性
1.14.2 status命令查看运行状态
运行 php start.php status
可以查看到WorkerMan的运行状态,类似如下:
----------------------------------------------GLOBAL STATUS----------------------------------------------------
Workerman version:3.5.13 PHP version:5.5.9-1ubuntu4.24
start time:2018-02-03 11:48:20 run 112 days 2 hours
load average: 0, 0, 0 event-loop:WorkermanEventsLibevent
4 workers 11 processes
worker_name exit_status exit_count
ChatBusinessWorker 0 0
ChatGateway 0 0
Register 0 0
WebServer 0 0
----------------------------------------------PROCESS STATUS---------------------------------------------------
pid memory listening worker_name connections send_fail timers total_request qps status
18306 2.25M none ChatBusinessWorker 5 0 0 11 0 [idle]
18307 2.25M none ChatBusinessWorker 5 0 0 8 0 [idle]
18308 2.25M none ChatBusinessWorker 5 0 0 3 0 [idle]
18309 2.25M none ChatBusinessWorker 5 0 0 14 0 [idle]
18310 2M websocket://0.0.0.0:7272 ChatGateway 8 0 1 31 0 [idle]
18311 2M websocket://0.0.0.0:7272 ChatGateway 7 0 1 26 0 [idle]
18312 2M websocket://0.0.0.0:7272 ChatGateway 6 0 1 21 0 [idle]
18313 1.75M websocket://0.0.0.0:7272 ChatGateway 5 0 1 16 0 [idle]
18314 1.75M text://0.0.0.0:1236 Register 8 0 0 8 0 [idle]
18315 1.5M http://0.0.0.0:55151 WebServer 0 0 0 0 0 [idle]
18316 1.5M http://0.0.0.0:55151 WebServer 0 0 0 0 0 [idle]
----------------------------------------------PROCESS STATUS---------------------------------------------------
Summary 18M - - 54 0 4 138 0 [Summary]
说明
GLOBAL STATUS
从这以栏中我们可以看到
WorkerMan的版本version:3.5.13
启动时间 2018-02-03 11:48:20
,运行了run 112 days 2 hours
服务器负载 load average: 0, 0, 0
,分别是最近1分钟、5分钟、15分钟内系统的平均负载
使用的IO事件库,event-loop:WorkermanEventsLibevent
4 workers
(3种进程,包括ChatGateway、ChatBusinessWorker、Register进程、WebServer进程)
11 processes
(共11个进程)
worker_name
(worker进程名)
exit_status
(worker进程退出状态码)
exit_count
(该状态码的退出次数)
一般来说exit_status为0表示为正常退出,如果为其它值,代表进程是异常退出的,并产生一条类似WORKER EXIT UNEXPECTED
错误信息,错误信息会记录到Worker::logFile指定的文件中。
常见的exit_status及其含义如下:
- 0:表示正常退出,运行reload平滑重启后会出现值为0的退出码,是正常现象。注意在程序中调用exit或die也会导致退出码为0,并产生一条
WORKER EXIT UNEXPECTED
错误信息,workerman中不允许业务代码调用exit或者die语句。 - 9:表示进程被SIGKILL信号杀死了。这个退出码主要发生在stop以及reload平滑重启时,导致这个退出码的原因是由于子进程没有在规定时间内响应主进程reload信号(例如mysql、curl等长时间阻塞等待或者业务死循环等),被主进程强制使用SIGKILL信号杀死。注意,当在linux命令行中使用kill命令发送SIGKILL信号给子进程也会导致这个退出码。
- 11:表示php发生了coredump,一般是使用了不稳定的扩展导致,请在php.ini中把对应扩展注释掉;另外有少数情况是php的bug,这时需要升级php
- 65280:导致这个退出码的原因是业务代码有致命错误,例如调用了不存在的函数、语法错误等,具体错误信息会记录到 Worker::logFile 指定的文件中,也可以在php.ini中error_log指定的文件中(如果有指定的话)找到。
- 64000:导致这个退出码的原因是业务代码抛出了异常,但业务没有捕获这个异常,导致进程退出。如果workerman以debug方式运行时异常调用栈会打印到终端,daemon方式运行时异常调用栈会记录到 Worker::stdoutFile 指定的文件中。
PROCESS STATUS
pid:进程pid
memory:该进程当前占用内存(不包括php自身可执行文件的占用的内存)
listening:传输层协议及监听ip端口。如果不监听任何端口则显示none。参见 Worker类构造函数
worker_name:该进程运行的服务服务名,见 Worker类name属性
connections:该进程当前有多少个TCP连接。connections的计数不一定与客户端连接数相等,例如GatewayWorker中Gateway进程的connections计数包含了客户端连接数和Gateway与Worker内部通讯连接数。
total_request:表示该进程从启动到现在一共接收了多少个请求。这里的请求数不仅包含客户端发来的请求,也包含Workerman内部通讯请求,例如GatewayWorker架构里Gateway与BusinessWorker之间的通讯请求。
send_fail:该进程向客户端发送数据失败次数,失败原因一般为客户端连接断开,此项不为0一般属于正常状态,参见status里send_fail的原因
timers:该进程活动的定时器数量(不包括被删除的定时器以及已经运行过的一次性定时器)。注意:此特性需要workerman版本>=3.4.7。
qps:当前进程每秒收到的网络请求数,注意:只有status时加-d
才会统计此选项,否则显示0。此特性需要workerman版本>=3.5.2。
status: 进程状态,如果是idle代表空闲,如果是busy代表是繁忙。注意:如果进程进入短暂的繁忙是正常情况,如果进程一直是繁忙状态,则有可能发生了业务阻塞或者业务死循环的情况,需要根据调试busy进程一节排查。注意:此特性需要workerman版本>=3.5.0。
原理
status脚本运行后,主进程会向所有worker进程发送一个SIGUSR2
信号,随后status脚本进入短暂的睡眠阶段,以便等待各个worker进程状态统计结果。这时空闲的worker进程收到SIGUSR2
信号后会立刻向特定的磁盘文件写入自己的运行状态(连接数、请求数等等),而正在处理业务逻辑的worker进程,则会等待业务逻辑处理完毕才会去写入自己的状态信息。短暂睡眠后,status脚本开始读取磁盘中的状态文件,并展示结果到控制台。
注意
status 时可能会发现有些进程显示busy,原因是由于进程忙于处理业务(例如业务逻辑长时间阻塞在curl或者数据库请求上,或者运行大的循环),无法将状态上报,导致显示busy。
出现这种问题需要排查业务代码,看哪里导业务致长时间阻塞,并且评估阻塞耗时是否在预期内,如果不符合预期需要根据调试busy进程一节排查业务代码。
如果你对这篇内容有疑问,欢迎到本站社区发帖提问 参与讨论,获取更多帮助,或者扫码二维码加入 Web 技术交流群。
绑定邮箱获取回复消息
由于您还没有绑定你的真实邮箱,如果其他用户或者作者回复了您的评论,将不能在第一时间通知您!
发布评论