Deliverer 正在参加 2021 年度 OSC 中国开源项目评选,请投票支持!
Deliverer 在 2021 年度 OSC 中国开源项目评选 中已获得 {{ projectVoteCount }} 票,请投票支持!
2021 年度 OSC 中国开源项目评选 正在火热进行中,快来投票支持你喜欢的开源项目!
2021 年度 OSC 中国开源项目评选 >>> 中场回顾
Deliverer 获得 2021 年度 OSC 中国开源项目评选「最佳人气项目」 !
授权协议 GPL
开发语言 PHP 查看源码 »
操作系统 跨平台
软件类型 开源软件
开源组织
地区 国产
适用人群 未知
收录时间 2021-08-31

软件简介

Deliverer 是一个 PHP 项目调度追踪工具,主要用于线上故障排查。

使用场景

  1. 如果你有一些老的 PHP (PHP5 和 PHP7)项目,对线上一个项目运行逻辑不熟悉;
  2. 或者你对某个方法的调用来源不清楚;
  3. 又或者线上有一个接口不知道是哪里异常退出了;
  4. 还有线上调用特别耗时,都比较适合使用 Deliverer 来解决,帮助你避免跑路。

使用方法

  • 可以根据函数名类名方法名路由来过滤输出
  • 可以在查询到指定过滤内容 n 次之后退出
  • 可以根据 request id 回放细看整个完整的调用链
  • 过滤的内容会高亮显示
  • 调用栈比较深的可以指定 -l 来隐藏深度调用的展示

原理

其实比较简单,分两步,第一步收集日志,第二步分析日志。

第一步

PHP_MINIT阶段,通过zend_set_user_opcode_handler 来设置对 ZEND_DO_UCALL 、ZEND_DO_FCALL_BY_NAMEZEND_DO_FCALL 三类 opcode 的处理分析。

注意其中会涵盖一些内置函数和方法的调用,我们可以通过类型进行过滤。

然后在PHP_RINIT阶段新建日志文件,写入请求的信息

pid-ts sapi http_method http_url

请求过程中在自定义的 handler 里面打印调用栈信息

最后在PHP_RSHUTDOWN关闭日志文件的写入

第二步

对收集好的日志,利用bin/deliverer进行分析和整理,这块是 php 脚本,就不赘述了。

安装使用

下载

$ sudo wget http://github.com/zhoumengkang/deliverer/archive/refs/tags/1.0.4.zip
$ unzip 1.0.4.zip
$ rm -f 1.0.4.zip
$ cd deliverer-1.0.4/extension

编译

$ whereis phpize
phpize: /usr/bin/phpize /usr/share/man/man1/phpize.1.gz

# 如果前面的路径(/usr/bin)在环境变量里,也可以简写为 phpize,如果不太懂,直接复制执行
$ /usr/bin/phpize

$ whereis php-config
php-config: /usr/bin/php-config /usr/share/man/man1/php-config.1.gz

$ ./configure --with-php-config=/usr/bin/php-config
$ make && sudo make install

配置 php.ini

$ php -i|grep php.ini
Configuration File (php.ini) Path => /etc
Loaded Configuration File => /etc/php.ini

# 编辑 /etc/php.ini 文件
$ sudo vim /etc/php.ini
# 文件末尾增加以下两行
[deliverer]
extension=deliverer.so

重启 php-fpm

sudo service php-fpm restart

使用分析工具

可以移动./bin/deliverer到你觉得合适的目录,假如在当前目录

# 回到文件的解压目录,开启监听
$ cd ..
$ ./bin/deliverer -t

用一段我自己很久之前的祖传代码(我的博客)来跑下

$ ./bin/deliverer -t

这样会一直监控所有的 php 进程的执行

$ ./bin/deliverer -tAction::initUser -n3 -l5


参数 解释
-t Action::initUser 过滤包含该调用的请求
-n 3 统计三次然后退出
-l 5 函数(方法)调用深度显示,最多显示 5 层,超出部分在末尾标出
$ ./bin/deliverer -v7979-1624369150991941

通过 -v requestId 来详细查看完整调用栈

$ ./bin/deliverer -tSqlExecute::getAll -n1 -l3

当要查询方法,函数调用栈过深,不在层级查询范围之内,则其外层调用显示红色

PHP 祖传代码拯救者 Deliverer 他,来了!

展开阅读全文

代码

的 Gitee 指数为
超过 的项目

评论 (0)

加载中
更多评论
暂无内容
发表了博客
2015/10/10 14:58

源码编译heka遇到的问题

报错: 1.heka/build/ep_base/Build/lua_sandbox/ep_base/Source/lua_sax/src/symtseries.c:766: 错误:“win” 在使用前可能未初始化 解决方法: size_t n_values = 32; size_t prev_fin, new_fin; size_t w = 8; unsigned char c = 6; sts_window win=sts_new_window(n_values, w, c); 2. 2015/10/10 14:49:00 Loading input failed: exec: "go": executable file not found in $PATH make[2]: *** [heka/src/github.com/mozi...

0
0
发表于AI & 大数据专区
2020/01/28 22:21

聊聊artemis的scheduledDeliveryTime

## 序 本文主要研究一下artemis的scheduledDeliveryTime ## HDR_SCHEDULED_DELIVERY_TIME activemq-artemis-2.11.0/artemis-core-client/src/main/java/org/apache/activemq/artemis/core/message/impl/CoreMessage.java ``` public class CoreMessage extends RefCountMessage implements ICoreMessage { //...... @Override public Long getScheduledDeliveryTime() { Object property = getProperties().getProperty(Messag...

0
0
没有更多内容
加载失败,请刷新页面
点击加载更多
加载中
下一页
暂无内容
0 评论
3 收藏
分享
OSCHINA
登录后可查看更多优质内容
返回顶部
顶部