Tracker

EasySwoole 提供了一個基礎的追蹤組件，方便用戶實現基礎的服務器狀態監控，與調用鏈記錄。

組件要求

php: >=7.1.0
ext-swoole: ^4.4.0
easyswoole/component: ^2.0

安裝方法

composer require easyswoole/tracker

倉庫地址

easyswoole/tracker

調用鏈結構說明

EasySwoole 的調用鏈跟蹤是一個以類似有序的樹狀鏈表的解構實現的，解構如下：

struct Point{
    struct Point* nextPoint;
    struct Point[] subPoints;
    const END_SUCCESS = 'success';
    const END_FAIL = 'fail';
    const END_UNKNOWN = 'unknown';
    int startTime;
    mixed startArg;
    int endTime;
    string pointName;
    string endStatus = self::END_UNKNOWN;
    mixed endArg;
    string pointId;
    string parentId;
    int depth = 0;
    bool isNext
}

基本使用

<?php
/**
 * This file is part of EasySwoole.
 *
 * @link http://www.zbjtqy.com
 * @document http://www.zbjtqy.com
 * @contact http://www.zbjtqy.com/Preface/contact.html
 * @license https://github.com/easy-swoole/easyswoole/blob/3.x/LICENSE
 */

require_once __DIR__ . '/vendor/autoload.php';

use EasySwoole\Tracker\Point;
use EasySwoole\Component\WaitGroup;
use EasySwoole\Tracker\PointContext;

/*
 * 假設我們的調用鏈是這樣的
 * onRequest  ->> actionOne ->> actionOne call remote Api(1,2)  ->>  afterAction
 */

go(function (){
    /*
     * 創建入口
     */
    $onRequest = new Point('onRequest');
    //記錄請求參數，并模擬access log
    \co::sleep(0.01);
    $onRequest->setStartArg([
        'requestArg' => 'requestArgxxxxxxxx',
        'accessLogId'=>'logIdxxxxxxxxxx'
    ]);
    //onRequest完成
    $onRequest->end();
    //進入 next actionOne
    $actionOne = $onRequest->next('actionOne');
        //action one 進入子環節調用
        $waitGroup = new WaitGroup();
        //sub pointOne
        $waitGroup->add();
        $subOne = $actionOne->appendChild('subOne');
        go(function ()use($subOne,$waitGroup){
                \co::sleep(0.1);
                $subOne->end();
                $waitGroup->done();
        });
        //sub pointTwo,并假設失敗
        $waitGroup->add();
        $subTwo = $actionOne->appendChild('subTwo');
            go(function ()use($subTwo,$waitGroup){
                \co::sleep(1);
                $subTwo->end($subTwo::END_FAIL,['failMsg'=>'timeout']);
                $waitGroup->done();
            });
        $waitGroup->wait();
    $actionOne->end();
    //actionOne結束，進入afterAction
    $afterAction = $actionOne->next('afterAction');
    //模擬響應記錄
    \co::sleep(0.01);
    $afterAction->end($afterAction::END_SUCCESS,['log'=>'success']);
    /*
     * 從入口開始打印調用鏈
     */
    echo Point::toString($onRequest);
});
// 以上代碼等價于如下
go(function () {
    PointContext::getInstance()->createStart('onRequest')->next('actionOne')->next('afterAction');
    // 記錄請求參數，并模擬access log
    \co::sleep(0.01);
    PointContext::getInstance()->find('onRequest')->setStartArg([
        'requestArg' => 'requestArgxxxxxxxx',
        'accessLogId' => 'logIdxxxxxxxxxx'
    ])->end();
    $subOne = PointContext::getInstance()->find('actionOne')->appendChild('subOne');
    $subTwo = PointContext::getInstance()->find('actionOne')->appendChild('subTwo');
    $waitGroup = new WaitGroup();
    $waitGroup->add();
    go(function () use ($subOne, $waitGroup) {
        \co::sleep(0.1);
        $subOne->end();
        $waitGroup->done();
    });
    // sub pointTwo，并假設失敗
    $waitGroup->add();
    go(function () use ($subTwo, $waitGroup) {
        \co::sleep(1);
        $subTwo->end($subTwo::END_FAIL, ['failMsg' => 'timeout']);
        $waitGroup->done();
    });
    $waitGroup->wait();
    PointContext::getInstance()->find('actionOne')->end();
    // 模擬響應記錄
    \co::sleep(0.01);
    PointContext::getInstance()->find('afterAction')->end(Point::END_SUCCESS, ['log' => 'success']);
    /*
     * 從入口開始打印調用鏈
     */
    echo Point::toString(PointContext::getInstance()->startPoint());
});

