Skip to content

Releases

Release v2.2.2 / 2026-11-13

Choose a tag to compare

@github-actions github-actions released this 13 Nov 03:18
00dfda2

Welcome to Trickster 2.2.2! 🎉

In this release, we:

  • Updated to Go 1.27.4 and updated dependent packages
  • Published all new collection of 13 Grafana Dashboards for various Trickster features + an Overview dashboard.
  • Ported parts of the external cockroachdb-parser module used by Trickster to pkg/parsing/pgparser, since the remote repo was recently archived.
Run via docker
# via ghcr.io
docker run --name trickster -d -v /path/to/trickster.yaml:/etc/trickster/trickster.yaml -p 0.0.0.0:8480:8480 ghcr.io/trickstercache/trickster:2.2.2

# via docker.io
docker run --name trickster -d -v /path/to/trickster.yaml:/etc/trickster/trickster.yaml -p 0.0.0.0:8480:8480 docker.io/trickstercache/trickster:2.2.2
Run via kubernetes/helm
helm install trickster oci://ghcr.io/trickstercache/charts/trickster --version '^2' --set image.tag="2.2.2"

Note:

  • The trickster chart version is managed separately from the Trickster version.
  • The latest major version is 2.x, and supports a minimum Trickster version of 2.0.0 (beta3 or later).

For more information, see:

What's Changed

Full Changelog: v2.2.1...v2.2.2

Release v2.2.1 / 2026-11-03

Choose a tag to compare

@github-actions github-actions released this 03 Nov 22:08
b07105b

Welcome to Trickster 2.2.1! 🎉

Highlights for this Release:

  • Fixed a defect in Time Series Merge where the Prometheus /api/v1/query_examplars endpoint returns a 502 status code.
  • Added support for draft-23 of the Media over QUIC (MoQ) specification in the Caching Relay. Support remains for draft-17 through -22.
  • Swapped out go-redis client for valkey-go
Run via docker
# via ghcr.io
docker run --name trickster -d -v /path/to/trickster.yaml:/etc/trickster/trickster.yaml -p 0.0.0.0:8480:8480 ghcr.io/trickstercache/trickster:2.2.1

# via docker.io
docker run --name trickster -d -v /path/to/trickster.yaml:/etc/trickster/trickster.yaml -p 0.0.0.0:8480:8480 docker.io/trickstercache/trickster:2.2.1
Run via kubernetes/helm
helm install trickster oci://ghcr.io/trickstercache/charts/trickster --version '^2' --set image.tag="2.2.1"

Note:

  • The trickster chart version is managed separately from the Trickster version.
  • The latest major version is 2.x, and supports a minimum Trickster version of 2.0.0 (beta3 or later).

For more information, see:

What's Changed

Full Changelog: v2.2.0...v2.2.1

Release v2.2.0 / 2026-10-26

Choose a tag to compare

@github-actions github-actions released this 26 Oct 17:57
7788e6d

Welcome to Trickster 2.2.0! 🎉

So. Many. Bleeping. Features! 🤯 Here are the biggest adds:

  • Significant memory usage and performance improvements app-wide
  • Acceleration for 4 more TSDB providers:
    • TimescaleDB (PostgreSQL)
    • GreptimeDB
    • QuestDB
    • VictoriaMetrics
  • IPv4 and v6 Access Control Lists
  • GeoACLs based on user IP to Location translation (bring your own database)
  • Configurable Rate Limiting based on configurable request attributes
  • Automatic Certificate Renewal via ACME
  • The ALB is expanded with an all-new Layer 4 Load Balancer for both TCP and UDP, plus Sticky Sessions
  • Support for Media over QUIC (MoQ) Transport Relaying & Edge Caching, drafts 17 through 22
  • A global Prometheus query evaluator mode for Time Series Merge that can cache and merge results from Mimir, Thanos, Prom and other prom-compatible upstreams via their remote_read and StoreAPI endpoints

You can find the full list of features and fixes in the Trickster 2.2 New+Changed Doc. Also check out the Roadmap to see what's planned for v2.3.

Run via docker
# via ghcr.io
docker run --name trickster -d -v /path/to/trickster.yaml:/etc/trickster/trickster.yaml -p 0.0.0.0:8480:8480 ghcr.io/trickstercache/trickster:2.2.0

