文档 Grafana Pyroscope 配置客户端以发送配置文件 Grafana Alloy 设置Go的拉取模式配置文件

设置 Go 分析（拉模式）

在拉取模式下，收集器、Grafana Alloy定期从Golang应用程序中检索配置文件，特别针对/debug/pprof/*端点。

要设置Go的拉取模式配置文件，您需要

1. 公开pprof端点。
2. 安装一个收集器，例如Grafana Alloy。
3. 准备收集器的配置文件。
4. 启动收集器。

公开pprof端点

确保您的Golang应用程序公开pprof端点。

1. 获取godeltaprof包

   bash Copy

   go get github.com/grafana/pyroscope-go/godeltaprof@latest

2. 在应用程序开始处导入net/http/pprof和godeltaprof/http/pprof包。

   Go Copy

   import _ "net/http/pprof"
   import _ "github.com/grafana/pyroscope-go/godeltaprof/http/pprof"

安装收集器

您可以使用示例Alloy收集器配置文件将数据发送到Pyroscope。

要安装Alloy，请参阅Grafana Alloy安装。

准备收集器配置文件

在Alloy配置文件中，您需要添加至少两个块：pyroscope.write和pyroscope.scrape。

1. 添加pyroscope.write块。

   alloy 复制

   pyroscope.write "write_job_name" {
           endpoint {
                   url = "https://127.0.0.1:4040"
           }
   }

2. 添加pyroscope.scrape块。

   alloy 复制

   pyroscope.scrape "scrape_job_name" {
           targets    = [{"__address__" = "localhost:4040", "service_name" = "example_service"}]
           forward_to = [pyroscope.write.write_job_name.receiver]
   
           profiling_config {
                   profile.process_cpu {
                           enabled = true
                   }
   
                   profile.godeltaprof_memory {
                           enabled = true
                   }
   
                   profile.memory { // disable memory, use godeltaprof_memory instead
                           enabled = false
                   }
   
                   profile.godeltaprof_mutex {
                           enabled = true
                   }
   
                   profile.mutex { // disable mutex, use godeltaprof_mutex instead
                           enabled = false
                   }
   
                   profile.godeltaprof_block {
                           enabled = true
                   }
   
                   profile.block { // disable block, use godeltaprof_block instead
                           enabled = false
                   }
   
                   profile.goroutine {
                           enabled = true
                   }
           }
   }

3. 保存对文件的更改。

启动收集器

1. 为测试目的启动本地Pyroscope实例

   bash Copy

   docker run -p 4040:4040 grafana/pyroscope

2. 要启动Alloy v1.2及更高版本：将configuration.alloy替换为您的配置文件名
   运行alloy配置文件.alloy

3. 打开浏览器到https://127.0.0.1:4040。页面应列出配置文件。

示例

将数据发送到Grafana Cloud

您的Grafana Cloud URL、用户名和密码可以在grafana.com上您的Pyroscope栈的“详细信息页面”找到。在同一页面上创建令牌，并将其用作基本认证密码。

alloy 复制

pyroscope.write "write_job_name" {
        endpoint {
                url = "<Grafana Cloud URL>"

                basic_auth {
                        username = "<Grafana Cloud User>"
                        password = "<Grafana Cloud Password>"
                }
        }

}

发现Kubernetes目标

1. 选择所有Pod

alloy 复制

discovery.kubernetes "all_pods" {
        role = "pod"
}

1. 删除未运行的Pod，创建namespace、pod、node和container标签。根据namespace和container标签组合service_name标签。仅选择与正则表达式模式(ns1/.*)|(ns2/container-.*0)匹配的服务。

   alloy 复制

   
   discovery.relabel "specific_pods" {
           targets = discovery.kubernetes.all_pods.targets
   
           rule {
                   action        = "drop"
                   regex         = "Succeeded|Failed|Completed"
                   source_labels = ["__meta_kubernetes_pod_phase"]
           }
   
           rule {
                   action        = "replace"
                   source_labels = ["__meta_kubernetes_namespace"]
                   target_label  = "namespace"
           }
   
           rule {
                   action        = "replace"
                   source_labels = ["__meta_kubernetes_pod_name"]
                   target_label  = "pod"
           }
   
           rule {
                   action        = "replace"
                   source_labels = ["__meta_kubernetes_node_name"]
                   target_label  = "node"
           }
   
           rule {
                   action        = "replace"
                   source_labels = ["__meta_kubernetes_pod_container_name"]
                   target_label  = "container"
           }
   
           rule {
                   action        = "replace"
                   regex         = "(.*)@(.*)"
                   replacement   = "${1}/${2}"
                   separator     = "@"
                   source_labels = ["__meta_kubernetes_namespace", "__meta_kubernetes_pod_container_name"]
                   target_label  = "service_name"
           }
   
           rule {
                   action        = "keep"
                   regex         = "(ns1/.*)|(ns2/container-.*0)"
                   source_labels = ["service_name"]
           }
   }

2. 将discovery.relabel.specific_pods.output用作pyroscope.scrape块的目标。

   alloy 复制

       pyroscope.scrape "scrape_job_name" {
               targets    = discovery.relabel.specific_pods.output
               ...
       }

公开pprof端点

如果您不使用http.DefaultServeMux，则可以将/debug/pprof/*处理程序注册到自己的http.ServeMux

Go Copy

var mux *http.ServeMux
mux.Handle("/debug/pprof/", http.DefaultServeMux)

或者，如果您使用gorilla/mux

Go Copy

var router *mux.Router
router.PathPrefix("/debug/pprof").Handler(http.DefaultServeMux)

参考

• Grafana Alloy
• pyroscope.scrape
• pyroscope.write
• discovery.kubernetes
• discovery.docker
• discovery.relabel