hyperf/docs/zh-hk/swoole-tracker.md

5.4 KiB
Raw Blame History

Swoole Tracker

Swoole Tracker是 Swoole 官方推出的一整套企業級包括 PHP 和 Swoole 分析調試工具以及應用性能管理APM平台針對常規的 FPM 和 Swoole 常駐進程的業務提供全面的性能監控、分析和調試的解決方案。曾命名Swoole Enterprise

Swoole Tracker 能夠幫助企業自動分析並彙總統計關鍵系統調用並智能準確的定位到具體的 PHP 業務代碼,實現業務應用性能最優化、強大的調試工具鏈為企業業務保駕護航、提高 IT 生產效率。

  • 時刻掌握應用架構模型

自動發現應用依賴拓撲結構和展示,時刻掌握應用的架構模型

  • 分佈式跨應用鏈路追蹤

支持無侵入的分佈式跨應用鏈路追蹤,讓每個請求一目瞭然,全面支持協程/非協程環境,數據實時可視化

  • 全面分析報告服務狀況

各種維度統計服務上報的調用信息, 比如總流量、平均耗時、超時率等,並全面分析報告服務狀況

  • 擁有強大的調試工具鏈

本系統支持遠程調試,可在系統後台遠程開啟檢測內存泄漏、阻塞檢測、代碼性能分析和查看調用棧;也支持手動埋點進行調試,後台統一查看結果

  • 同時支持 FPM 和 Swoole

完美支持 PHP-FPM 環境,不僅限於在 Swoole 中使用

  • 完善的系統監控

支持完善的系統監控,零成本部署,監控機器的 CPU、內存、網絡、磁盤等資源可以很方便的集成到現有報警系統

  • 一鍵安裝和零成本接入

規避與減小整體投資風險,本系統的客户端提供腳本可一鍵部署,服務端可在 Docker 環境中運行,簡單快捷

  • 提高各部門生產效率

在複雜系統中追蹤服務及代碼層級性能瓶頸,幫助 IT、開發等部門提升工作效率將重點聚焦在核心工作中

安裝

安裝擴展

註冊完賬户後,進入控制枱,並申請試用,下載對應客户端。

相關文檔,請移步 試用文檔詳細文檔

具體文檔地址,以從控制枱下載的對應客户端中展示的為準。

將客户端中的所有文件以及以下兩個文件複製到項目目錄 .build

  1. entrypoint.sh
#!/usr/bin/env bash

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

php /opt/www/bin/hyperf.php start

  1. swoole-tracker.ini
[swoole_tracker]
extension=/opt/swoole_tracker.so
apm.enable=1           #打開總開關
apm.sampling_rate=100  #採樣率 例如100%

# 開啟內存泄漏檢測時需要添加
apm.enable_memcheck=1  #開啟內存泄漏檢測 默認0 關閉狀態

然後將下面的 Dockerfile 複製到項目根目錄中。

FROM hyperf/hyperf:7.2-alpine-cli
LABEL maintainer="Hyperf Developers <group@hyperf.io>" version="1.0" license="MIT"

##
# ---------- env settings ----------
##
# --build-arg timezone=Asia/Shanghai
ARG timezone

ENV TIMEZONE=${timezone:-"Asia/Shanghai"} \
    COMPOSER_VERSION=1.8.6 \
    APP_ENV=prod

RUN set -ex \
    && apk update \
    # install composer
    && cd /tmp \
    && wget https://github.com/composer/composer/releases/download/${COMPOSER_VERSION}/composer.phar \
    && chmod u+x composer.phar \
    && mv composer.phar /usr/local/bin/composer \
    # show php version and extensions
    && php -v \
    && php -m \
    #  ---------- some config ----------
    && cd /etc/php7 \
    # - config PHP
    && { \
        echo "upload_max_filesize=100M"; \
        echo "post_max_size=108M"; \
        echo "memory_limit=1024M"; \
        echo "date.timezone=${TIMEZONE}"; \
    } | tee conf.d/99-overrides.ini \
    # - config timezone
    && ln -sf /usr/share/zoneinfo/${TIMEZONE} /etc/localtime \
    && echo "${TIMEZONE}" > /etc/timezone \
    # ---------- clear works ----------
    && rm -rf /var/cache/apk/* /tmp/* /usr/share/man \
    && echo -e "\033[42;37m Build Completed :).\033[0m\n"

COPY . /opt/www
WORKDIR /opt/www/.build

# 這裏的地址,以客户端中顯示的為準
RUN ./deploy_env.sh www.swoole-cloud.com \
    && chmod 755 entrypoint.sh \
    && cp swoole_tracker72.so /opt/swoole_tracker.so \
    && cp swoole-tracker.ini /etc/php7/conf.d/swoole-tracker.ini \
    && php -m

WORKDIR /opt/www

RUN composer install --no-dev \
    && composer dump-autoload -o \
    && php /opt/www/bin/hyperf.php di:init-proxy

EXPOSE 9501

ENTRYPOINT ["sh", ".build/entrypoint.sh"]

使用

不依賴組件

Swoole Trackerv2.5.0 以上版本支持自動生成應用名稱並創建應用,無需修改任何代碼。

如果使用 SwooleHttpServer 那麼生成的應用名稱為ip:port

如果使用 Swoole 其他的 Server 那麼生成的應用名稱為ip(hostname):port

即安裝好 swoole_tracker 擴展之後就可以正常使用 Swoole Tracker 的功能

依賴組件

當你需要自定義應用名稱時則需要安裝組件,使用 Composer 安裝:

composer require hyperf/swoole-tracker

安裝完成後在 config/autoload/middlewares.php 配置文件中註冊 Hyperf\SwooleTracker\Middleware\HttpServerMiddleware 中間件即可,如下:

<?php

return [
    'http' => [
        Hyperf\SwooleTracker\Middleware\HttpServerMiddleware::class
    ],
];