无需修改代码：寻求Gunicorn部署的Python微服务遥测替代方案

1. 使用Grafana Beyla（eBPF驱动，完全无代码修改） #

Beyla是Grafana Labs推出的无侵入遥测工具，基于eBPF，支持自动追踪Python/Gunicorn应用的请求链路、性能指标，无需修改任何应用代码，直接通过进程匹配采集数据。

配置步骤（Docker Compose） #

• 在docker-compose.yml中添加Beyla服务：

services:
  beyla:
    image: grafana/beyla:latest
    privileged: true  # eBPF需要特权模式
    environment:
      - BEYLA_OPEN_PORT=8000  # 你的Gunicorn服务端口
      - BEYLA_PROMETHEUS_PORT=9090
      - BEYLA_TRACING_EXPORTER=tempo
      - BEYLA_TRACING_TEMPO_ENDPOINT=http://tempo:4317  # 对接Tempo
    volumes:
      - /proc:/host/proc:ro
      - /sys:/host/sys:ro
      - /var/run/docker.sock:/var/run/docker.sock:ro
    network_mode: host  # 或者和你的应用在同一个自定义网络

• 确保Gunicorn服务和Beyla在同一网络，Beyla会自动识别端口对应的进程，生成追踪数据推送到Tempo，之后在Grafana中通过Tempo数据源即可查看链路追踪面板。

2. 使用Pyroscope做性能剖析（无代码修改） #

Pyroscope支持无侵入的Python应用性能 profiling，能生成火焰图、CPU/内存使用趋势等，可直接集成到Grafana中。

配置步骤 #

• 添加Pyroscope服务到docker-compose.yml：

services:
  pyroscope:
    image: pyroscope/pyroscope:latest
    ports:
      - "4040:4040"
    command: "server"

• 修改Gunicorn服务的配置，添加环境变量和PID共享：

your-python-service:
    build: .
    environment:
      - PYROSCOPE_SERVER_ADDRESS=http://pyroscope:4040
      - PYROSCOPE_PROFILING_ENABLED=1
      - PYROSCOPE_SERVICE_NAME=your-service-name
    pid: host  # 允许Pyroscope访问进程信息
    ports:
      - "8000:8000"
    command: "gunicorn -w 4 app:app"

• 在Grafana中添加Pyroscope数据源，即可查看应用的性能剖析面板，包括每个请求的函数调用耗时、CPU占用等细节。

3. 正确使用OpenTelemetry的无侵入方式（解决Gunicorn兼容问题） #

OpenTelemetry并非和Gunicorn不兼容，只是需要用官方的opentelemetry-instrument命令启动Gunicorn，自动处理worker进程的追踪注入，无需修改应用代码。

配置步骤 #

• 在你的Python应用镜像中安装OpenTelemetry工具：

RUN pip install opentelemetry-distro opentelemetry-exporter-otlp
RUN opentelemetry-bootstrap --action=install

• 在docker-compose.yml中修改Gunicorn的启动命令，并配置环境变量：

your-python-service:
    build: .
    environment:
      - OTEL_SERVICE_NAME=your-service-name
      - OTEL_EXPORTER_OTLP_ENDPOINT=http://tempo:4317
      - OTEL_TRACES_EXPORTER=otlp
    ports:
      - "8000:8000"
    command: "opentelemetry-instrument gunicorn -w 4 app:app"

• 这种方式会自动给Gunicorn的主进程和所有worker进程注入追踪代码，生成的链路数据会发送到Tempo，在Grafana中即可查看完整的请求追踪。

内容的提问来源于stack exchange，提问作者Paul BHS