以上代碼輸出結果：

##
PointName:onRequest
ServiceName:default
Status:success
PointId:df56bbcf-c1ce-f536-ab8f-31f243721d76
ParentId:
Depth:0
IsNext:false
Start:1625313762.7221
StartArg:{"requestArg":"requestArgxxxxxxxx","accessLogId":"logIdxxxxxxxxxx"}
End:1625313762.7352
EndArg:null
ChildCount:0
Children:None
NextPoint:
    ##
    PointName:actionOne
    ServiceName:default
    Status:success
    PointId:c341da3e-809c-5a6b-e8c6-ab8aba29e336
    ParentId:df56bbcf-c1ce-f536-ab8f-31f243721d76
    Depth:0
    IsNext:true
    Start:1625313762.7352
    StartArg:null
    End:1625313763.7381
    EndArg:null
    ChildCount:2
    Children:
        ##
        PointName:subOne
        ServiceName:default
        Status:success
        PointId:4a66dc47-8c30-a4e4-bf8d-7b1fc334ce4b
        ParentId:c341da3e-809c-5a6b-e8c6-ab8aba29e336
        Depth:1
        IsNext:false
        Start:1625313762.7354
        StartArg:null
        End:1625313762.838
        EndArg:null
        ChildCount:0
        Children:None
        NextPoint:None
        ##
        PointName:subTwo
        ServiceName:default
        Status:fail
        PointId:326ca214-155b-d9f9-ad7a-8d8cbd479cdf
        ParentId:c341da3e-809c-5a6b-e8c6-ab8aba29e336
        Depth:1
        IsNext:false
        Start:1625313762.7355
        StartArg:null
        End:1625313763.7381
        EndArg:{"failMsg":"timeout"}
        ChildCount:0
        Children:None
        NextPoint:None
    NextPoint:
        ##
        PointName:afterAction
        ServiceName:default
        Status:success
        PointId:2f6d29b9-a100-fc69-2f64-f51a28a870eb
        ParentId:c341da3e-809c-5a6b-e8c6-ab8aba29e336
        Depth:0
        IsNext:true
        Start:1625313763.7382
        StartArg:null
        End:1625313763.7502
        EndArg:{"log":"success"}
        ChildCount:0
        Children:None
        NextPoint:None

如果想以自己的格式記錄到數據庫，可以具體查看 Point 實現的方法，每個 Point 都有自己的 Id。

進階使用

HTTP API 請求追蹤

在 EasySwoole 全局事件（即項目根目錄的 EasySwooleEvent.php）中注冊 Tracker。

在 EasySwoole 3.4.x 中注冊示例代碼如下：

<?php
/**
 * This file is part of EasySwoole.
 *
 * @link http://www.zbjtqy.com
 * @document http://www.zbjtqy.com
 * @contact http://www.zbjtqy.com/Preface/contact.html
 * @license https://github.com/easy-swoole/easyswoole/blob/3.x/LICENSE
 */

namespace EasySwoole\EasySwoole;

use EasySwoole\EasySwoole\AbstractInterface\Event;
use EasySwoole\EasySwoole\Swoole\EventRegister;

