Release 2.20.0 - #1124
Merged
Merged
Conversation
Signed-off-by: jaegertracingbot <jaegertracingbot+jaeger-tracing@googlegroups.com>
yurishkuro
approved these changes
Jul 20, 2026
There was a problem hiding this comment.
Pull request overview
Updates the Jaeger documentation site for the v2.20.0 release by promoting 2.20 as the latest v2 docs set and adding the new versioned documentation content under content/docs/v2/2.20/.
Changes:
- Bump site “latest v2” pointers to 2.20 / 2.20.0 in
hugo.yamland add2.20to the v2 versions list. - Add the full v2.20 documentation tree (architecture, deployment, operations, storage, etc.).
- Demote v2.19 from “latest” labeling/robots handling in its
_index.md.
Reviewed changes
Copilot reviewed 33 out of 33 changed files in this pull request and generated 17 comments.
Show a summary per file
| File | Description |
|---|---|
| hugo.yaml | Updates site params to mark v2.20 as latest and add it to the versions list. |
| content/docs/v2/2.20/_index.md | Introduces the v2.20 docs landing page and sidebar structure. |
| content/docs/v2/2.19/_index.md | Removes “(latest)” labeling for 2.19 and adjusts robots cascade. |
| content/docs/v2/2.20/getting-started.md | Adds v2.20 getting started instructions and demo guidance. |
| content/docs/v2/2.20/features.md | Adds the v2.20 features overview page. |
| content/docs/v2/2.20/faq.md | Adds v2.20 FAQ content. |
| content/docs/v2/2.20/external-guides/_index.md | Adds index for externally hosted guides for v2.20. |
| content/docs/v2/2.20/external-guides/migration.md | Adds a pointer page for v1→v2 migration guidance. |
| content/docs/v2/2.20/architecture/_index.md | Adds the architecture section index for v2.20. |
| content/docs/v2/2.20/architecture/apis.md | Documents Jaeger v2 APIs and default ports. |
| content/docs/v2/2.20/architecture/sampling.md | Adds sampling concepts and configuration references. |
| content/docs/v2/2.20/architecture/spm.md | Adds Service Performance Monitoring documentation. |
| content/docs/v2/2.20/architecture/terminology.md | Adds terminology mapping between Jaeger and OpenTelemetry. |
| content/docs/v2/2.20/deployment/_index.md | Adds the deployment section index and operational guidance. |
| content/docs/v2/2.20/deployment/configuration.md | Adds configuration documentation and examples for v2.20. |
| content/docs/v2/2.20/deployment/custom-distribution.md | Documents building custom Jaeger distributions via OCB. |
| content/docs/v2/2.20/deployment/frontend-ui.md | Adds UI/frontend configuration documentation. |
| content/docs/v2/2.20/deployment/kubernetes.md | Adds Kubernetes deployment pointers (operator/chart). |
| content/docs/v2/2.20/deployment/security.md | Adds security mechanisms and TLS/auth matrix documentation. |
| content/docs/v2/2.20/deployment/windows.md | Adds Windows service deployment instructions. |
| content/docs/v2/2.20/operations/_index.md | Adds operations section index for v2.20. |
| content/docs/v2/2.20/operations/monitoring.md | Adds monitoring guidance and recommended metrics. |
| content/docs/v2/2.20/operations/performance-tuning.md | Adds performance tuning guidance for collectors/storage. |
| content/docs/v2/2.20/operations/tools.md | Documents auxiliary tools (tracegen, anonymizer, remote storage). |
| content/docs/v2/2.20/operations/troubleshooting.md | Adds troubleshooting checklist for common issues. |
| content/docs/v2/2.20/storage/_index.md | Adds storage section index and navigation for v2.20. |
| content/docs/v2/2.20/storage/badger.md | Adds Badger backend documentation. |
| content/docs/v2/2.20/storage/cassandra.md | Adds Cassandra backend documentation. |
| content/docs/v2/2.20/storage/clickhouse.md | Adds ClickHouse backend documentation (experimental). |
| content/docs/v2/2.20/storage/elasticsearch.md | Adds Elasticsearch backend documentation and index management details. |
| content/docs/v2/2.20/storage/kafka.md | Adds Kafka buffering/ingester pipeline documentation. |
| content/docs/v2/2.20/storage/memory.md | Adds in-memory backend documentation and configuration snippet. |
| content/docs/v2/2.20/storage/opensearch.md | Adds OpenSearch backend documentation. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
|
|
||
| ## Service Mesh: missing spans | ||
|
|
||
| When deploying your application as part of a service mesh like Istio, the number of moving parts increases significantly and might affect how (and which) spans are reported. If you expect to see spans generated by a service mesh but they are noe visible in the Jaeger UI, check the troubleshooting guides for the service mesh you are using. For example, on [Istio's website](https://istio.io/faq/distributed-tracing/#no-tracing). |
|
|
||
| ## Tracegen | ||
|
|
||
| It is a powerful utility that can be used to generate continuous stream of simple spans. This is specially useful for stress testing. It supports flags to control the number of workers and number of traces to generate in each worker. Not only that, it can generate spans in firehose mode (a flag set on spans to skip indexing). |
|
|
||
| ## Anonymizer | ||
|
|
||
| It is a small utility that expects a trace-id and outputs an anonymized json version of that trace. This is useful in case you want to share your span with someone for purposes like debugging. By anonymized version, we mean that it removes or hashes details which are particular to your environment and you're not comfortable sharing them. |
Comment on lines
+29
to
+51
| telemetry: | ||
| gomod: github.com/jaegertracing/jaeger v2.19.0 | ||
| import: github.com/jaegertracing/jaeger/components/telemetry | ||
|
|
||
| extensions: | ||
| - gomod: github.com/jaegertracing/jaeger v2.19.0 | ||
| import: github.com/jaegertracing/jaeger/components/extension/jaegerstorage | ||
| - gomod: github.com/jaegertracing/jaeger v2.19.0 | ||
| import: github.com/jaegertracing/jaeger/components/extension/jaegerquery | ||
| - gomod: github.com/jaegertracing/jaeger v2.19.0 | ||
| import: github.com/jaegertracing/jaeger/components/ext/extension/healthcheckv2extension | ||
|
|
||
| receivers: | ||
| - gomod: github.com/jaegertracing/jaeger v2.19.0 | ||
| import: github.com/jaegertracing/jaeger/components/ext/receiver/otlpreceiver | ||
|
|
||
| exporters: | ||
| - gomod: github.com/jaegertracing/jaeger v2.19.0 | ||
| import: github.com/jaegertracing/jaeger/components/exporter/storageexporter | ||
|
|
||
| processors: | ||
| - gomod: github.com/jaegertracing/jaeger v2.19.0 | ||
| import: github.com/jaegertracing/jaeger/components/ext/processor/batchprocessor |
|
|
||
| ## Version Compatibility | ||
|
|
||
| Replace the version placeholder (`v2.19.0` in the examples above) with the Jaeger release version you want to base your distribution on. All Jaeger component packages within a given release are versioned together, so you only need to track a single version number. |
| * **collector**: [config-kafka-collector.yaml](https://github.com/jaegertracing/jaeger/blob/v2.20.0/cmd/jaeger/config-kafka-collector.yaml) | ||
| * **ingester**: [config-kafka-ingester.yaml](https://github.com/jaegertracing/jaeger/blob/v2.20.0/cmd/jaeger/config-kafka-ingester.yaml) | ||
|
|
||
| Jaeger uses Kafka exporter and receiver from `opentelemetry-collector-contrib` repository. Please refer to their respective README's for configuration details. |
| ## Topic & partitions | ||
| Unless your Kafka cluster is configured to automatically create topics, you will need to create it ahead of time. You can refer to [the Kafka quickstart documentation](https://kafka.apache.org/documentation/#quickstart_createtopic) to learn how. | ||
|
|
||
| You can find more information about topics and partitions in general in the [official documentation](https://kafka.apache.org/documentation/#intro_topics). [This article](https://www.confluent.io/blog/how-to-choose-the-number-of-topicspartitions-in-a-kafka-cluster/) provide more details about how to choose the number of partitions. |
|
|
||
| ## Migration Guide from v1 to v2 | ||
|
|
||
| Please refer to the this [Google Doc](https://docs.google.com/document/d/1z4QrNtB9dMgT5SHNx-7Vc38XPLqnjmM2jFIupvkAEHo/view). |
|
|
||
| ## Management Ports | ||
|
|
||
| The following intra-oriented ports are exposed by default (can be changed via configuration): |
|
|
||
| * Supported OpenSearch versions: 1.x, 2.x, 3.x | ||
|
|
||
| OpenSearch maintains API compatibility between versions and remains compatible primarily with Elasticsearch v7.10.2 this version compatibility is automatically retrieved from root/ping endpoint. Based on this version Jaeger uses compatible index mappings and OpenSearch REST API. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Release 2.20.0. This PR is created from CI and is part of the release process jaegertracing/jaeger#9040.