Swoole Tracker

优质

小牛编辑

135浏览

2023-12-01

Swoole Tracker 作为 Swoole 官方出品的一整套企业级 PHP 和 Swoole 分析调试工具，更专一、更专业。

介绍

时刻掌握应用架构模型

自动发现应用依赖拓扑结构和展示，时刻掌握应用的架构模型

分布式跨应用链路追踪

支持无侵入的分布式跨应用链路追踪，让每个请求一目了然，全面支持协程/非协程环境，数据实时可视化

全面分析报告服务状况

各种维度统计服务上报的调用信息，比如总流量、平均耗时、超时率等，并全面分析报告服务状况

拥有强大的调试工具链

本系统支持远程调试，可在系统后台远程开启检测内存泄漏、阻塞检测和代码性能分析

完善的系统监控

支持完善的系统监控，零成本部署，监控机器的CPU、内存、网络、磁盘等资源，可以很方便的集成到现有报警系统

零成本接入系统

本系统的客户端提供脚本可一键部署，服务端可在Docker环境中运行，简单快捷

安装

安装依赖

注册完账户后，进入控制台，并申请试用，下载对应客户端。

相关文档，请移步试用文档或详细文档

具体文档地址，以从控制台下载的对应客户端中展示的为准。

将客户端中的所有文件以及以下两个文件复制到项目目录 swoole-tacker 中

entrypoint.sh

#!/usr/bin/env bash

/opt/swoole/script/php/swoole_php /opt/swoole/node-agent/src/node.php &

php /var/www/swoft/bin/swoft http:start

然后将下面的 Dockerfile 复制到项目根目录中。

FROM swoft/swoft

LABEL maintainer="sakuraovq <sakuraovq@gmail.com>" version="2.6"

# This php version
ENV PHP_VERSION=72
# This is tracker ini config
ENV SWOOLE_TRACHER_INI=/usr/local/etc/php/conf.d/swoole-tracker.ini

ADD . /var/www/swoft

# The address here is displayed on the client side.
RUN  cd ./swoole-tracker && ./deploy_env.sh www.swoole-cloud.com \
    && chmod 777 entrypoint.sh \
    && php_dir=$(php -r "echo @ini_get("extension_dir").PHP_EOL;") \
    && cp ./swoole_tracker${PHP_VERSION}.so $php_dir/swoole_tracker.so \
    # Enable swoole_tracker
    && echo "extension=swoole_tracker.so" > ${SWOOLE_TRACHER_INI} \
    # Open the main switch
    && echo "apm.enable=1" >> ${SWOOLE_TRACHER_INI} \
    # Sampling Rate, eg: 10%
    && echo "apm.sampling_rate=10" >> ${SWOOLE_TRACHER_INI} \
    # Turn on memory leak detection Default 0 Off
    && echo "apm.enable_memcheck=1" >> ${SWOOLE_TRACHER_INI}

CMD ["sh", "./swoole-tracker/entrypoint.sh"]

构建镜像

docker build -t swoft/tracker .

运行容器

docker run --rm --name swoft-tracker -v $(pwd):/var/www/swoft -p 18306:18306 swoft/tracker

采样率

采样率按照需求配置, 如果为 100%, 全部请求都会进行上报。

使用

不依赖组件

Swoole Tracker的支持自动生成应用名称并创建应用，无需修改任何代码，生成的应用名称格式为：

Swoole的HttpServer：ip:prot

其他的Server：ip(hostname):prot

即安装好swoole_tracker扩展之后就可以正常使用Swoole Tracker的功能

依赖组件

当你需要自定义应用名称时则需要安装组件，使用Composer安装：

安装组件

composer require swoft/swoole-tracker

安装完成后在 app/bean.php 配置文件中注册 Swoft\Swoole\Tracker\Middleware\SwooleTrackerMiddleware 中间件即可，如下：

<?php

return [
       'httpDispatcher'    => [
           // Add global http middleware
           'middlewares' => [
                 \Swoft\Swoole\Tracker\Middleware\SwooleTrackerMiddleware::class,
           ],
       ],
];

配置了中间件后框架会自动开启链路追踪。

单独使用

你也可以在需要链路追踪透传TraceId/SpanId、自定义应用名称时单独使用它，例如:

/** @var SwooleTracker $swooleTracker */
$swooleTracker = bean(SwooleTracker::class);

/**
 * 参数说明：
 * 1. $func eg. 'App\Login\Weibo::login'
 * 2. $serviceName 自定义的应用名称，后台会自动创建 eg. 'user'
 * 3. $serverIp eg. '192.1.1.1'
 * 4. $traceId
 * 5. $spanId
 */
$tick = $swooleTracker->startRpcAnalysis('/get/user', 'demo', '53.65.77.11', $traceId, $spanId);

// todo ...
$handlerStatus = false;
$errno         = 401;

$swooleTracker->endRpcAnalysis($tick, $handlerStatus, $errno);

登录管理后台看

链路追踪

应用监控

调试器

内存泄露

阻塞检查

如果需要开启 阻塞检查, 泄露分析, 性能分析 在进程列表中后面的按钮开启就是, 不需要客户端手动上报