# via docker.io
docker run --name trickster -d -v /path/to/trickster.yaml:/etc/trickster/trickster.yaml -p 0.0.0.0:8480:8480 docker.io/trickstercache/trickster:2.2.0
Run via kubernetes/helm
helm install trickster oci://ghcr.io/trickstercache/charts/trickster --version '^2' --set image.tag="2.2.0"

Note:

  • The trickster chart version is managed separately from the Trickster version.
  • The latest major version is 2.x, and supports a minimum Trickster version of 2.0.0 (beta3 or later).

For more information, see:

What's Changed

New Contributors

Full Changelog: v2.1.0...v2.2.0

Release v2.1.0 / 2026-09-21

Choose a tag to compare

@github-actions github-actions released this 21 Sep 17:05
61809fb

Welcome to Trickster 2.1.0! 🎉

While 2.1.0 is a minor release bump, it is chock-full of major enhancements and new features:

  • Acceleration support for InfluxDB 3.x, Graphite, Druid and MySQL (when used w/ Grafana)
  • ClickHouse frontend and backend now support Native (binary) Protocol in addition to HTTP
  • Support for operating as a Kubernetes Ingress and/or Gateway Controller
  • ALB Pool Auto-discovery
  • Auto-reload configs and TLS certs; coalesce config from multiple files in a conf.d subdirectory
  • Customizable Apache-style (NCSA) Access/Error Logging
  • Support HTTP/3 + QUIC, Connection Upgrading, h2c, and other advanced HTTP features

... and much more! See What's New in Trickster 2.1 for the full rundown.

P.S., checkout our new companion tool, Mecone: an HTTP Spec Conformance Tester.

Run via docker
# via ghcr.io
docker run --name trickster -d -v /path/to/trickster.yaml:/etc/trickster/trickster.yaml -p 0.0.0.0:8480:8480 ghcr.io/trickstercache/trickster:2.1.0

# via docker.io
docker run --name trickster -d -v /path/to/trickster.yaml:/etc/trickster/trickster.yaml -p 0.0.0.0:8480:8480 docker.io/trickstercache/trickster:2.1.0
Run via kubernetes/helm
helm install trickster oci://ghcr.io/trickstercache/charts/trickster --version '^2' --set image.tag="2.1.0"

Note:

  • The trickster chart version is managed separately from the Trickster version.
  • The latest major version is 2.x, and supports a minimum Trickster version of 2.0.0 (beta3 or later).

For more information, see:

What's Changed

New Contributors

Returning Contributors

Full Changelog: v2.0.5...v2.1.0

Release v2.0.5 / 2026-07-31

Choose a tag to compare

@github-actions github-actions released this 31 Jul 18:00
5e0c691

    

Welcome to Trickster 2.0.5! 🎉

In this release, we:

  • added support for more aggregation operators in Time Series Merge: limitk, limit_ratio, stddev, stdvar and quantile and sort
  • support OTLP tracing protocol selection between http (default) and gRPC
  • added max_query_range config to time series backends
  • support TSM Replica Groups for indicating HA replicas vs disjoint merge members
  • added a new listeners section to the config to define all frontend listeners in one place. You can now configure multiple frontend listener ports and map each backend to a listener. Existing listener configs in mgmt and frontend will work with a deprecation warning.
  • incorporated various other performance improvements and bug fixes
  • improved handling of merge errors

Thanks to:

Run via docker
# via ghcr.io
docker run --name trickster -d -v /path/to/trickster.yaml:/etc/trickster/trickster.yaml -p 0.0.0.0:8480:8480 ghcr.io/trickstercache/trickster:2.0.5

# via docker.io
docker run --name trickster -d -v /path/to/trickster.yaml:/etc/trickster/trickster.yaml -p 0.0.0.0:8480:8480 docker.io/trickstercache/trickster:2.0.5
Run via kubernetes/helm
helm install trickster oci://ghcr.io/trickstercache/charts/trickster --version '^2' --set image.tag="2.0.5"

Note:

  • The trickster chart version is managed separately from the Trickster version.
  • The latest major version is 2.x, and supports a minimum Trickster version of 2.0.0 (beta3 or later).
  • Support customizable CORS configs per-backend and backend path.

