Swoole Tracker

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

  • 时刻掌握应用架构模型

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

  • 分布式跨应用链路追踪

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

  • 全面分析报告服务状况

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

  • 拥有强大的调试工具链

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

  • 完善的系统监控

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

  • 零成本接入系统

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

安装

安装扩展

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

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

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

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

  1. entrypoint.sh
  1. #!/usr/bin/env bash
  3. /opt/swoole/script/php/swoole_php /opt/swoole/node-agent/src/node.php &
  5. php /opt/www/bin/hyperf.php start
  1. swoole-tracker.ini
  1. [swoole_tracker]
  2. extension=/opt/swoole_tracker.so
  3. apm.enable=1           #打开总开关
  4. apm.sampling_rate=100  #采样率 例如：100%
  6. # 支持远程调试；需要手动埋点时再添加
  7. apm.enable_memcheck=1  #开启内存泄漏检测 默认0 关闭状态

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

  1. FROM hyperf/hyperf:7.2-alpine-cli
  2. LABEL maintainer="Hyperf Developers <group@hyperf.io>" version="1.0" license="MIT"
  4. ##
  5. # ---------- env settings ----------
  6. ##
  7. # --build-arg timezone=Asia/Shanghai
  8. ARG timezone
  10. ENV TIMEZONE=${timezone:-"Asia/Shanghai"} \
  11.     COMPOSER_VERSION=1.8.6 \
  12.     APP_ENV=prod
  14. RUN set -ex \
  15.     && apk update \
  16.     # install composer
  17.     && cd /tmp \
  18.     && wget https://github.com/composer/composer/releases/download/${COMPOSER_VERSION}/composer.phar \
  19.     && chmod u+x composer.phar \
  20.     && mv composer.phar /usr/local/bin/composer \
  21.     # show php version and extensions
  22.     && php -v \
  23.     && php -m \
  24.     #  ---------- some config ----------
  25.     && cd /etc/php7 \
  26.     # - config PHP
  27.     && { \
  28.         echo "upload_max_filesize=100M"; \
  29.         echo "post_max_size=108M"; \
  30.         echo "memory_limit=1024M"; \
  31.         echo "date.timezone=${TIMEZONE}"; \
  32.     } | tee conf.d/99-overrides.ini \
  33.     # - config timezone
  34.     && ln -sf /usr/share/zoneinfo/${TIMEZONE} /etc/localtime \
  35.     && echo "${TIMEZONE}" > /etc/timezone \
  36.     # ---------- clear works ----------
  37.     && rm -rf /var/cache/apk/* /tmp/* /usr/share/man \
  38.     && echo -e "\033[42;37m Build Completed :).\033[0m\n"
  40. COPY . /opt/www
  41. WORKDIR /opt/www/.build
  43. # 这里的地址，以客户端中显示的为准
  44. RUN ./deploy_env.sh www.swoole-cloud.com \
  45.     && chmod 755 entrypoint.sh \
  46.     && cp swoole_tracker72.so /opt/swoole_tracker.so \
  47.     && cp swoole-tracker.ini /etc/php7/conf.d/swoole-tracker.ini \
  48.     && php -m
  50. WORKDIR /opt/www
  52. RUN composer install --no-dev \
  53.     && composer dump-autoload -o \
  54.     && php /opt/www/bin/hyperf.php di:init-proxy
  56. EXPOSE 9501
  58. ENTRYPOINT ["sh", ".build/entrypoint.sh"]

使用

不依赖组件

Swoole Tracker 的 v2.5.0 以上版本支持自动生成应用名称并创建应用，无需修改任何代码。

如果使用 Swoole 的 HttpServer 那么生成的应用名称为ip:port

如果使用 Swoole 其他的 Server 那么生成的应用名称为ip(hostname):port

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

依赖组件

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

  1. composer require hyperf/swoole-tracker

安装完成后在 config/autoload/middlewares.php 配置文件中注册 Hyperf\SwooleTracker\Middleware\HttpServerMiddleware 中间件即可，如下：

  1. <?php
  3. return [
  4.     'http' => [
  5.         Hyperf\SwooleTracker\Middleware\HttpServerMiddleware::class
  6.     ],
  7. ];