You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+28Lines changed: 28 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -94,6 +94,34 @@ Starting with the release of Go 1.21, support for Go versions will be updated as
94
94
95
95
Note: All importable code has been moved to internal packages, so there is no need to maintain backward compatibility with older compilers (previously version `N-1` was used).
96
96
97
+
## Storage Backend Version Support Policy
98
+
99
+
This policy covers storage backend versions only while they are reasonable for the project to test, maintain, and recommend for production use. Policy coverage is distinct from versions that may remain technically compatible with Jaeger.
100
+
101
+
For backends with a published upstream lifecycle, Jaeger bases its policy on the backend project's or vendor's supported-version or end-of-life policy, with the exact coverage defined below. Once upstream support ends, Jaeger may remove CI coverage, stop proactively fixing backend-specific issues for that version, and require users to upgrade before troubleshooting.
102
+
103
+
For backends without a clear upstream lifecycle, Jaeger supports the current stable major version and the immediately preceding major version. Older versions are best-effort only and may be removed when they block development, security fixes, dependency updates, or CI reliability.
104
+
105
+
Backend-specific policy:
106
+
107
+
* Elasticsearch: follow Elastic's [Product and Version End of Life Policy](https://www.elastic.co/support/eol).
108
+
* OpenSearch: follow the OpenSearch [Release Schedule and Maintenance Policy](https://opensearch.org/releases/). In practice, this means the current major version and the previous major version while they remain maintained.
109
+
* Cassandra: follow Apache Cassandra's maintained release lines, as published on the [Cassandra download page](https://cassandra.apache.org/_/download.html), with the Jaeger support target being the current major version and the previous major version.
110
+
* ClickHouse: follow ClickHouse's [release and backport policy](https://clickhouse.com/docs/development/backports) and production guidance for [stable and LTS releases](https://clickhouse.com/docs/faq/operations/production). Jaeger treats LTS releases as its support lines and covers the current and previous LTS releases, which ClickHouse supports simultaneously for at least 12 months. Monthly stable releases may remain compatible or appear in CI but are not covered by this policy.
111
+
112
+
Support means backend versions are in scope for proactive compatibility fixes. CI coverage is not the definitive support matrix: it may test only a subset of supported versions and may retain older versions on a best-effort basis. CI coverage alone does not make a backend version supported. Jaeger does not provide support for the backend product itself, vendor-specific distributions, or versions outside the upstream maintenance window.
113
+
114
+
As of July 6, 2026, this policy means:
115
+
116
+
| Backend | Jaeger policy basis | Versions covered by policy | Versions not covered |
117
+
| --- | --- | --- | --- |
118
+
| Elasticsearch | Elastic EOL policy |`9.x`; `8.19.x` until Elastic's published 8.x maintenance window ends |`8.18.x` and earlier |
119
+
| OpenSearch | OpenSearch maintenance policy |`3.x`; `2.x`, with `2.19.x` as the currently maintained 2.x line |`1.x` and earlier |
120
+
| Cassandra | Current major plus previous major, using maintained Apache release lines |`5.0.x`; maintained `4.x` lines, currently `4.1.x` and `4.0.x`|`3.x` and earlier |
121
+
| ClickHouse | Current and previous ClickHouse LTS releases |`26.3 LTS` and `25.8 LTS`| Monthly stable releases and older LTS branches |
122
+
123
+
This table is informational and should be refreshed when upstream policies or release lines change. Versions listed as not covered may still appear in CI on a best-effort basis; their presence in CI does not extend the support policy.
0 commit comments