class EasySwooleEvent implements Event
{
    public static function initialize()
    {
        date_default_timezone_set('Asia/Shanghai');

        \EasySwoole\Component\Di::getInstance()->set(\EasySwoole\EasySwoole\SysConst::HTTP_GLOBAL_ON_REQUEST, function (\EasySwoole\Http\Request $request, \EasySwoole\Http\Response $response): bool {
            $point = \EasySwoole\Tracker\PointContext::getInstance()->createStart('onRequest');
            $point->setStartArg([
                'uri' => $request->getUri()->__toString(),
                'get' => $request->getQueryParams()
            ]);
            return true;
        });

        \EasySwoole\Component\Di::getInstance()->set(\EasySwoole\EasySwoole\SysConst::HTTP_GLOBAL_AFTER_REQUEST, function (\EasySwoole\Http\Request $request, \EasySwoole\Http\Response $response): void {
            $point = \EasySwoole\Tracker\PointContext::getInstance()->startPoint();
            $point->end();
            echo \EasySwoole\Tracker\Point::toString($point);
            $array = \EasySwoole\Tracker\Point::toArray($point);
        });
    }

    public static function mainServerCreate(EventRegister $register)
    {

    }
}

如果 EasySwoole 框架版本低于 3.4.x時，請使用如下方式進行注冊：

<?php
/**
 * This file is part of EasySwoole.
 *
 * @link http://www.zbjtqy.com
 * @document http://www.zbjtqy.com
 * @contact http://www.zbjtqy.com/Preface/contact.html
 * @license https://github.com/easy-swoole/easyswoole/blob/3.x/LICENSE
 */

namespace EasySwoole\EasySwoole;

use EasySwoole\EasySwoole\Swoole\EventRegister;
use EasySwoole\EasySwoole\AbstractInterface\Event;
use EasySwoole\Http\Request;
use EasySwoole\Http\Response;

class EasySwooleEvent implements Event
{
    public static function initialize()
    {
        // TODO: Implement initialize() method.
        date_default_timezone_set('Asia/Shanghai');
    }

    public static function mainServerCreate(EventRegister $register)
    {

    }

    public static function onRequest(Request $request, Response $response): bool
    {
        $point = \EasySwoole\Tracker\PointContext::getInstance()->createStart('onRequest');
        $point->setStartArg([
            'uri'=>$request->getUri()->__toString(),
            'get'=>$request->getQueryParams()
        ]);
        return true;
    }

    public static function afterRequest(Request $request, Response $response): void
    {
        $point = \EasySwoole\Tracker\PointContext::getInstance()->startPoint();
        $point->end();
        echo \EasySwoole\Tracker\Point::toString($point);
        $array = \EasySwoole\Tracker\Point::toArray($point);
    }
}

在 App\HttpController\Index.php 中：

<?php
/**
 * This file is part of EasySwoole.
 *
 * @link http://www.zbjtqy.com
 * @document http://www.zbjtqy.com
 * @contact http://www.zbjtqy.com/Preface/contact.html
 * @license https://github.com/easy-swoole/easyswoole/blob/3.x/LICENSE
 */

namespace App\HttpController;

use EasySwoole\Component\WaitGroup;
use EasySwoole\Http\AbstractInterface\Controller;
use EasySwoole\Tracker\PointContext;

class Index extends Controller
{
    protected function onRequest(?string $action): ?bool
    {
        /*
         * 調用關系  HttpRequest->OnRequest
         */
        $point = PointContext::getInstance()->next('ControllerOnRequest');
        // 假設這里進行了權限驗證，并模擬數據庫耗時
        \co::sleep(0.01);
        $point->setEndArg([
            'userId'=>'xxxxxxxxxxx'
        ]);
        $point->end();
        return true;
    }