For more information, see:

What's Changed

Full Changelog: v2.0.4...v2.0.5

Release v2.0.4 / 2026-07-03

Choose a tag to compare

@github-actions github-actions released this 03 Jul 03:10
91f5474

    

Welcome to Trickster 2.0.4! 🎉

In this release, we:

  • Fixed a defect in Time Series Merge ALBs where proxy-only data would cause the merge to fail and return a 502 response to the caller.
  • Improved OTLP tracing integration by passing through more span data from downstream callers and incorporating additional span tags data describing how Trickster handled the request
  • Improved error handling when multiple backends/shards are called and have a mix of successes and failures
  • Updated dependencies
Run via docker
# via ghcr.io
docker run --name trickster -d -v /path/to/trickster.yaml:/etc/trickster/trickster.yaml -p 0.0.0.0:8480:8480 ghcr.io/trickstercache/trickster:2.0.4

# via docker.io
docker run --name trickster -d -v /path/to/trickster.yaml:/etc/trickster/trickster.yaml -p 0.0.0.0:8480:8480 docker.io/trickstercache/trickster:2.0.4
Run via kubernetes/helm
helm install trickster oci://ghcr.io/trickstercache/charts/trickster --version '^2' --set image.tag="2.0.4"

Note:

  • The trickster chart version is managed separately from the Trickster version.
  • The latest major version is 2.x, and supports a minimum Trickster version of 2.0.0 (beta3 or later).

For more information, see:

What's Changed

Full Changelog: v2.0.3...v2.0.4

Release v2.0.3 / 2026-06-29

Choose a tag to compare

@github-actions github-actions released this 29 Jun 15:20
06e343e

    

Welcome to Trickster 2.0.3! 🎉

In this release, we:

  • improved ALB compatibility, including adding Time Series Merge support for topk and bottomk PromQL aggregators
  • fixed a defect in Tracing configurations that would prevent some configs from being effective
  • added additional test coverage
Run via docker
# via ghcr.io
docker run --name trickster -d -v /path/to/trickster.yaml:/etc/trickster/trickster.yaml -p 0.0.0.0:8480:8480 ghcr.io/trickstercache/trickster:2.0.3

# via docker.io
docker run --name trickster -d -v /path/to/trickster.yaml:/etc/trickster/trickster.yaml -p 0.0.0.0:8480:8480 docker.io/trickstercache/trickster:2.0.3
Run via kubernetes/helm
helm install trickster oci://ghcr.io/trickstercache/charts/trickster --version '^2' --set image.tag="2.0.3"

Note:

  • The trickster chart version is managed separately from the Trickster version.
  • The latest major version is 2.x, and supports a minimum Trickster version of 2.0.0 (beta3 or later).

For more information, see:

What's Changed

New Contributors

Full Changelog: v2.0.2...v2.0.3

Release v2.0.2 / 2026-06-24

Choose a tag to compare

@github-actions github-actions released this 24 Jun 04:07
7ef9bf4

    

Welcome to Trickster 2.0.2! 🎉

In this release, we:

  • Added numerous performance and stability enhancements and bugfixes (see changelog below)
  • Significantly increased test coverage
  • Restored per-data point LRU cache eviction capability
  • Improved Time Series Merge compatibility
  • Added a new sanitized config endpoint for posting to issues/support
Run via docker
# via ghcr.io
docker run --name trickster -d -v /path/to/trickster.yaml:/etc/trickster/trickster.yaml -p 0.0.0.0:8480:8480 ghcr.io/trickstercache/trickster:2.0.2

# via docker.io
docker run --name trickster -d -v /path/to/trickster.yaml:/etc/trickster/trickster.yaml -p 0.0.0.0:8480:8480 docker.io/trickstercache/trickster:2.0.2
Run via kubernetes/helm
helm install trickster oci://ghcr.io/trickstercache/charts/trickster --version '^2' --set image.tag="2.0.2"

Note:

  • The trickster chart version is managed separately from the Trickster version.
  • The latest major version is 2.x, and supports a minimum Trickster version of 2.0.0 (beta3 or later).

For more information, see:

