性能分析设置指南

environment:
  - PYROSCOPE_URL=http://localhost:4040
  - PYROSCOPE_APP_NAME=token-factory
  - PYROSCOPE_BASIC_AUTH_USER=your-user
  - PYROSCOPE_BASIC_AUTH_PASSWORD=your-password
  - PYROSCOPE_MUTEX_RATE=5
  - PYROSCOPE_BLOCK_RATE=5
  - HOSTNAME=your-hostname

独立部署：

export PYROSCOPE_URL=http://localhost:4040
export PYROSCOPE_APP_NAME=token-factory
export PYROSCOPE_BASIC_AUTH_USER=your-user
export PYROSCOPE_BASIC_AUTH_PASSWORD=your-password
export PYROSCOPE_MUTEX_RATE=5
export PYROSCOPE_BLOCK_RATE=5
export HOSTNAME=your-hostname

3. 重启应用

重启应用以应用更改。

4. 验证

打开 Pyroscope UI
选择 PYROSCOPE_APP_NAME 对应的应用
如设置了 HOSTNAME，可在实例维度区分来源

故障排除

性能分析无法工作？

✅ 验证环境变量设置正确
✅ 更改变量后重启应用
✅ 检查网络连通性与鉴权配置
✅ 确认 PYROSCOPE_APP_NAME 命名一致

Docker 用户：

# Check env vars
docker exec token-factory env | grep -E "PPROF|PYROSCOPE"

环境变量参考

变量	必需	默认值	说明
`ENABLE_PPROF`	否	`false`	启用 pprof 性能分析
`PYROSCOPE_URL`	否	-	Pyroscope 服务地址
`PYROSCOPE_APP_NAME`	否	-	Pyroscope 应用标识
`PYROSCOPE_BASIC_AUTH_USER`	否	-	Pyroscope Basic Auth 用户名
`PYROSCOPE_BASIC_AUTH_PASSWORD`	否	-	Pyroscope Basic Auth 密码
`PYROSCOPE_MUTEX_RATE`	否	-	Mutex 采样率
`PYROSCOPE_BLOCK_RATE`	否	-	Block 采样率
`HOSTNAME`	否	-	实例标识（可选）

概述

功能特点

pprof（内置）设置

1. 配置环境变量

2. 重启应用

3. 验证

Pyroscope 设置

1. 准备 Pyroscope 服务

2. 配置环境变量

3. 重启应用

4. 验证

故障排除

环境变量参考

相关链接

目录