安装
- 网上很多的教程都是直接一条
Docker命令安装运行docker run -it -p 4040:4040 --restart=always pyroscope/pyroscope:latest server - 只像上面那样安装的话, 很多配置不能用, 比如数据页面直接展示不需要登录, 不能限制
API上报(只允许某些机器上报: 通过Key来限制), 容器销毁后不能保存数据 - 这里我使用
docker-compose.yml来配置
version: "3"
services:
pyroscope:
image: "pyroscope/pyroscope:latest"
ports:
- "4040:4040"
command:
- "server"
environment:
## 限制必须使用 API 秘钥上传
- PYROSCOPE_AUTH_INGESTION_ENABLED=true
## 设置账号密码登录后台
- PYROSCOPE_AUTH_INTERNAL_ENABLED=true
volumes:
## 设置数据共享目录
- ./data:/var/lib/pyroscope
- 配置好之后, 直接在当前目录运行
docker-compose up -d, 然后访问127.0.0.1:4040即可进入登录页面 - 此时需要输入账号密码方可进入(admin, admin), 进入系统后可以自行修改账号密码
- 然后添加秘钥 (设置 -> API Keys -> Add Key), 这里稍微要注意的是,
Role必须选择Agent才可以上报数据
Pyroscope
Go使用
Go有两种模式, 拉取模式 类似Prometheus, 由于是自己个人的项目,我选择使用推送的模式
- 项目增加依赖
# make sure you also upgrade pyroscope server to version 0.3.1 or higher
go get github.com/pyroscope-io/client/pyroscope
- 项目中启动服务
package main
import "github.com/pyroscope-io/client/pyroscope"
func main() {
pyroscope.Start(pyroscope.Config{
// 项目名字, 只能英文不能中文
ApplicationName: "remeber-dream-api",
// 按实际自己 pyroscope 服务的地址
ServerAddress: "127.0.0.1:4040",
Logger: pyroscope.StandardLogger,
// 如果开启了 PYROSCOPE_AUTH_INGESTION_ENABLED,
// 并且按照以上步骤添加了 Key, 那么把 Key 放到此处即可
AuthToken: "xxxx",
// by default all profilers are enabled,
// but you can select the ones you want to use:
ProfileTypes: []pyroscope.ProfileType{
pyroscope.ProfileCPU,
pyroscope.ProfileAllocObjects,
pyroscope.ProfileAllocSpace,
pyroscope.ProfileInuseObjects,
pyroscope.ProfileInuseSpace,
},
})
// your code goes here
}
PHP使用
-
看了一下文档中PHP 直接使用的话, 只能在命令行下分析(
php-fpm运行模式直接开启慢日志即可) -
由于我的项目使用的是
laravel-s, 所以可以使用 -
镜像文件
FROM phpswoole/swoole:php7.4
# 修改中国镜像源
RUN sed -i "s@http://deb.debian.org@http://mirrors.aliyun.com@g" /etc/apt/sources.list && rm -Rf /var/lib/apt/lists/* && apt-get update
# 快速安装 PHP 扩展
COPY --from=mlocati/php-extension-installer /usr/bin/install-php-extensions /usr/local/bin/
RUN install-php-extensions pcntl redis pdo_mysql gd
WORKDIR /var/www
COPY . .
RUN chmod -R 0777 storage && \
chmod -R 0777 bootstrap/cache && \
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ && \
composer install --optimize-autoloader --no-dev && \
php artisan config:cache && \
php artisan route:cache && \
php artisan view:cache && \
php artisan laravels publish --no-interaction
# this copies pyroscope binary from pyroscope image to your image:
COPY --from=pyroscope/pyroscope:latest /usr/bin/pyroscope /usr/bin/pyroscope
## 建议在 docker run --env 注入环境变量
#ENV PYROSCOPE_SERVER_ADDRESS=
#ENV PYROSCOPE_APPLICATION_NAME=
#ENV PYROSCOPE_AUTH_TOKEN=
CMD ["pyroscope", "exec", "php", "bin/laravels", "start", "--env=product"]
注意点
- 不能使用
alpine的镜像, 否则容器启动不起来 - 注入容器的环境变量, 建议通过
docker run注入, 这样子可以不用把秘钥等写在Dockerfile - 运行的时候把
pyroscope exec写在要运行的命令前面, 参考https://pyroscope.io/docs/php/ - 最后上一张效果图
- 因为压测的是一个有缓存的接口, 可以看到时间基本都消耗在路由匹配和
Redis的存取当中
字段解释
| 名 | 含义 |
|---|---|
| cpu | |
| inuse_objects | 已分配但尚未释放的对象数量 |
| alloc_objects | 已分配的对象总数(不论已释放的对象) |
| inuse_space | 已分配但尚未释放的内存数量 |
| alloc_space | 分配的内存总量(不管释放了多少内存) |