What's Changed

  • chore(deps): bump github.com/redis/go-redis/v9 from 9.17.3 to 9.18.0 by @dependabot[bot] in #921
  • chore(deps): bump github.com/alicebob/miniredis/v2 from 2.35.0 to 2.36.1 by @dependabot[bot] in #922
  • fix: [lint] address new linter warnings by @crandles in #920
  • chore: run go fix ./... by @crandles in #923
  • chore: enable new linters & fix flaky test by @crandles in #924
  • chore: extend developer dashboard; add k6 load test by @crandles in #926
  • chore(deps): bump github.com/alicebob/miniredis/v2 from 2.36.1 to 2.37.0 by @dependabot[bot] in #931
  • chore(deps): bump golang.org/x/net from 0.50.0 to 0.51.0 by @dependabot[bot] in #932
  • perf: [proxy/engines] add singleflight to delta and object proxy caches by @crandles in #930
  • fix: report singleflight de-duplicated calls as proxy-hit by @crandles in #933
  • feat: widen DPC singleflight to include fast-forward and marshal by @crandles in #934
  • chore: [proxy] remove named locker by @crandles in #935
  • fix: [tls] handle CA-only and client-cert-only TLS configurations in Validate by @EduardoCusihuaman in #940
  • fix: [proxy/engines] refactor and fix singleflight optimization by @crandles in #939
  • test: [proxy/engines] increase coverage by @crandles in #941
  • test: [backends/prometheus] increase coverage by @crandles in #943
  • test: [timeseries] increase coverage by @crandles in #942
  • fix: [proxy/engines] fix PCF deadlock edge case by @crandles in #944
  • perf: [alb] optimize fanout mechanisms + fix race and edge cases by @crandles in #945
  • ci: limit workflow cancellation to PRs, skip for main by @crandles in #946
  • refactor: drop context.Context from alb pool & proxy listener structs by @crandles in #947
  • fix: [proxy/engines] correct off-by-one byte ranges and handle ignored io.ReadAll errors by @crandles in #948
  • chore(deps): bump google.golang.org/grpc from 1.78.0 to 1.79.3 by @dependabot[bot] in #951
  • chore: improve error-level logging by @Elia-Renzoni in #952
  • fix+perf: concurrency limiting, size cropper, and hot-path optimizations by @crandles in #953
  • perf: hot-path optimizations for DPC, wire marshal, and dataset operations by @crandles in #954
  • fix+perf: reaper capacity bug, encoder pooling, and cache-path optimizations by @crandles in #955
  • feat: [alb/tsm] per-query merge strategy for ALB time-series merge by @crandles in #956
  • test: [proxy/engines] validate kmiss occurrs when backend does not provide headers by @crandles in #962
  • add AI guardrails and PR template by @jranson in #963
  • docs: update maintainer term dates by @jranson in #964
  • test: add simple integration test by @crandles in #857
  • fix: include match[] in label endpoint cache keys by @crandles in #965
  • refactor: [proxy/engines] proxyRequest field refactor + comments by @crandles in #966
  • fix: [backends/clickhouse] support multi line queries by @crandles in #967
  • test/fix: extend test wait to account for prometheus first scrape by @crandles in #968
  • test/fix: expand integration test; ensure proxy supports POST RawQuery by @crandles in #969
  • fix: [backends/prometheus] propagate captured headers in ALB transform path by @crandles in #970
  • chore(deps): bump go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp from 1.42.0 to 1.43.0 by @dependabot[bot] in #971
  • chore(deps): bump go.opentelemetry.io/otel/sdk from 1.42.0 to 1.43.0 by @dependabot[bot] in #972
  • fix: tsm vector unmarshaling error by @jranson in #938
  • test/fix: expand integration tests + misc defects by @crandles in #975
  • fix: surface upstream read errors in DPC + add high-fanout ALB+TSM integration suite by @crandles in #978
  • ci+fix: integration coverage, quality infrastructure, bug fixes across prometheus/clickhouse/merge layers by @crandles in #979
  • docs: update clickhouse docs for Go SDK support by @crandles in #980
  • fix: [proxy/engines] reset cacheStatus on DPC empty-body recovery; pin chunk test clock by @crandles in #986
  • refactor: replace compression libraries by @Elia-Renzoni in #987
  • feat: [prometheus] 3.x support by @crandles in #983
  • fix: fortify health check status emits and reduce chatty logging by @jranson in #994
  • fix: [alb/tsm] prom avg outer aggregation with POST by @jranson in #998
  • fix: [alb/healthcheck/proxy] route only to live targets + ALB hardening sweep by @crandles in #997
  • fix: [alb/healthcheck] nested alb pools report nc instead of available by @crandles in #1000
  • chore: [docker] bump prometheus to 3.11.3 by @crandles in #995
  • fix+refactor: [alb] hardening sweep + shared fanout primitive by @crandles in #1001
  • fix: [integration] nonce histogram fidelity query to avoid cache hit by @crandles in #1002
  • add sanitized config endpoint by @jranson in #1003
  • [feat] Update config sanitizer (tracing & cache endpoints) by @jranson in #1004
  • fix+refactor+test: [alb/cache/proxy] continued hardening sweep by @crandles in #1006
  • fix+test: [alb] surface healthy_floor misconfigurations and degraded dispatch by @crandles in #1012
  • test: expand unit test coverage by @jranson in #1026
  • test: extend unit test coverage by @jranson in #1027
  • fix: [engines] set Request.GetBody to support HTTP/2 GOAWAY retries by @thinker0 in #1020
  • feat+perf: [alb/fanout,proxy/capture] loser-drain histogram + capture body presize by @crandles i...
