性能分析设置指南

概述

ThinkMaaS 提供两类性能分析能力：

pprof（内置）：适合临时诊断与离线分析
Pyroscope（可选）：适合线上持续分析与火焰图可视化

两者可以同时启用，互不冲突。

功能特点

✅ 零代码集成 - 仅通过环境变量配置
✅ 支持 Docker 和独立部署
✅ 支持临时诊断与持续分析并存
✅ 可选鉴权与实例区分

pprof（内置）设置

1. 配置环境变量

使用 Docker Compose：

environment:
  - ENABLE_PPROF=true

独立部署：

export ENABLE_PPROF=true

2. 重启应用

重启应用以应用更改。

3. 验证

如果未修改路由，通常可在 /debug/pprof/ 访问（以实际部署为准）。

Pyroscope 设置

1. 准备 Pyroscope 服务

确保 Pyroscope 服务可访问，并记录服务地址（例如：http://localhost:4040）。

2. 配置环境变量

使用 Docker Compose：

environment:
  - PYROSCOPE_URL=http://localhost:4040
  - PYROSCOPE_APP_NAME=new-api
  - 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=new-api
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. 重启应用