Release notes on Grafana Labs

Version 1.18 release notes

Wed, 08 Apr 2026 14:38:28 +0000

Version 1.18.1 release notes

Maintenance release to update Go version and address security vulnerability.

Changes

Update golang version to 1.24.13 (#4830)

Version 1.18.0 release notes

The Pyroscope team is excited to present Grafana Pyroscope 1.18.0

This release contains enhancements, fixes, improves stability & performance.

Notable changes are listed below. For more details, check out the 1.18.0 changelog.

Enhancements

The source code integration now supports Python (#4726, #4732, #4730)
Implement comprehensive profile size limits across ingestion endpoints (#4734)
Update golang version to 1.24.12 (#4760)
Set a maximum ingestion body size by default (#4761)
Update OpenTelemetry dependencies, proto=v1.9.0 profiles=v0.2.0 (#4731)
Enforce maxNodes optionally on SelectMergeProfile through limits in v2 (#4723)
Add benchmarks for timeseries query performance with exemplars (#4665)

Fixes

Fix exemplar value calculation for split profiles (#4753)
Relative matching for source code mapping (#4754)
VCS Service: Failed file lookup should be 404 instead of 500 (#4759)
Remove unintended double base64 encoding in vcs service (#4703)
Frontend: Bump qs to address CVE-2025-15284 (#4724)
Frontend: Bump sweetalert2 to address GHSA-457r-cqc8-9vj9, GHSA-8jh9-wqpf-q52c and GHSA-pg98-6v7f-2xfv (#4727)
Frontend: Bump @remix-run/router and react-router to address CVE-2026-22029 and CVE-2025-68470 (#4763)

Documentation

Rename GitHub integration to source code integration (#4755)
Update source code integration docs to include Java and Python support (#4651)
Fix inline link in eBPF docs (#4733)

Version 1.17 release notes

Wed, 08 Apr 2026 14:38:28 +0000

Version 1.17.0 release notes

The Pyroscope team is excited to present Grafana Pyroscope 1.17.0

This release contains enhancements, fixes, improves stability & performance.

Notable changes are listed below. For more details, check out the 1.17.0 changelog.

Enhancements

Exemplar support for individual profile retrieval (#4615) (#4621) (#4657) (#4657) (#4686) (#4605) (#4631)
Introduce additional metastore compaction metrics (#4625)
Add trace spans for query-frontend (#4620)
Add tracing instrumentation to source code integration #4607)
Minor symbolizer metrics improvements (#4597)
Parallelize mapping symbolization to improve query performance (#4594)
Add metric to track unsymbolized profile blocks at ingestion (#4619)
lidia: dynsym symbols (#4691)
perf: Merge duplicate annotations (#4646)
vcs: Allow to provide functionName to the GetFile API. (#4613)

Fixes

Address npm CVEs (#4682)
Fix update-examples after ruby upgrade (#4687)
Fix panic in pprof split when using relabel.LabelDrop (#4699)
Assign appropriate HTTP status codes (#4684)
Fetching go stdlib without configs (#4655)
Implement Speedscope profile merging (#4592)
limit max nodes in symbolization queries (#4629)
mask COS provider secret_key config CVE-2025-41118 (#4700)
Source code module path parsing (#4609)
Set file name and line number in symbolization (#4610)
SelectSeries not correct for single reports (#4617)
Return modified labels after validation sanitization (#4662)

Documentation

Fix reference to .goreleaser.yaml (#4658)
Update release documentation to address pain points (#4626)
Update release note docs to address website release notes (#4598)

Version 1.16 release notes

Wed, 08 Apr 2026 14:38:28 +0000

Version 1.16.2 release notes

Maintenance release to update Go version and address security vulnerability.

Changes

Update golang version to 1.24.11 (#4708)
Patch golang.org/x/crypto/ssh vulnerability (#4708)

Version 1.16.1 release notes

Maintenance release to address a security issue.

Changes

Fix: mask COS provider secret_key config CVE-2025-41118 (#4700)

Version 1.16.0 release notes

The Pyroscope team is excited to present Grafana Pyroscope 1.16.0

This release contains enhancements, fixes, improves stability & performance.

Notable changes are listed below. For more details, check out the 1.16.0 changelog.

Enhancements

Add OTLP HTTP/json and HTTP/protobuf ingestion (#4495)
Add a basic metric for metastore DLQ recovery (#4563)
Improve metastore observability (#4580)
Add option to add annotations to headless service (#4451)
Add admin pages for inspecting v2 blocks (#4480, #4543, #4555, #4560)
Performance: Cancel artificial delay on async ingest (#4261)
Add sanitized_label_names_total counter metric (#4501)
Add pyroscope-monitoring helm chart (#4525)
Implement utf8 label name client capability and use in UI/profilecli (#4442, #4490, #4493)
Add OTLP canary query (#4488)
Performance: add health check/warmup to segmentwriter to reduce first-write latency (#4453)
Update golang version to 1.24.9 (#4596)

Fixes

Fix distributor sampling rule processing priority (#4491)
Fix panic in ad-hoc profile upload (#4556)
Add ingest limits to connect push requests (#4586)
Add profile_name label to Speedscope profile ingestion (#4588)
Add stricter validation for metrics from profiles fields (#4522)
Ensure to build the same architecture image, as the current machine (#4552)
Fix go get in update-examples-cron.yml (#4547)
Handle Speedscope sample types in ingestion (#4568)
Handle utf-8 matchers correctly (#4496)
Fix Helm release only supports one changed chart at a time (#4583)
Fix OTLP: Guard against profiles with no lines (#4517)
Redirect to admin pages when no query API available (#4553)
Replace nop logger used in label validation (#4531)
Skip duplicated label name filtering in some cases (#4502)
Update deprecated GF_INSTALL_PLUGINS env var (#4554)
Avoid flushing empty tenant settings (quick win) (#4458)
Fix create fallback symbols for mappings without BuildIDs (#4527)
Fix go version for update-contributors (#4582)
Fix golang-push examples test (#4558)
Fix incorrect multitenancy header handling in new HTTP OTLP endpoint (#4559)
Fix not missing recording rules symbols by relaxing ObserveSymbols condition (#4545)
Fix opentelemetry-collector otlphttp exporter compatibility: gzip compression (#4579)
Fix panic when handling unsafe tenant name (#4519)
Use github app to update-make-docs workflow (#4548)
Don’t 500 on bad profile types (#4537)
Fix flaky admin test (#4528)
Pin node to v23 in examples until latest (v25) is supported (#4561)

Documentation

Update make docs procedure (#4551)
Generate API docs for connect-go API (#4408)

Version 1.15 release notes

Wed, 08 Apr 2026 14:38:28 +0000

Version 1.15.3 release notes

Maintenance release to update Go version and address security vulnerability.

Changes

Update golang version to 1.24.11 (#4707)
Patch golang.org/x/crypto/ssh vulnerability (#4707)

Version 1.15.2 release notes

Maintenance release to address a security issue.

Changes

Fix: mask COS provider secret_key config CVE-2025-41118 (#4700)

Documentation

Generate API docs for connect-go API (#4408)
Fix docs release workflow (#4534)

Version 1.15.1 release notes

Maintenance release to update Go version.

Changes

Update golang version to 1.24.9 (#4596)

Version 1.15.0 release notes

The Pyroscope team is excited to present Grafana Pyroscope 1.15.0

This release contains enhancements, fixes, improves stability & performance.

Notable changes are listed below. For more details, check out the 1.15.0 changelog.

Enhancements

Metastore auto-join (#4474)
Bearer token support in profilecli (#4475)
Helm support for v1/v2 storage (#4417)
Sample type relabeling in distributor (#4376)
Stacktrace selector support for SelectMergeStacktraces requests (#4380)
Metadata index retention policy (#4148)
Azure ClientSecretCredential authentication support (#4477)
Add –max-nodes flag to query profile command in profilecli (#4433)
Allow to optionally enforce maxNodes through limits (#4436)
Set querier.max-flamegraph-nodes-max default to 1,048,576 (#4370)
Annotate sampled profiles (#4375)
Improve request observability (#4400)
Serve recording rules from config in tenant-settings (#4299)
Add block list/inspect to profilecli (#4412)
Extract signal correlation information from OTEL profiles (#4393)
Distributor performance improvements: single profile series processing (#4342), new metrics (#4367), multi-stage receive metrics (#4384)
Performance: Use stacktrace tree for adhoc uploads (#4438)
Performance: Initialize dataset segment head lazily (#4274)
Performance: Avoid merging single profiles (#4421)
Performance: Add searchHint to getSeriesIndex (#4286)
Reduce memory allocations when rendering diff flamegraphs (#4430)
Improve distributor sampling rule evaluation (#4347)

Fixes

Fix panic in query pprof path (#4429)
Fix panic when handling error in metastore snapshot compaction (#4313)
Fix JFR: merge EnhancerBySpringCGLIB classes (#4471)
Fix issue in pprof split when using relabel.LabelDrop (#4365)
Fix breaking change in ProfileTypes v2 (#4398)
Fix GetTenantStats reports wrong stats (#4394)
Fix goroutine leak in compaction-worker (#4409)
Fix location with empty lines parquet roundtrip (#4407)
Fix nil check for empty stacktrace filters (#4308)
Fix revert unintended change in profile merge (#4410)
Fix vcs.decodeToken can eat an error (#4336)
Fix Docker ebpf-otel example matches k8s versions (#4386)
Fix integration test data of partially symbolized profile (#4446)
Reapply: Handle duplicate validation correctly when sanitizing (#4265)
Revert: Correct HasFunctions flags for mixed symbolization profiles (#4457)

Documentation

Update docs and examples for .NET to add LD_LIBRARY_PATH (#4456)
Add doc for finding URL, password, and user in Cloud Profiles (#4352)
Update architecture and OS requirements for .NET (#4334)
Update ebpf supported languages content (#4338)
Fix typo and update link for GitHub integration (#4374)
Update ride share tutorial documentation (#4277)
Mention the dependency on the compactor feature flag (#4302)
Fix .NET naming (#4289)

Version 1.14 release notes

Wed, 08 Apr 2026 14:38:28 +0000

Version 1.14.1 release notes

Maintenance release to address security advisories.

Changes

Update golang version to 1.23.1 (99610e61)
chore: Remove oauth2-proxy (#4345)

Version 1.14.0 release notes

The Pyroscope team is excited to present Grafana Pyroscope 1.14.0

This release contains enhancements, improves stability & performance.

Notable changes are listed below. For more details, check out the 1.14.0 changelog.

Enhancements

Profile throttling (#3956)
Improve performance of *stacktraceTree.insert (#4033)
Improve performance of *deduplicatingSlice.ingest (#4037)
Symbolization support (#4093, #3799, #4173, #4259)
Dynamically named usage groups (#4210, #4231)
Mark storage.prefix as non experimental (#4086)

Fixes

Validate query range that start <= end (#4229)
Fix goroutine leaks (#4239, #4237)
Fix panic in vcs getCommit when author empty (#4152)
Storage prefix validation (#4044)
Drop malformed locations (#4051)
Fix object download error branch panic (#4102)
Separate query and block context (#4122)

Documentation

Add documentation about usage stats (#4104)
Add OSS documentation on the Source Code GitHub integration (#4129)
Add profiling instructions for MacOS (#4202)

Version 1.13 release notes

Wed, 08 Apr 2026 14:38:28 +0000

Version 1.13.6 release notes

Maintenance release to address security advisories.

Changes

Update golang version to 1.23.1 (05cd2005)
chore: Remove oauth2-proxy (#4345)

Version 1.13.5 release notes

Maintenance release to address security advisories.

Changes

Update golang version to 1.23.10 (#4245)
Update golang.org/x/net to v0.38.0 to address CVE-2025-22872

Version 1.13.4 release notes

This was a release to test the health of our CI pipelines

Version 1.13.3

This release version was skipped

Version 1.13.2 release notes

To address bugs found in v1.13.1, we have released a patch version

Notable changes are listed below. For more details, check out the 1.13.2 changelog.

Changes

Update golang version to 1.23.8 (#4116)

Version 1.13.1 release notes

To address bugs found in v1.13.0, we have released a patch version

Notable changes are listed below. For more details, check out the 1.13.1 changelog.

Fixes

Storage prefix validation (#4044)
Update minio-go to restore AWS STS auth (#4056)

Version 1.13.0 release notes

The Pyroscope team is excited to present Grafana Pyroscope 1.13.0

This release contains enhancements, improves stability & performance.

Notable changes are listed below. For more details, check out the 1.13.0 changelog.

Enhancements

gzip: escape heap allocation (#3922)
perf: add log buffer (#3947)
perf: add async log writer (#3953)

Fixes

Remove duplicate service_name and app_name labels during ingestion (#3951)
IPv6 support fixes (#3919)
Drop negative samples (#3955)

Version 1.12 release notes

Wed, 08 Apr 2026 14:38:28 +0000

Version 1.12.1 release notes

To address bugs found in v1.12.0, we have released a patch version.

Notable changes are listed below. For more details, check out the 1.12.1 changelog.

Fixes

Storage prefix validation (#4044)

Changes

Update to golang 1.23.7 (necessary for a decendency upgrade)

Version 1.12.0 release notes

The Pyroscope team is excited to present Grafana Pyroscope 1.12.

This release contains enhancements, improves stability & performance.

Notable changes are listed below. For more details, check out the 1.12.0 changelog.

Enhancements

Added metadata label query capability in v2 (#3749)
Implemented configurable symbols partitioning (#3820)
S3 storage can now configure the bucket-lookup-type (#3788)

Fixes

String table access validation in distributor (#3818)
Several OpenTelemetry (OTel) related fixes: (#3795, #3793, #3794)
Config struct validation implementation (#3837)
Expanded error logging to include 400 errors (#3832)

Documentation

Restructure Pyroscope documentation and share content (#3798)
Documentation fixes and example updates (#3812, #3806, #3828, #3809, #3823)

Version 1.11 release notes

Wed, 08 Apr 2026 14:38:28 +0000

Version 1.11 release notes

The Pyroscope team is excited to present Grafana Pyroscope 1.11.

This release improves stability, performance, and documentation.

Notable changes are listed below. For more details, check out the 1.11.0 changelog.

Fixes

Remove export to flamegraph.com (#3729)
Flameql: allow slashes in application name (#3722)
OTEL format fixes (#3741, #3792)

Documentation

Documentation and example updates (#3727, #3664, #3762, #3686, #3693, #3770, #3772, #3695, #3674, #3584, #3658, #3678, #3713, #3777, #3701, #3789, #3775, #3698, #3764, #3780, #3696, #3753, #3740, #3782, #3668, #3773)

Version 1.10 release notes

Wed, 08 Apr 2026 14:38:28 +0000

Version 1.10 release notes

The Pyroscope team is excited to present Grafana Pyroscope 1.10.

This version of Pyroscope adds experimental support for OpenTelemetry profiles (#2177). The OTLP protocol is not stable. For more information about the protocol, refer to OpenTelemetry announces support for profiling.

In addition, this release improves stability, performance, and documentation.

Notable changes are listed below. For more details, check out the 1.10.0 changelog.

Improvements and updates

Use profilecli admin blocks query to execute queries directly to single or multiple blocks hosted in your local host or remote bucket. (#3618, #3625, #3610)
Rename merge commands to profile in Profile CLI (profilecli) (#3630)
Deprecate cookie generated on server for GitHub integration (#3573)
Add k6 middleware to Pyroscope (#3580)

Fixes

(eBPF) Use uint64 for proc offset (#3656)
CI fixes (#3634, #3629, #3632, #3631, #3636, #3605, #3525)

Documentation

Add instructions for how to receive profiles from Pyroscope SDKs for Grafana Alloy (#3685)
Update examples and references to Grafana Alloy from Grafana Agent (#3621)
Update and expand profiling types documentation for the introduction and instrumentation (#3659)
Other documentation and example updates (#3662, #3644, #3607, #3655, #3611, #3638, #3661, #3614, #3612, #3648)

Version 1.9 release notes

Wed, 08 Apr 2026 14:38:28 +0000

Version 1.9 release notes

We are excited to present Grafana Pyroscope 1.9.

We’ve improved stability, performance, and documentation.

Notable changes are listed below. For more details, check out the 1.9.0 changelog.

Improvements and updates

Performance improvement during profile ingestion (https://github.com/grafana/pyroscope/pull/3569, https://github.com/grafana/pyroscope/pull/3561)
Support resolve symbols in mini debug info (https://github.com/grafana/pyroscope/pull/3590)
Make service_name configurable through environment variable (https://github.com/grafana/pyroscope/pull/3589)
Add limit to SelectSeries API (https://github.com/grafana/pyroscope/pull/3602)
Add topologySpreadConstraint in Helm (https://github.com/grafana/pyroscope/pull/3539)
Rename GitSession to pyroscope_git_session (https://github.com/grafana/pyroscope/pull/3542)

Fixes

Make pprof merge thread-safe (https://github.com/grafana/pyroscope/pull/3564)
Fix flaky tests (https://github.com/grafana/pyroscope/pull/3571)
Fix slice init length (https://github.com/grafana/pyroscope/pull/3600)
Fix issues when porting alloy/pyroscope to android (https://github.com/grafana/pyroscope/pull/3582)

Documentation improvements

Update the README to highlight explore profiles (https://github.com/grafana/pyroscope/pull/3581)
Update NodeJS examples (https://github.com/grafana/pyroscope/pull/3555)
Example for Java profiling using Grafana Alloy in Kubernetes (https://github.com/grafana/pyroscope/pull/3603)

Version 1.8 release notes

Wed, 08 Apr 2026 14:38:28 +0000

Version 1.8 release notes

We are excited to present Grafana Pyroscope 1.8.

We’ve improved stability, performance, and documentation.

Notable changes are listed below. For more details, check out the 1.8.0 changelog.

Improvements and updates

Version 1.8 includes the following improvements and updates:

Add ready command to profilecli (#3497)

Fixes

Version 1.8 includes the following fixes:

Handle context correctly in selectTree during queries on store-gateway with deduplication (#3504)
Bring back update-contributors but in go (#3512)
FlameQL: allow dots in tag name (#3479)
Fix pprof grouping for samples with span_id (#3450)

Documentation improvements

Version 1.8 includes the following documentation updates:

Fix broken links from doc 404 report (#3489)
Clarify which URL to use with profilecli (#3526)
Add notice about heap profiling (#3494)
Remove old GF_FEATURE_TOGGLES_ENABLE=flameGraph (#3446)

Version 1.7 release notes

Wed, 08 Apr 2026 14:38:28 +0000

Version 1.7 release notes

We are excited to present Grafana Pyroscope 1.7.

This release includes several new features:

The ability to relabel profiles at ingest time
Per-app (service) usage metrics
Stacktrace selectors for merge profile queries
Profile pprof export tailored to Go PGO

Additionally, we’ve improved stability, performance, and documentation.

Notable changes are listed below. For more details, check out the 1.7.0 changelog.

Improvements and updates

Version 1.7 includes the following improvements and updates:

Ability to relabel profiles at ingest (#3369)
Use Grafana Alloy (instead of Grafana Agent) in the Helm chart (#3381)
Per-app usage metrics (#3429)
Add stacktrace selectors to query merge (#3412)
pprof export for Go PGO (#3360)
Custom binary format for symdb (#3138)
Repair truncated Go CPU profiles (#3344)
Add initial load tests (#3331)
Align default step for /render with Grafana (#3326)
Allow use of different protocols in profilecli (#3368)
Various performance improvements (#3395, #3345, #3349, #3351, #3386, #3348, #3358)
Improve readiness check for ingesters and frontend (#3435)

Fixes

Version 1.7 includes the following fixes:

Fix error handling in filterProfiles (#3338)
Fix frontend header handling (#3363)
Fix line numbers for pyspy (#3337)
Don’t compute delta on relabeled godeltaprof memory profiles (#3398)
Honor stacktrace partitions at downsampling (#3408)
Fix infinite loop in index writer (#3356)

Documentation improvements

Version 1.7 includes the following documentation updates:

Add a Grafana installation to all examples (#3431)
Fix broken links (#3440)
Remove --stability-level for Alloy v1.2 (#3382)
Add parameters from otel-profiling-java (#3444)
Add supported languages for eBPF (#3434)
Link to supported languages (#3432)
Update link to play.grafana.org (#3433)

Version 1.6 release notes

Wed, 08 Apr 2026 14:38:28 +0000

Version 1.6 release notes

We are excited to present Grafana Pyroscope 1.6.

This release focuses on improving stability and performance to make Pyroscope more reliable and faster.

Notable changes are listed below. For more details, check out the Full 1.6.0 Changelog: https://github.com/grafana/pyroscope/compare/v1.5.0...v1.6.0.

Improvements and updates

Version 1.6 includes the following improvements and updates:

eBPF: Allow resizing maps (https://github.com/grafana/pyroscope/pull/3181)
Performance: optimize tree node insertion (https://github.com/grafana/pyroscope/pull/3105)
Performance: tune row iterator buffer size (https://github.com/grafana/pyroscope/pull/3266)
Compactor: Add a compactor rewriter LRU cache (https://github.com/grafana/pyroscope/pull/3165)
Helm: Add HPA Support for all Pyroscope components (https://github.com/grafana/pyroscope/pull/3157)
API: Call for exposing query analysis (https://github.com/grafana/pyroscope/pull/3276)
API: Use custom codec for vtproto within connect-go (https://github.com/grafana/pyroscope/pull/3310)
Config: Add S3 force-path-style parameter (https://github.com/grafana/pyroscope/pull/3158)
Config: Add flag to disable printing banner (https://github.com/grafana/pyroscope/pull/3123)

Fixes

Version 1.6 includes the following fixes:

Fix bug in query frontend diff handling (https://github.com/grafana/pyroscope/pull/3315)
Fix panic when dealing with missing mapping ID (https://github.com/grafana/pyroscope/pull/3188)
Fix empty string handling in pprof (https://github.com/grafana/pyroscope/pull/3204, https://github.com/grafana/pyroscope/pull/3244)
Fix panic recovery interceptor (https://github.com/grafana/pyroscope/pull/3246)
Fix pprof merge profiles ignoring sample type stub (https://github.com/grafana/pyroscope/pull/3198)
eBPF: Fix issue when a cls arg is a cell (https://github.com/grafana/pyroscope/pull/3280)
eBPF: handle case when self is put in cell (https://github.com/grafana/pyroscope/pull/3284)

Documentation improvements

Version 1.6 includes the following documentation updates:

Add changes from Cloud Profiles UI to OSS docs (https://github.com/grafana/pyroscope/pull/3243)
Add links to supported profile types in SDKs (https://github.com/grafana/pyroscope/pull/3228)
Add note for Agent to Alloy to docs (https://github.com/grafana/pyroscope/pull/3201, https://github.com/grafana/pyroscope/pull/3272)
Add Pyroscope landing page for doc (https://github.com/grafana/pyroscope/pull/3176)
Update screenshots in Pyroscope UI (https://github.com/grafana/pyroscope/pull/3234)

Version 1.5 release notes

Wed, 08 Apr 2026 14:38:28 +0000

Version 1.5 release notes

We are excited to present Grafana Pyroscope 1.5.

This release focuses on improving stability and interoperability to make Pyroscope more reliable and easier to use.

Notable changes are listed below. For more details, check out the 1.5.0 changelog.

Improvements and updates

Version 1.5 includes the following improvements and updates:

Repair Go stack traces (#3014)
eBPF: Aggregate python stacks in kernel space instead of user space (#2996)
eBPF: Propagate PID namespace to kernel space (#3008)
eBPF: Run tests on many kernels (#3025)
eBPF: Add support for more Python versions (#3035)
Improve trace span propagation in streaming requests (#2992)
Drop type params from Go function names (#3010)
Disable vt proto pools (#3034)
Allow running multiple rideshare examples in the same network namespace (#2990)

Fixes

Version 1.5 includes the following fixes:

Wait for ongoing queries to finish at close (#3030)
Fix data duplication in the read path (#3100, #3103)
Fix merging of empty pprof samples (#3031)
Correctly format makefile help rule (#3021)

Documentation improvements

Version 1.5 includes the following documentation updates:

Reorganize examples folder to match documentation structure (#3026)
Update Configure the client and span profiles doc (#3028)
Improve intro and span profiles docs (#3089, #3099)

Version 1.4 release notes

Wed, 08 Apr 2026 14:38:28 +0000

Version 1.4 release notes

We are excited to present Grafana Pyroscope 1.4.

This release includes several new features which are precursors to larger projects like:

Adhoc profiling
Time series scoped to a flame graph function
Traces to profiles tooling

Additionally, numerous other changes improve stability, performance, and documentation.

Notable changes are listed below. For more details, check out the 1.4.0 changelog.

Features and enhancements

Features and enhancements for version 1.4 include:

Adhoc profiles API (#2963)
Add query-tracer to profilecli (#2966)
Add ServiceMonitor support to Helm chart (#2944, #2929, #2967)
Scope time series to flame graph node API (#2961)

Improvements and updates

Version 1.4 includes the following improvements and updates:

Improve release workflows and documentation (#2954, #2989, #2948, #2952, #2960, #2975)
Improve block grouping in admin block viewer (#2947)
Remove tenant settings from microservices deploy (#2962)
Add test ids (#2957)
Bump chart app version (#2940)
Bump godeltaprof and jfr-parser dependencies (#2955)
Update default image tag in chart (#2941)
Per target configuration with labels (#2977)
Async profile row iterator (#2953)
Disable Go names decoration (#2976)

Fixes

Version 1.4 includes the following fixes:

Add missing module dependencies (#2969)
Fix missing icon assets (#2985)
Store-gateway: Handle index read error properly (#2959)
Use correct field in mappingsKey (#2964)
Bump golang.org/x/net (#2986)
Fix elf base for unaligned PT_LOAD offset, make build id error not fatal (#2983)

Documentation improvements

Version 1.4 includes the following documentation updates:

Add 1.3 release notes for docs (#2949)
Add span profiles documentation (#2982)
Update eBPF and Java documentation (#2972, #2973)

Version 1.3 release notes

Wed, 08 Apr 2026 14:38:28 +0000

Version 1.3 release notes

We are excited to present Grafana Pyroscope 1.3.

This release focuses on improving stability and interoperability to make Pyroscope more reliable and easier to use.

Several major improvements were made to the compaction process:

Improved performance and storage efficiency of the symbol compaction process.
Optimized data processing by adding support for time-based down-sampling during the compaction process.
Added tracing integration to compaction for better observability.
Improved system stability during compaction shutdown
Added a profilecli compact command

Notable changes are listed below. For more details, check out the 1.3.0 changelog.

Features and enhancements

Features and enhancements for version 1.3 include:

Enhanced symbol compaction process: Improved performance and storage efficiency with the new symbol compaction process (#2864).
Introduced function selector in pprof query: More precise profiling with the addition of a function selector (#2878).
Support for time-based downsampling during compaction: Optimized data processing with time-based strategies (#2880).
Added tracing integrations to compaction: Better observability in the compaction process (#2876).
Added language mapping for Grafana Agent in Java: Expanded profiling capabilities (#2866).

Improvements and updates

Version 1.3 includes the following improvements and updates:

Updated Alpine and Golang versions: Enhanced security and performance with the latest versions of Alpine (3.18.5) and Golang (1.21.5) (#2901, #2902).
Injected JFR labels into pprof: Enriched profiling data for better insights (#2868).
Streamlined Makefile and go.mod: Better build process with updated Makefile and tidied go.mod (#2900).
Updated agent configuration in Helm: More flexible deployments in Kubernetes environments (#2879).
Refactored eBPF installation documentation: Improved clarity and usability in eBPF documentation (#2849).
Upgraded connect-go, protobuf, and buf: Improved system interoperability (#2909).
Enhanced compaction shutdown process: Improved system stability during shutdowns (#2903).
Implemented profilecli compact command: Efficient data management with the new command (#2869).

Fixes

Version 1.3 includes the following fixes:

Fixed panic in compaction benchmark: Addressed issues causing system instability (#2918).
Resolved block cleanup process issues: Ensured system integrity and stability (#2916).
Fixed pprof profile builder panics: Enhanced system stability (#2917).
Corrected profile types call handling: Better data management without bucket store (#2910).
Removed delta reserved labels from storage: Optimized the storage system (#2920).
Increased parquet read buffer size: Improved data processing efficiency (#2924).

Documentation improvements

Version 1.3 includes the following documentation updates:

Enhanced memory overhead documentation: Deeper insights into system performance (#2895).
Updated Node.js documentation: Fixed Markdown link issues for better clarity (#2890).
Expanded java.md documentation: Comprehensive Java profiling guidance (#2904).
Removed dependency on Grafana Agent: Streamlined Pyroscope architecture (#2913).
Updated various sections: Intro, analyze, sampling, and SDK pages now offer clearer and more detailed information (#2855, #2844, #2854, #2851, #2861).
Launched a 1-minute YouTube short on eBPF: Providing a quick and informative overview of eBPF (#2893).

Version 1.2 release notes

Wed, 08 Apr 2026 14:38:28 +0000

Version 1.2 release notes

We are excited to present this release of Grafana Pyroscope packed with 150 commits.

In this release, we’ve introduced significant enhancements to our microservice mode, aiming to boost performance and streamline operations. The compactor component has been added to optimize block management, improving query speed and reducing replication factor overhead.

Our physical planning has undergone optimization, ensuring that data deduplication occurs only when necessary. Additionally, we’ve initiated tracing integrations, allowing for the inclusion of span ids in profiling samples and enabling flame graph filtering.

For users leveraging Function as a Service (FaaS) environments, we’ve enhanced profiling data ingestion by automatically aggregating profiles. This not only reduces the number of profiles but also contributes to improved overall efficiency.

We’ve invested substantial effort in optimizing the read path and refining query performance, delivering a smoother user experience.

Trace to profiles integrations

Notable changes are listed below. For more details, check out the Full 1.2.0 Changelog: https://github.com/grafana/pyroscope/compare/v1.1.5...v1.2.0

Version 1.2.x changelogs:

Features and enhancements

This section lists all new features and enhancements for version 1.2.x.

Version 1.2.1

Features and enhancements for version 1.2.1:

Add a way to control the aggregation type for the SelectSeries API (#2758)
Add admin module serving the bucket web tool (#2724)
Add block compaction level to bucket index (#2721)
Introduce the first release of the Cluster API Versioning (#2780)
Implement Settings API (#2711)
Develop optimized pprof symbolication and pprof truncation (#2679, #2754)
Add the first iteration of the blocks viewer cli tool (#2697)

In addition, the following improvements and updates for version 1.2.1:

Improve SelectMatchingProfiles performance (#2734)
Enhance language detection performance (#2823)
Refactor Azure bucket configs (#2742)
Update various dependencies and libraries (#2741, #2744, #2826, #2827, #2832)
Switch to relative links in block viewer to address issue with alternate base URLs (#2763)
Update styling to match Grafana (#2827)

Version 1.2

Enhancements for version 1.2:

728493e feat: Scalable Compactor (#2466)
d4e3b03 Create a physical plan for block querying (#2586)
1488496 Extend profile schema to support spans (#2508)
1e7ebd9 Allow to configure pyroscope high disk utilization (#2666)
4e8439d Optimize repeated row iterator (#2572)
f1b82c5 feat(ebpf): add pyperf (#2201)
25084ea Randomize sessions after aggregation (#2656)
3c5a959 Make max node limit configurable (#2658)

Bug fixes

Version 1.2.1

Fix duplicate @emotion/react import and favicon (#2798)
Resolve query split logic issues for LabelNames, LabelValues, and ProfileTypes (#2852)
Rename Phlare to Pyroscope (#2722)
Fix span name for BlockSelect from store-gateway (#2842)
Address issues in version merging in memberlist (#2815)
Correct handling of overriding extraArgs in components (#2751)
Remove go.mod replace for golang.org/x/exp (#2848)
Remove parquet page file buffer in symbdb (#2820)
Fix various issues in ebpf, ReduxQuerySync, and UI units (#2703, #2761, #2778, #2788, #2789, #2812, #2838)
Fix ingress for Pyroscope UI (#2807)

Version 1.2

e572d26 Cleanup failed segment before flushing. (#2606)
be7bc5d Fix symbols resolver race condition (#2665)
f4b0a60 fix(jfr): merge equal samples (#2652)

Documentation updates

Version 1.2.1

Add initial docs for the /pyroscope/render API endpoint (#2837)
Create “Ingest and analyze profile data” section in docs (#2828)
Add upgrade from standard pprof example (#2829)
Add compactor to docs (#2720)
Migrate from Standard pprof to Pyroscope for Continuous Profiling (#2830)
Add introductory material and how to use Pyroscope pages (#2834, #2836, #2839)

Version 1.2

We’ve added documentation for profilecli to query and upload pprof files.
We’ve also documented the store-gateway and compactor component.

Version 1.1 release notes

Wed, 08 Apr 2026 14:38:28 +0000

Version 1.1 release notes

The Pyroscope team is excited to announce the second release. This release allows to retrieve series from persistent storages like local disk and object store and also has a couple of performance improvements (e.g., JFR ingestion is handled a lot more efficiently).

As always, feedback is more than welcome, feel free to open issues/discussions. You can reach out to the team using:

Docker images

grafana/pyroscope

  docker pull docker.io/grafana/pyroscope:1.1.0

Improvements and enhancements

Switched to v1 Golang SDK.
Updated multiple dependencies including Go, Ruby, Django, Rust, and more.
Introduced meta fetcher that synchronizes filtered metadata locally.
Introduced pyroscope packaging via nfpm.
Use Grafana flame graph component.
‘ExportData’ now respects the ‘flamegraph.com’ related prop.
Introduced option to disable RBAC.
Introduced a tenant scanner.
Refactoring for block compaction to enable shard-splitting.
Improved multitenancy default behavior documentation.

Fixes

Addressed various race conditions and bug fixes.
Improved URL handling and pprof merges.
Fixed various documentation inconsistencies and outdated references.
Fixed broken links.
Resolved multiple issues related to dotnet and ebpf.
Addressed flaky tests and issues in ingestionAdapter.
Handle profiles without timestamps.

Documentation updates

Added tabs to Java docs and updated ebpf docs.
Added section for Apple arm64 builds.
Updated documentation for contributors.
Improved helm documentation.
Optimized and clarified querier API calls.

DevOps and tooling

Introduced Helm v1.0.0 release.
Automation added for brew releases.
Helm improvements: setting correct namespace, adding initContainers, hostNetwork, etc.
Refactored after dskit upgrade.
Updated rideshare examples for ingesting to grafana.com.

Version 1.0 release notes

Wed, 08 Apr 2026 14:38:28 +0000

Version 1.0 release notes

The Pyroscope team is excited to announce the first release. We’re committed to building the best continuous profiling experience in Grafana and contributing to that space along with the open-source community.

From the first release you can expect:

Pyroscope is a horizontally-scalable, highly-available, multi-tenant continuous profiling aggregation system with similar architecture to Grafana Mimir, Grafana Loki, and Grafana Tempo.
Easy to get started with guides covering Helm, Tanka, and docker-compose installations.
A fully integrated data source in Grafana to correlate your continuous profiling data with other observability signals using Grafana Explore and dashboards. The native flame graph panel visualization can also be used by other profiling data sources.

For more details check out the Full Changelog and the commit list.