Read more

Release v2.0.1 / 2026-02-21

Choose a tag to compare

@github-actions github-actions released this 21 Feb 16:25
c0d723c

    

Welcome to Trickster 2.0.1! 🎉

In this release, we:

  • updated to Go 1.26, which provides better garbage collection and reduced memory usage
  • improved speed and performance of the Memory Cache
  • squashed several ALB bugs that could cause 502 Bad Gateway responses
Run via docker
# via ghcr.io
docker run --name trickster -d -v /path/to/trickster.yaml:/etc/trickster/trickster.yaml -p 0.0.0.0:8480:8480 ghcr.io/trickstercache/trickster:2.0.1

# via docker.io
docker run --name trickster -d -v /path/to/trickster.yaml:/etc/trickster/trickster.yaml -p 0.0.0.0:8480:8480 docker.io/trickstercache/trickster:2.0.1
Run via kubernetes/helm
helm install trickster oci://ghcr.io/trickstercache/charts/trickster --version '^2' --set image.tag="2.0.1"

Note:

  • The trickster chart version is managed separately from the Trickster version.
  • The latest major version is 2.x, and supports a minimum Trickster version of 2.0.0 (beta3 or later).

For more information, see:

What's Changed

  • chore: Bump Go version to 1.26 by @crandles in #913
  • ci: cancel in progress workflows (to same PR/branch) by @crandles in #914
  • fix: [alb] allow alb merging to occur by @crandles in #916
  • feat: [cache/memory] use ristretto as memory backend by @crandles in #917
  • feat: [alb] add concurrency limit options by @crandles in #918
  • retain pre-existing hc target status on config reload by @jranson in #919

Full Changelog: v2.0.0...v2.0.1

Release v2.0.0 / 2026-02-10

Choose a tag to compare

@github-actions github-actions released this 10 Feb 20:27
873566c

    

Welcome to Trickster 2.0! 🎉

We've published an all-inclusive list of everything that is new and changed from Trickster 1.x. Thanks to all 28 contributors who helped get this over the finish line. 🙏

Happy Accelerating!

Run via docker
# via ghcr.io
docker run --name trickster -d -v /path/to/trickster.yaml:/etc/trickster/trickster.yaml -p 0.0.0.0:8480:8480 ghcr.io/trickstercache/trickster:2.0.0

# via docker.io
docker run --name trickster -d -v /path/to/trickster.yaml:/etc/trickster/trickster.yaml -p 0.0.0.0:8480:8480 docker.io/trickstercache/trickster:2.0.0
Run via kubernetes/helm
helm install trickster oci://ghcr.io/trickstercache/charts/trickster --version '^2' --set image.tag="2.0.0"

Note:

  • The trickster chart version is managed separately from the Trickster version.
  • The latest major version is 2.x, and supports a minimum Trickster version of 2.0.0 (beta3 or later).

For more information, see: