Grafana Pyroscope 1.19 发布解读profilecli 查询工具链、Kubernetes 代理与对象存储认证增强【免费下载链接】pyroscopeContinuous Profiling Platform. Debug performance issues down to a single line of code项目地址: https://gitcode.com/GitHub_Trending/py/pyroscopeGrafana Pyroscope 1.19 是面向持续剖析Continuous Profiling平台的一次重要版本更新重点围绕profilecli 命令行工具链新增query top、recording-rules、kube-proxy等命令、标签与 trace/span 查询能力、S3 原生 AWS SDK 认证以及debuginfo 上传服务展开。本文以 1.19 发布说明为主体结合仓库源码逐项解读各新特性背后的实现原理、配置方式与使用场景帮助你快速掌握该版本新增的运维与查询能力。版本概览与发布节奏1.19 系列包含三个补丁版本发布说明结构为1.19.3更新 Go 工具链至 1.25.9。1.19.2安全修复——将github.com/go-jose/go-jose/v4升级至 v4.1.4涉及 JOSE 安全协议实现同时更新 .NET 文档。1.19.0主版本包含大量增强、修复与稳定性/性能改进。从发布节奏看1.19 沿用了 Pyroscope 团队主版本携带功能、补丁版本快速跟进安全与工具链的惯例。以下重点解读 1.19.0 的核心变更。profilecli 工具链三大新命令1.19.0 最显著的变化集中在profilecli命令行工具上。profilecli是 Pyroscope 面向运维与数据查询的命令行客户端命令注册集中在 cmd/profilecli/main.go 中通过kingpin解析子命令。query topTop N 标签值分析query top用于在指定时间窗口内按标签聚合序列并输出总量最大的 Top N 标签组合是快速定位哪个服务/区域消耗最多 CPU等问题的利器。其实现位于 cmd/profilecli/query-top.go。核心参数定义见 query-top.go#L28-L36参数默认值说明--profile-typeprocess_cpu:cpu:nanoseconds:cpu:nanoseconds查询的剖析类型--top-n10输出前 N 条结果--label-namesservice_name聚合分组的标签名可多次指定--outputtable输出格式table或json--from/--tonow-1h/now查询时间窗口--query{}标签选择器底层实现上query top调用 Querier 服务的SelectSeriesRPC见 query-top.go#L58-L65按GroupBy标签拉取序列随后在客户端完成聚合对每个序列求和、按总量降序排序、截取 Top N最后以表格或 JSON 输出。实现细节值得注意由于SelectSeries会在窗口前多取一个步长step导致窗口起点处的数据点把(start-step, start]区间也统计进去sumPointsAfter函数专门跳过时间戳早于等于窗口起点的点见 query-top.go#L161-L175避免总量被近似翻倍。输出格式化时按样本单位自适应——nanoseconds转成人类可读的时长、bytes用 humanize 格式化见 query-top.go#L177-L185。示例# 查看过去 1 小时各服务 CPU 消耗 Top 10 profilecli query top --url http://localhost:4040 \ --from now-1h --to now \ --profile-type process_cpu:cpu:nanoseconds:cpu:nanoseconds \ --label-names service_name --top-n 10 # JSON 输出便于脚本消费 profilecli query top --url http://localhost:4040 \ --label-names service_name region --output jsonrecording-rules规则自助服务recording-rules子命令让用户无需修改后端配置即可自助创建、查看和删除 recording rules实现位于 cmd/profilecli/recording_rules.go通过RecordingRulesServicesettingsv1的 Connect RPC与后端交互。支持的子命令注册见 main.go#L136-L146子命令说明备注list列出所有规则访问 Grafana Cloud datasource 时需profiles-config:read权限get rule_id获取指定规则-o可写入文件需profiles-config:readcreate -f file从 YAML/JSON 文件创建规则需profiles-config:writedelete rule_id删除规则需profiles-config:write规则定义支持matchers标签匹配器、metric_name指标名、group_by聚合标签、external_labels外部标签以及function_name栈帧过滤即StacktraceFilter字段。create命令的示例消息直接内嵌在源码中见 recording_rules.go#L17-L28# rule.yaml matchers: - { __profile_type__process_cpu:cpu:nanoseconds:cpu:nanoseconds, regionemea} metric_name: profiles_recorded_cpu_usage_function_total_gc_nanoseconds group_by: - service_name function_name: runtime.gcBgMarkWorker# 创建规则记录 emea 区域每个服务的 GC 函数总 CPU 消耗 profilecli recording-rules create -f rule.yamllist/get输出规则时会标注(backend provisioned - read only)提示该规则为后端预置、只读见 recording_rules.go#L72-L76。kube-proxyKubernetes 微服务统一访问代理kube-proxy通过 kubectl 在本地建立一个反向代理将 Pyroscope 集群中多个微服务distributor、query-frontend、tenant-settings、ad-hoc-profiles统一暴露到单一端点解决多微服务需分别做端口转发的痛点。实现位于 cmd/profilecli/kube_proxy.go。参数见 kube_proxy.go#L51-L63参数默认值说明--context/-c空默认 contextKubernetes context支持KUBERNETES_CONTEXT环境变量--namespace/-ndefault命名空间支持KUBERNETES_NAMESPACE--label-selector/-l空用于发现 Pyroscope Service 的标签选择器--listen-addr127.0.0.1:4242本地监听地址工作流程见 kube_proxy.go#L65-L96服务发现通过kubectl get services --selector ... -o json枚举服务仅保留app.kubernetes.io/component属于distributor、query-frontend、tenant-settings、ad-hoc-profiles之一、且非 headlessclusterIP ! None的服务见 kube_proxy.go#L139-L191。启动 kubectl proxy在/tmp/pyroscope-kubectl-proxy.sock建立 Unix socket。按路径前缀路由根据routingRule如/ingest路由到 distributor将请求反向代理到对应组件。使用方式# 将集群中所有 Pyroscope 服务统一暴露到本地 127.0.0.1:4242 profilecli kube-proxy --namespace pyroscope --listen-addr 127.0.0.1:4242查询命令的可用性增强除新命令外1.19.0 对既有查询命令做了多项增强query series支持--outputtable|json序列标签查询可选择表格或 JSON 输出便于脚本化消费。query profile新增--span-selector按 trace span ID 过滤剖析数据见 query.go#L113。它与--stacktrace-selector、--profile-id、--trace-id互斥且不支持--async校验逻辑见 query.go#L120-L155--span-selector按 span ID 过滤对应 span-aware SDK 插桩产生的 span exemplar--profile-id按剖析文件 UUID 精确下钻从 exemplar 查询得到--trace-id按 128-bit trace id 过滤样本。--force/-f覆盖输出文件query profile与query go-pgo输出到已存在文件时默认报错-f可强制覆盖见 main.go#L76。--tree模式改用SelectMergeStacktraces当输出树状剖析时客户端调用SelectMergeStacktraces而非SelectMergeProfile提升栈轨迹合并场景的效率与准确性。数据接入与存储侧变更支持 JavaScript/TypeScript 源码集成1.19.0 新增 JS/TS 源码集成支持配合 source code mapping 可将前端剖析结果映射回源码文件便于在前端应用中定位性能瓶颈。可配置跳过标签清洗label sanitization默认情况下 Pyroscope 会清洗标签名例如将点号.替换为下划线_见 pkg/validation/validate.go 中的sanitizedLabelNames指标与清洗逻辑。1.19.0 新增配置项允许跳过标签清洗保留原始标签名适用于标签名本身包含特殊字符、且下游消费端不依赖清洗规则的场景。S3 新增aws_sdk_auth认证选项此前 Pyroscope 的 S3 客户端通过显式配置access_key_id/secret_access_key完成认证。1.19.0 在 pkg/objstore/providers/s3/config.go 中新增native_aws_auth_enabled即aws_sdk_auth配置storage: s3: bucket_name: pyroscope-data region: us-east-1 native_aws_auth_enabled: true # 使用 AWS SDK 默认认证链该选项开启后S3 客户端将使用 AWS SDK for Go 的默认认证方法——即读取 AWS 标准环境变量AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY、AWS_PROFILE等与~/.aws/config等已知配置文件flag 说明见 config.go#L115并将其映射到底层 objstore 客户端的AWSSDKAuth字段见 pkg/objstore/providers/s3/bucket_client.go#L62。该配置标记为 experimental适合使用 IRSA、EKS Pod Identity 或本地aws configure凭证的场景。Debug info 上传服务1.19.0 新增 debug info 上传服务配合profilecli debuginfo子命令upload/list/delete注册见 main.go#L154-L160实现对调试符号文件含 GNU build ID的上传、查询与删除为符号化symbolization流程提供自助式 debuginfo 管理能力。查询路径与剖析能力优化Ad-hoc profiles Diff RPC新增针对 ad-hoc 剖析的差异对比 RPC支持对两份剖析数据做差分分析。从 span/单条剖析检索 heatmap允许从 span exemplar 或单条剖析直接生成热力图。AttributeTable 字符串驻留string interningexemplar 标签改用 AttributeTable 实现字符串驻留降低高基数标签场景下的内存占用。查询诊断query diagnosticsv2 管理界面新增查询诊断信息配合profilecli query-tracer便于定位慢查询。符号化重构为 per-query backendWrapper将符号化逻辑重构为按查询粒度的后端包装器backendWrapper提升查询路径的可观测性与隔离性。lidia 支持 gopclntablidia 符号解析器新增 Go pclntab 支持并修复为稳定排序提升 Go 程序符号解析的准确性。稳定性修复要点1.19.0 修复了多个影响正确性与稳定性的问题profile ID 过滤改为 join 后过滤不再做谓词下推predicate push-down修正过滤语义。memberlist 指标增加pyroscope_前缀避免与 Prometheus 内置指标命名冲突。修复字符串表访问正确访问 str value避免错误丢弃字符串表中的合法值。Exemplar 值类型修正uint64 → int64统一数据类型。修复Tree.IterateStacks在根节点超过 1024 时的 panic。DropGoTypeParameters改用手工字符串扫描替代正则提升性能并避免正则回溯问题。jfr-parser 升级至 v0.15.0改进 JFRJava Flight Recorder解析。文档与示例更新配套文档更新包括更新 profilecli 文档以反映最新命令变化、更新 Java profile types 支持说明、更新 eBPF profiler 支持语言列表、从 Python 客户端配置中移除detect_subprocesses、明确 Helm chart 版本策略、新增 Java wall profiles 的 traces-to-profiles 示例以及 eBPF profiler 文档/示例改用官方构建产物。升级建议从 1.18 升级到 1.19 时建议关注profilecli 命令变更query profile --tree底层切换为SelectMergeStacktraces如果依赖旧的树输出格式请回归验证新增的--span-selector与--profile-id/--trace-id互斥脚本中需避免混用。S3 认证如启用native_aws_auth_enabledexperimental请确认运行环境具备 AWS SDK 默认认证链可读取的凭证。标签清洗配置如需保留原始标签名含特殊字符按上文配置关闭清洗并确认下游查询与告警规则不受影响。指标命名memberlist 相关指标已加pyroscope_前缀检查依赖旧指标名的告警与仪表盘。详细的完整变更列表可对照 1.18.0 与 1.19.0 的 changelog diff 查看发布说明正文提供了 compare 链接本文涉及的源码均可通过上方相对路径在仓库中进一步研读。【免费下载链接】pyroscopeContinuous Profiling Platform. Debug performance issues down to a single line of code项目地址: https://gitcode.com/GitHub_Trending/py/pyroscope创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Grafana Pyroscope 1.19 发布解读：profilecli 查询工具链、Kubernetes 代理与对象存储认证增强
Grafana Pyroscope 1.19 发布解读profilecli 查询工具链、Kubernetes 代理与对象存储认证增强【免费下载链接】pyroscopeContinuous Profiling Platform. Debug performance issues down to a single line of code项目地址: https://gitcode.com/GitHub_Trending/py/pyroscopeGrafana Pyroscope 1.19 是面向持续剖析Continuous Profiling平台的一次重要版本更新重点围绕profilecli 命令行工具链新增query top、recording-rules、kube-proxy等命令、标签与 trace/span 查询能力、S3 原生 AWS SDK 认证以及debuginfo 上传服务展开。本文以 1.19 发布说明为主体结合仓库源码逐项解读各新特性背后的实现原理、配置方式与使用场景帮助你快速掌握该版本新增的运维与查询能力。版本概览与发布节奏1.19 系列包含三个补丁版本发布说明结构为1.19.3更新 Go 工具链至 1.25.9。1.19.2安全修复——将github.com/go-jose/go-jose/v4升级至 v4.1.4涉及 JOSE 安全协议实现同时更新 .NET 文档。1.19.0主版本包含大量增强、修复与稳定性/性能改进。从发布节奏看1.19 沿用了 Pyroscope 团队主版本携带功能、补丁版本快速跟进安全与工具链的惯例。以下重点解读 1.19.0 的核心变更。profilecli 工具链三大新命令1.19.0 最显著的变化集中在profilecli命令行工具上。profilecli是 Pyroscope 面向运维与数据查询的命令行客户端命令注册集中在 cmd/profilecli/main.go 中通过kingpin解析子命令。query topTop N 标签值分析query top用于在指定时间窗口内按标签聚合序列并输出总量最大的 Top N 标签组合是快速定位哪个服务/区域消耗最多 CPU等问题的利器。其实现位于 cmd/profilecli/query-top.go。核心参数定义见 query-top.go#L28-L36参数默认值说明--profile-typeprocess_cpu:cpu:nanoseconds:cpu:nanoseconds查询的剖析类型--top-n10输出前 N 条结果--label-namesservice_name聚合分组的标签名可多次指定--outputtable输出格式table或json--from/--tonow-1h/now查询时间窗口--query{}标签选择器底层实现上query top调用 Querier 服务的SelectSeriesRPC见 query-top.go#L58-L65按GroupBy标签拉取序列随后在客户端完成聚合对每个序列求和、按总量降序排序、截取 Top N最后以表格或 JSON 输出。实现细节值得注意由于SelectSeries会在窗口前多取一个步长step导致窗口起点处的数据点把(start-step, start]区间也统计进去sumPointsAfter函数专门跳过时间戳早于等于窗口起点的点见 query-top.go#L161-L175避免总量被近似翻倍。输出格式化时按样本单位自适应——nanoseconds转成人类可读的时长、bytes用 humanize 格式化见 query-top.go#L177-L185。示例# 查看过去 1 小时各服务 CPU 消耗 Top 10 profilecli query top --url http://localhost:4040 \ --from now-1h --to now \ --profile-type process_cpu:cpu:nanoseconds:cpu:nanoseconds \ --label-names service_name --top-n 10 # JSON 输出便于脚本消费 profilecli query top --url http://localhost:4040 \ --label-names service_name region --output jsonrecording-rules规则自助服务recording-rules子命令让用户无需修改后端配置即可自助创建、查看和删除 recording rules实现位于 cmd/profilecli/recording_rules.go通过RecordingRulesServicesettingsv1的 Connect RPC与后端交互。支持的子命令注册见 main.go#L136-L146子命令说明备注list列出所有规则访问 Grafana Cloud datasource 时需profiles-config:read权限get rule_id获取指定规则-o可写入文件需profiles-config:readcreate -f file从 YAML/JSON 文件创建规则需profiles-config:writedelete rule_id删除规则需profiles-config:write规则定义支持matchers标签匹配器、metric_name指标名、group_by聚合标签、external_labels外部标签以及function_name栈帧过滤即StacktraceFilter字段。create命令的示例消息直接内嵌在源码中见 recording_rules.go#L17-L28# rule.yaml matchers: - { __profile_type__process_cpu:cpu:nanoseconds:cpu:nanoseconds, regionemea} metric_name: profiles_recorded_cpu_usage_function_total_gc_nanoseconds group_by: - service_name function_name: runtime.gcBgMarkWorker# 创建规则记录 emea 区域每个服务的 GC 函数总 CPU 消耗 profilecli recording-rules create -f rule.yamllist/get输出规则时会标注(backend provisioned - read only)提示该规则为后端预置、只读见 recording_rules.go#L72-L76。kube-proxyKubernetes 微服务统一访问代理kube-proxy通过 kubectl 在本地建立一个反向代理将 Pyroscope 集群中多个微服务distributor、query-frontend、tenant-settings、ad-hoc-profiles统一暴露到单一端点解决多微服务需分别做端口转发的痛点。实现位于 cmd/profilecli/kube_proxy.go。参数见 kube_proxy.go#L51-L63参数默认值说明--context/-c空默认 contextKubernetes context支持KUBERNETES_CONTEXT环境变量--namespace/-ndefault命名空间支持KUBERNETES_NAMESPACE--label-selector/-l空用于发现 Pyroscope Service 的标签选择器--listen-addr127.0.0.1:4242本地监听地址工作流程见 kube_proxy.go#L65-L96服务发现通过kubectl get services --selector ... -o json枚举服务仅保留app.kubernetes.io/component属于distributor、query-frontend、tenant-settings、ad-hoc-profiles之一、且非 headlessclusterIP ! None的服务见 kube_proxy.go#L139-L191。启动 kubectl proxy在/tmp/pyroscope-kubectl-proxy.sock建立 Unix socket。按路径前缀路由根据routingRule如/ingest路由到 distributor将请求反向代理到对应组件。使用方式# 将集群中所有 Pyroscope 服务统一暴露到本地 127.0.0.1:4242 profilecli kube-proxy --namespace pyroscope --listen-addr 127.0.0.1:4242查询命令的可用性增强除新命令外1.19.0 对既有查询命令做了多项增强query series支持--outputtable|json序列标签查询可选择表格或 JSON 输出便于脚本化消费。query profile新增--span-selector按 trace span ID 过滤剖析数据见 query.go#L113。它与--stacktrace-selector、--profile-id、--trace-id互斥且不支持--async校验逻辑见 query.go#L120-L155--span-selector按 span ID 过滤对应 span-aware SDK 插桩产生的 span exemplar--profile-id按剖析文件 UUID 精确下钻从 exemplar 查询得到--trace-id按 128-bit trace id 过滤样本。--force/-f覆盖输出文件query profile与query go-pgo输出到已存在文件时默认报错-f可强制覆盖见 main.go#L76。--tree模式改用SelectMergeStacktraces当输出树状剖析时客户端调用SelectMergeStacktraces而非SelectMergeProfile提升栈轨迹合并场景的效率与准确性。数据接入与存储侧变更支持 JavaScript/TypeScript 源码集成1.19.0 新增 JS/TS 源码集成支持配合 source code mapping 可将前端剖析结果映射回源码文件便于在前端应用中定位性能瓶颈。可配置跳过标签清洗label sanitization默认情况下 Pyroscope 会清洗标签名例如将点号.替换为下划线_见 pkg/validation/validate.go 中的sanitizedLabelNames指标与清洗逻辑。1.19.0 新增配置项允许跳过标签清洗保留原始标签名适用于标签名本身包含特殊字符、且下游消费端不依赖清洗规则的场景。S3 新增aws_sdk_auth认证选项此前 Pyroscope 的 S3 客户端通过显式配置access_key_id/secret_access_key完成认证。1.19.0 在 pkg/objstore/providers/s3/config.go 中新增native_aws_auth_enabled即aws_sdk_auth配置storage: s3: bucket_name: pyroscope-data region: us-east-1 native_aws_auth_enabled: true # 使用 AWS SDK 默认认证链该选项开启后S3 客户端将使用 AWS SDK for Go 的默认认证方法——即读取 AWS 标准环境变量AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY、AWS_PROFILE等与~/.aws/config等已知配置文件flag 说明见 config.go#L115并将其映射到底层 objstore 客户端的AWSSDKAuth字段见 pkg/objstore/providers/s3/bucket_client.go#L62。该配置标记为 experimental适合使用 IRSA、EKS Pod Identity 或本地aws configure凭证的场景。Debug info 上传服务1.19.0 新增 debug info 上传服务配合profilecli debuginfo子命令upload/list/delete注册见 main.go#L154-L160实现对调试符号文件含 GNU build ID的上传、查询与删除为符号化symbolization流程提供自助式 debuginfo 管理能力。查询路径与剖析能力优化Ad-hoc profiles Diff RPC新增针对 ad-hoc 剖析的差异对比 RPC支持对两份剖析数据做差分分析。从 span/单条剖析检索 heatmap允许从 span exemplar 或单条剖析直接生成热力图。AttributeTable 字符串驻留string interningexemplar 标签改用 AttributeTable 实现字符串驻留降低高基数标签场景下的内存占用。查询诊断query diagnosticsv2 管理界面新增查询诊断信息配合profilecli query-tracer便于定位慢查询。符号化重构为 per-query backendWrapper将符号化逻辑重构为按查询粒度的后端包装器backendWrapper提升查询路径的可观测性与隔离性。lidia 支持 gopclntablidia 符号解析器新增 Go pclntab 支持并修复为稳定排序提升 Go 程序符号解析的准确性。稳定性修复要点1.19.0 修复了多个影响正确性与稳定性的问题profile ID 过滤改为 join 后过滤不再做谓词下推predicate push-down修正过滤语义。memberlist 指标增加pyroscope_前缀避免与 Prometheus 内置指标命名冲突。修复字符串表访问正确访问 str value避免错误丢弃字符串表中的合法值。Exemplar 值类型修正uint64 → int64统一数据类型。修复Tree.IterateStacks在根节点超过 1024 时的 panic。DropGoTypeParameters改用手工字符串扫描替代正则提升性能并避免正则回溯问题。jfr-parser 升级至 v0.15.0改进 JFRJava Flight Recorder解析。文档与示例更新配套文档更新包括更新 profilecli 文档以反映最新命令变化、更新 Java profile types 支持说明、更新 eBPF profiler 支持语言列表、从 Python 客户端配置中移除detect_subprocesses、明确 Helm chart 版本策略、新增 Java wall profiles 的 traces-to-profiles 示例以及 eBPF profiler 文档/示例改用官方构建产物。升级建议从 1.18 升级到 1.19 时建议关注profilecli 命令变更query profile --tree底层切换为SelectMergeStacktraces如果依赖旧的树输出格式请回归验证新增的--span-selector与--profile-id/--trace-id互斥脚本中需避免混用。S3 认证如启用native_aws_auth_enabledexperimental请确认运行环境具备 AWS SDK 默认认证链可读取的凭证。标签清洗配置如需保留原始标签名含特殊字符按上文配置关闭清洗并确认下游查询与告警规则不受影响。指标命名memberlist 相关指标已加pyroscope_前缀检查依赖旧指标名的告警与仪表盘。详细的完整变更列表可对照 1.18.0 与 1.19.0 的 changelog diff 查看发布说明正文提供了 compare 链接本文涉及的源码均可通过上方相对路径在仓库中进一步研读。【免费下载链接】pyroscopeContinuous Profiling Platform. Debug performance issues down to a single line of code项目地址: https://gitcode.com/GitHub_Trending/py/pyroscope创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考