Repository navigation
Releases
Release v2.2.2 / 2026-11-13
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.2Run 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:
- Trying Out Trickster
- trickster's helm chart.
What's Changed
- add dashboard library by @jranson in #1225
- chore: update deps by @jranson in #1226
- chore: minor performance + linting fixes; bump go version by @jranson in #1227
- chore: port in cockroachdb postgresql parser by @jranson in #1228
Full Changelog: v2.2.1...v2.2.2
Release v2.2.1 / 2026-11-03
Welcome to Trickster 2.2.1! 🎉
Highlights for this Release:
- Fixed a defect in Time Series Merge where the Prometheus
/api/v1/query_examplarsendpoint 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-redisclient forvalkey-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.1Run 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:
- Trying Out Trickster
- trickster's helm chart.
What's Changed
- docs: minor updates by @jranson in #1218
- fix: disable tsm for query_exemplars route by @jranson in #1220
- feat: support env strings config-wide by @jranson in #1221
- feat: add official Valkey support by @jranson in #1222
- chore: update dependencies by @jranson in #1223
- feat: support MoQ IETF Draft 23 by @jranson in #1224
Full Changelog: v2.2.0...v2.2.1
Release v2.2.0 / 2026-10-26
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.0Run 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:
- Trying Out Trickster
- trickster's helm chart.
What's Changed
- feat: support accelerating TimescaleDB / Postgres by @jranson in #1153
- feat: add static file server backend type by @jranson in #1155
- feat: support layer 4 load balancing by @jranson in #1154
- fix: data race in watcher by @jranson in #1160
- fix: remove unneeded file by @jranson in #1159
- chore: speed up release workflow by @jranson in #1156
- Chore: integrate mockster libs by @jranson in #1162
- feat: add ALB sticky table support by @jranson in #1163
- Add GreptimeDB provider for SQL and PromQL by @houyuwushang in #1161
- Chore: Step Alignment Refactor by @jranson in #1165
- perf: remove unneeded request.Resources.Clone() calls by @jranson in #1166
- perf: optimize filesystem cache by @jranson in #1167
- perf: reduce heap allocations by @jranson in #1168
- perf: streaming decoding for all backend providers by @jranson in #1170
- Add QuestDB pgwire provider by @houyuwushang in #1169
- questdb security and conformance fixes by @jranson in #1175
- feat: support docker compose profiles for the dev env by @jranson in #1177
- remove greptime seed artifiact by @jranson in #1178
- feat: accelerate aws cloudwatch metrics via promql by @jranson in #1182
- feat: accelerate VictoriaMetrics by @jranson in #1181
- feat: support ACME TLS cert management w/ auto-renewal by @jranson in #1179
- fix: various authenticator defects by @jranson in #1180
- add configurable dot formatting protection support by @jranson in #1183
- feat: support http QUERY method by @jranson in #1185
- fix: harden listener and proxy handling by @jranson in #1184
- Support IP access control lists by @shashankxrm in #1171
- feat: add Geo ACL feature (geo-restriction) by @jranson in #1186
- Merge v2.2 features to main by @jranson in #1157
- chore: update deps and docs by @jranson in #1187
- feat: support SRV resolution reverse proxying by @jranson in #1189
- feat: support rate limiting by @shashankxrm in #1190
- fix: tests flakiness and vendor update by @jranson in #1191
- feat: support global eval for mixed prom/mimir/thanos deployments by @jranson in #1192
- fix failing ci jobs by @jranson in #1194
- docs: document MySQL FOUND_ROWS limitation by @houyuwushang in #1195
- chore: app-wide unDRY by @jranson in #1196
- fix: data race by @jranson in #1197
- feat: Support Media over QUIC (MoQ) Transport Caching Relay by @jranson in #1214
- fix(alb,tsm): skip timeseries unmarshaling for non-2xx gather responses by @thinker0 in #1212
- fix(dpc): recover from timeseries cache unmarshaling failure by @thinker0 in #1213
- chore: increase test coverage by @jranson in #1215
- fix data race in test streamer by @jranson in #1216
- fix: data race in kqueue caused by fsnotify by @jranson in #1217
New Contributors
- @shashankxrm made their first contribution in #1171
Full Changelog: v2.1.0...v2.2.0
Release v2.1.0 / 2026-09-21
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.dsubdirectory - 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.0Run 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:
- Trying Out Trickster
- trickster's helm chart.
What's Changed
- tests: add clickhouse query parse benchmarks by @jranson in #1098
- refactor: replace internal clickhouse/sql parser with AfterShip's parser by @jranson in #1099
- fix: set Fast Forward evaluation time from range end by @houyuwushang in #1101
- chore: bump deps by @jranson in #1105
- test: guard synchronous DPC cache writes by @houyuwushang in #1106
- chore: bump dev env container versions + fix warnings by @jranson in #1108
- feat: expose rule regex captures to rewriters by @houyuwushang in #1104
- feat: add support for loading multiple config files and staleness check by @Elia-Renzoni in #908
- refactor: migrate UnmarshalYAML to v3 by @jranson in #1110
- feat: add automatic config reload polling by @houyuwushang in #1067
- feat: add MySQL Support by @jranson in #1109
- fix: honor MySQL no-backslash-escapes comments by @houyuwushang in #1111
- fix: flaky test TestFRPanicAllMembersDoesNotCrashRequest by @jranson in #1117
- feat: enhance logger by @jranson in #1113
- feat: add tls monitor by @jranson in #1118
- feat: implement regex path matching by @jranson in #1114
- feat: ALB pool member autodiscovery by @jranson in #1116
- feat: support graphite time series backend by @jranson in #1112
- feat: [clickhouse] native binary protocol + parser + grafana v4 plugin by @crandles in #981
- refactor(alb): avoid options in ALB constructors by @Elia-Renzoni in #1051
- feat: [influxdb] v3 support — http + flight sql + flux fixes by @crandles in #985
- use consts / linter by @jranson in #1119
- update deps by @jranson in #1120
- bugfix: restore clickhouse dpc by @jranson in #1125
- refactor: replace external dns client by @jranson in #1121
- refactor: reverse proxy by @jranson in #1122
- feat: add additional alb autodiscovery provders by @jranson in #1123
- refactor: move empty extent trimming to ExtentList by @shiyudesu in #1128
- docs: link Helm installation guide by @Brilly-Bohyun in #1131
- feat: [cache] track cache op duration by @crandles in #949
- fix: intermittently failing tests by @jranson in #1133
- update gitignore by @jranson in #1135
- add mecone endpoints to devenv by @jranson in #1136
- fix: improve HTTP RFC conformance for Object Proxy Cache by @jranson in #1137
- feat: add kubernetes ingress and gateway controllers by @jranson in #1132
- chore: revendor + go 1.27.1 by @jranson in #1138
- feat: add Apache Druid backend provider by @houyuwushang in #1124
- fix: TSM / Prom - parse extraneous paren wrappings in promql by @jranson in #1134
- feat: cache InfluxDB Prometheus remote reads by @houyuwushang in #1102
- refactor dev environment data seeder by @jranson in #1139
- fix: support proper handling of vector-to-scalar expressions by @jranson in #1141
- fix: allow kube to use any configured cache by @jranson in #1142
- final cleanup for v2.1-rc1 by @jranson in #1143
New Contributors
- @shiyudesu made their first contribution in #1128
- @Brilly-Bohyun made their first contribution in #1131
Returning Contributors
Full Changelog: v2.0.5...v2.1.0
Release v2.0.5 / 2026-07-31
Welcome to Trickster 2.0.5! 🎉
In this release, we:
- added support for more aggregation operators in Time Series Merge:
limitk,limit_ratio,stddev,stdvarandquantileandsort - 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
mgmtandfrontendwill 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.5Run 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:
- Trying Out Trickster
- trickster's helm chart.
What's Changed
- docs: update OTLP tracing examples by @houyuwushang in #1049
- feat: support OTLP tracing protocol selection by @houyuwushang in #1050
- refactor: remove unused tsm rr fallback by @houyuwushang in #1054
- docs: document X-Trickster-Result header by @houyuwushang in #1055
- fix: close demand probe response bodies by @houyuwushang in #1057
- fix: return 500 on internal failures by @jranson in #1053
- fix: ensure host header promotion works consistently by @jranson in #1058
- fix: batch high-cardinality tsm rank merges by @houyuwushang in #1060
- test: modernize benchmarks with b.Loop by @houyuwushang in #1065
- fix: merge aggregations through prometheus sort wrappers by @houyuwushang in #1064
- feat: configure backend CORS policies by @houyuwushang in #1066
- fix: enable TSM context cancellation by @jranson in #1062
- test: remove healthcheck wall-clock waits by @houyuwushang in #1074
- refactor: introduce TSM merge plans by @houyuwushang in #1075
- cleanup string literals + reorganize by @jranson in #1076
- test: update Prometheus SDK integration calls by @houyuwushang in #1085
- feat: support limit_ratio in ALB TSM by @houyuwushang in #1077
- sec+feat: harden config endpoint and add listeners map by @jranson in #1086
- support prom scalars in ALB Time Series Merge by @jranson in #1082
- fix(routing): swap middleware wrapping order of WithResourcesContext and LimitQueryRange by @thinker0 in #1078
- feat(alb,proxy): enforce max_query_range limit on ALB TSM scatter/gather entry point by @thinker0 in #1079
- chore: standardize on timeconv.Duration across options (issue #1089) by @thinker0 in #1090
- fix: preserve duration parsing compatibility by @houyuwushang in #1092
- feat: support TSM HA, Federation and Hybrid via Replica Groups by @jranson in #1088
- chore: integration cleanup for linter/coverage by @jranson in #1093
- tests: increase test coverage in least-covered packages by @jranson in #1094
- tests: add more unit tests by @jranson in #1095
- feat: support pooled stddev and stdvar in ALB TSM by @houyuwushang in #1080
- bugfix: retain errorType after replica group merge by @jranson in #1096
- feat: support exact quantile in ALB TSM by @houyuwushang in #1083
- tests: increase daemon test coverage by @jranson in #1097
- feat: support global PromQL limitk in ALB TSM by @houyuwushang in #1084
Full Changelog: v2.0.4...v2.0.5
Release v2.0.4 / 2026-07-03
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.4Run 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:
- Trying Out Trickster
- trickster's helm chart.
What's Changed
- fix: include OTLP service resource by @houyuwushang in #1038
- feat: add tracing attributes to proxy spans by @houyuwushang in #1039
- fix: propagate trace context to origins by @houyuwushang in #1042
- fix: merge proxy-only TSM responses by @houyuwushang in #1041
- fix: honor parent trace sampling by @houyuwushang in #1048
- refactor: keep user-router runtime state out of options by @houyuwushang in #1036
- fix(deltaproxycache): better handling of failed requests by @Elia-Renzoni in #989
Full Changelog: v2.0.3...v2.0.4
Release v2.0.3 / 2026-06-29
Welcome to Trickster 2.0.3! 🎉
In this release, we:
- improved ALB compatibility, including adding Time Series Merge support for
topkandbottomkPromQL 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.3Run 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:
- Trying Out Trickster
- trickster's helm chart.
What's Changed
- test: use synctest for healthcheck timing by @houyuwushang in #1031
- fix: finalize topk and bottomk tsm results by @houyuwushang in #1035
- test: cover sharded query-range integration by @houyuwushang in #1033
- fix: [alb] expose localresponse via Handlers() so paths: overrides apply by @thinker0 in #1029
- fix: apply configured OTLP endpoint by @houyuwushang in #1037
New Contributors
- @houyuwushang made their first contribution in #1031
Full Changelog: v2.0.2...v2.0.3
Release v2.0.2 / 2026-06-24
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.2Run 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:
- Trying Out Trickster
- trickster's helm chart.
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
ncinstead 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...
Release v2.0.1 / 2026-02-21
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 Gatewayresponses
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.1Run 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:
- Trying Out Trickster
- trickster's helm chart.
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
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.0Run 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:
- Trying Out Trickster
- trickster's helm chart.