Pyroscope项目文档更新：从Grafana Agent迁移到Alloy的技术指南

背景概述

Pyroscope作为一款开源的持续性能分析平台，近期对其文档进行了重要更新，主要涉及从Grafana Agent到Alloy的配置迁移。这一变更源于Grafana官方对新一代可观测性数据收集器Alloy的推广，以及逐步淘汰Agent的计划。

核心变更内容

1. 文档结构调整

原有的"Grafana Agent"配置章节已全面更新为"Alloy或Agent"的并置说明，为不同阶段的用户提供平滑过渡。文档中新增了Alloy的安装指引，同时保留了Agent的配置参考。

2. 配置方式变化

在Go语言性能分析配置方面，最显著的变化是Alloy默认采用基于注解的目标发现机制。这意味着用户现在需要通过为Pod添加特定注解（如profiles.grafana.com/goroutine.scrape=true）来启用抓取功能，这与之前的配置方式有本质区别。

3. Helm Chart重大变更

最新版本的Pyroscope Helm Chart做出了破坏性变更：

• 默认禁用Agent组件
• 改为启用Alloy组件
• 用户必须显式选择继续使用Agent（通过设置agent.enabled: true和alloy.enable: false）

具体配置示例

Go应用性能分析配置

对于Go应用的性能分析采集，Alloy的配置示例如下：

// 目标发现配置
discovery.kubernetes "pods" {
  selectors {
    field = "spec.nodeName=" + env("HOSTNAME")
    role = "pod"
  }
}

// 性能数据抓取配置
pyroscrape.scrape "goroutine" {
  targets = discovery.kubernetes.pods.targets
  forward_to = [pyroscope.write.endpoint.receiver]
  
  // 配置profiling类型
  profiling_config {
    pprof_config {
      path = "/debug/pprof/goroutine"
    }
  }
}

// 数据写入配置
pyroscope.write "endpoint" {
  endpoint {
    url = "http://localhost:4040"
  }
}

Java应用性能分析

Java应用的配置也进行了相应更新，特别强调了注解发现机制的重要性：

discovery.kubernetes "java_pods" {
  selectors {
    label = "app=my-java-app"
  }
}

pyroscrape.scrape "java" {
  targets = discovery.kubernetes.java_pods.targets
  forward_to = [pyroscope.write.cloud.receiver]
  
  profiling_config {
    java_config {
      profiling_mode = "cpu"
    }
  }
}

迁移注意事项

1. 注解发现机制：Alloy默认要求为Pod添加