使用基于 tideways 的 php-monitor 搭建 PHP 性能监控平台

tideways、xhprof、xhgui 介绍

tideways 是一家提供 PHP 应用性能监控相关服务的公司，最主要的产品是 tideways PHP 性能监控扩展，tideways 扩展能够监控请求耗时，SQL 执行耗时，CPU 和内存占用。监控数据存储支持 MySQL 和 MongoDB。

提到 PHP 性能监控，不得不提性能监控工具 xhprof。xhprof 是 facebook 开发并开源的 PHP 性能监控扩展，配合 xhgui 做数据的可视化。但由于 facebook 后期将自家 PHP 替换成 HHVM，xhprof 也不再维护了。之后 tideways 演化出了两个分支，一个是原本的 tideways 扩展，一个是继承自 xhprof 的 tideways_xhprof 扩展，tideways_xhprof 内的功能与 xhprof 一致。在演化成两个分支后，原有的 tideways 逐渐演化成了付费的 SaaS 服务，而 tideways_xhprof 兼容了 xhprof 的一些使用习惯，并会一直维护。

产生分支前的最后一个版本：https://github.com/tideways/php-xhprof-extension/tree/v4.1.7

产生分支后的第一个版本：https://github.com/tideways/php-xhprof-extension/tree/v5.0-beta1

php-monitor 介绍

在 xhprof 不维护之后，其对应的数据可视化 xhgui 也就随之不再更新。php-monitor 的作者最开始是为了做一版汉化的 xhgui：xhgui-branch。之后作者又结合 tideways 扩展做了 php-monitor，一个 PHP 性能监控平台，同时支持监控数据收集和数据可视化展示。

配置过程

tideways 扩展

先安装 tideways 扩展。如果使用 PHP 5.6，请下载 tideways v4.1.5。如果使用 PHP7+ ，请下载 v4.1.7（更高的版本无法显示 SQL）。

wget --no-check-certificate https://github.com/tideways/php-xhprof-extension/archive/v4.1.7.tar.gz && tar zxvf v4.1.7.tar.gz && cd php-xhprof-extension-4.1.7 && phpize && ./configure && make && sudo make install

项目中引入 php-monitor

首先要明确，php-monitor 包含两部分，数据收集和数据可视化。数据收集需要将 php-monitor 整合进项目中，数据可视化部分则单独部署。这两块的数据部分互通即可。

之后尝试在 swoole 项目中引入 php-monitor，首先发现 php-monitor 没有发布到 packagist，所以只能本地安装。

监控数据存储

数据存储使用 MongoDB，方便快捷。

项目是在本地 docker-compose 下起来的，在 docker-compose.yml 中创建一个 mongo 容器并向外暴露 mongo 端口 27017。同时 php-monitor 的数据可视化部分也可以在 mongo 中读取监控数据。

docker-compose.yml 声明 mongo

my-mongodb:container_name: my-mongodbimage: mongo:4.0.3restart: alwaysvolumes:  - ./mongodata/db:/data/db  - ./mongodata/log:/var/log/mongodbports:  - 27017:27017networks:  - my-networksenvironment:  MONGO_INITDB_ROOT_USERNAME:  MONGO_INITDB_ROOT_PASSWORD:

在 php-monitor/src/config/config.php 中配置使用 mongo，在 swoole 处理请求的函数中开启监控，并在返回后记录数据

public function onRequest(SwooleRequest $request, SwooleResponse $response){    require_once '/working/vendor/laynefyc/php-monitor/src/autoPrepend.php';    // 处理    \pm\common\PMonitor::shutdown($uri, '127.0.0.1','GET');}

在 mongo 中可以看到监控数据：

!https://deb-gmi.oss-cn-beijing.aliyuncs.com/img/20210326121446.png

其中 profile 字段是具体的调用栈情况，a ==> b 表示从 a 函数到 b 函数的过程

• ct：调用的次数

• wt：函数方法执行的时间耗时。相当于，在调用前记录一个时间，函数方法调用完毕后，计算时间差。

• cpu：函数方法执行消耗的 cpu 时间。和 wt 的差别在于，当进程让出 cpu 使用权后，将不再计算 cpu 时间。通过调用系统调用 getrusage 获取进程的占用 cpu 数据。

• mu：函数方法所使用的内存。相当于，在调用前记录一个内存占用，函数方法调用完毕后，计算内存差。调用的是 zend_memory_usage 获取内存占用情况。

• pmu：函数方法所使用的内存峰值。调用的是 zend_memory_peak_usage 获取内存情况。

数据可视化

使用同样的 mongo 配置，在 php-monitor/public 中启动服务 php -S 127.0.0.1:8066

浏览器访问：

按 url 查询耗时：

查看具体一次请求的 SQL 耗时详情：

函数的耗时和内存占用：

函数调用次数和总耗时：

性能指标监控的原理

使用 tideways 扩展提供的 tideways_enable 开启监控，tideways_disable 结束监控。可以监控到这两个函数之间的所有执行过程。这一点跟 xhprof 一致，也是 xhprof_enable 开启，xhprof_disable 结束。

xhprof 扩展：

// 开启监控xhprof_enable();
// 业务逻辑
// 结束监控$xhprofData = xhprof_disable();

tideways 扩展：

// 开启监控并支持CPU和内存监控tideways_enable(TIDEWAYS_FLAGS_CPU | TIDEWAYS_FLAGS_MEMORY);// 开启sql监控tideways_span_create('sql');
// 业务逻辑
// 结束监控$monitorData = tideways_disable();// sql监控$sqlData = tideways_get_spans();

tideways_xhprof 扩展：

// 开启监控并支持CPU和内存监控tideways_xhprof_enable(TIDEWAYS_XHPROF_FLAGS_MEMORY | TIDEWAYS_XHPROF_FLAGS_CPU);
// 业务逻辑
// 结束监控$monitorData = tideways_xhprof_disable();

参考引用：

xhgui：https://github.com/laynefyc/xhgui-branch

php-monitor：https://github.com/laynefyc/php-monitor/blob/master/README-zh_CN.md

作者博文《Tideways 和 xhgui 打造 PHP 非侵入式监控平台》：https://blog.it2048.cn/article-tideways-xhgui/

tideways github：https://github.com/tideways/php-xhprof-extension/

tideways 官网对 tideways 扩展的接收及数据格式说明：https://support.tideways.com/documentation/reference/tideways-xhprof/tideways-xhprof-extension.html

《Swoole 整合 PHP 性能分析平台: Tideways+Xhgui》：https://blog.csdn.net/uisoul/article/details/103936873

《composer 如何安装本地依赖包》：https://learnku.com/laravel/t/1999/composer-local-path-loading-third-party-extension-pack

《深入了解 xhprof 性能分析工具》：https://www.bo56.com/深入了解xhprof性能分析工具/