    function index()
    {
        // 模擬調用第三方Api，調用關系  OnRequest->sub(subApi1,subApi2)
        $actionPoint = PointContext::getInstance()->next('indexAction');
        $wait = new WaitGroup();
        $subApi = $actionPoint->appendChild('subOne');
        $wait->add();
        go(function ()use($wait,$subApi){
            \co::sleep(1);
            $subApi->end();
            $wait->done();
        });

        $subApi = $actionPoint->appendChild('subTwo');
        $wait->add();
        go(function ()use($wait,$subApi){
            \co::sleep(0.3);
            $subApi->end($subApi::END_FAIL);
            $wait->done();
        });

        $wait->wait();

        $actionPoint->end();
        $this->response()->write('hello world');
    }
}

以上每次請求會輸出如下格式：

##
PointName:onRequest
ServiceName:default
Status:success
PointId:2ea751d4-13a7-8a27-932e-6671da6d6586
ParentId:
Depth:0
IsNext:false
Start:1625315058.3513
StartArg:{"uri":"http://192.168.1.107:9501/","get":[]}
End:1625315059.3694
EndArg:null
ChildCount:0
Children:None
NextPoint:
    ##
    PointName:ControllerOnRequest
    ServiceName:default
    Status:success
    PointId:13a0ccda-18ef-c90c-d9db-6e3a1cc70511
    ParentId:2ea751d4-13a7-8a27-932e-6671da6d6586
    Depth:0
    IsNext:true
    Start:1625315058.3535
    StartArg:null
    End:1625315058.3656
    EndArg:{"userId":"xxxxxxxxxxx"}
    ChildCount:0
    Children:None
    NextPoint:
        ##
        PointName:indexAction
        ServiceName:default
        Status:success
        PointId:a0295b8f-c02c-7ef3-afae-da5dce2764d0
        ParentId:13a0ccda-18ef-c90c-d9db-6e3a1cc70511
        Depth:0
        IsNext:true
        Start:1625315058.3656
        StartArg:null
        End:1625315059.3694
        EndArg:null
        ChildCount:2
        Children:
            ##
            PointName:subOne
            ServiceName:default
            Status:success
            PointId:d06855e1-0571-c829-121e-3467f7309598
            ParentId:a0295b8f-c02c-7ef3-afae-da5dce2764d0
            Depth:1
            IsNext:false
            Start:1625315058.3658
            StartArg:null
            End:1625315059.3694
            EndArg:null
            ChildCount:0
            Children:None
            NextPoint:None
            ##
            PointName:subTwo
            ServiceName:default
            Status:fail
            PointId:b47b32d6-f96f-9a00-1244-e16faab3d790
            ParentId:a0295b8f-c02c-7ef3-afae-da5dce2764d0
            Depth:1
            IsNext:false
            Start:1625315058.3658
            StartArg:null
            End:1625315058.6685
            EndArg:null
            ChildCount:0
            Children:None
            NextPoint:None
        NextPoint:None

Api 調用鏈記錄

$array = \EasySwoole\Tracker\Point::toArray($point);

可以把一個入口點轉為一個數組。例如我們可以在 MYSQL 數據庫中存儲以下關鍵結構：

CREATE TABLE `api_tracker_point_list` (
  `pointd` varchar(18) NOT NULL,
  `pointName` varchar(45) DEFAULT NULL,
  `parentId` varchar(18) DEFAULT NULL,
  `depth` int(11) NOT NULL DEFAULT '0',
  `isNext` int(11) NOT NULL DEFAULT '0',
  `startTime` varchar(14) NOT NULL,
  `endTime` varchar(14) DEFAULT NULL,
  `status` varchar(10) NOT NULL,
  PRIMARY KEY (`pointd`),
  UNIQUE KEY `trackerId_UNIQUE` (`pointd`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;

其余請求參數可以自己記錄。

核心字段在 pointId、parentId、isNext、status 這四個字段，例如，我想得到哪次調用鏈超時，那么就是直接

where status = fail

如果想看哪次調用耗時多少，那么可以

where spendTime > 3

spendTime 是通過 startTime 和 endTime 計算得出

easyswoole - 基于swoole扩展实现的一款高性能php框架