Skip to content

Commit

Permalink
Minor fixes and v2 migration doc
Browse files Browse the repository at this point in the history
Signed-off-by: Yuri Shkuro <[email protected]>
  • Loading branch information
yurishkuro committed Nov 2, 2024
1 parent 7e8ef6c commit bb60377
Show file tree
Hide file tree
Showing 3 changed files with 12 additions and 13 deletions.
8 changes: 5 additions & 3 deletions content/docs/next-release-v2/features.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,14 +20,14 @@ Since v1.35, the Jaeger backend can receive trace data from the OpenTelemetry SD
## Multiple storage backends

Jaeger can be used with a growing number of storage backends:
* It natively supports popular open source NoSQL databases as trace storage backends: Cassandra 3.4+, Elasticsearch 7.x/8.x, and OpenSearch 1.0+.
* It natively supports popular open source NoSQL databases as trace storage backends: Cassandra 4.0+, Elasticsearch 7.x/8.x, and OpenSearch 1.0+.
* It integrates via a gRPC API with other well known databases that have been certified to be Jaeger compliant: [ClickHouse](https://github.com/jaegertracing/jaeger-clickhouse).
* There is embedded database support using [Badger](https://github.com/dgraph-io/badger) and simple in-memory storage for testing setups.
* There are ongoing community experiments using other databases; you can find more in [this issue](https://github.com/jaegertracing/jaeger/issues/638).

## Modern Web UI

Jaeger Web UI is implemented in Javascript using popular open source frameworks like React. Several performance improvements have been released in v1.0 to allow the UI to efficiently deal with large volumes of data and display traces with tens of thousands of spans (e.g. we tried a trace with 80,000 spans).
Jaeger Web UI is implemented in Javascript as a React application. Several performance improvements have been released in v1.0 to allow the UI to efficiently deal with large volumes of data and display traces with tens of thousands of spans (e.g. we tried a trace with 80,000 spans).

## Cloud Native Deployment

Expand Down Expand Up @@ -73,7 +73,9 @@ The support of Head based sampling comes from OpenTelemetry. The topic is covere

## Tail Based Sampling

Tail based sampling has advantages over head based sampling, but comes with additional impacts on load balancing spans along with a larger footprint of memory and CPU on the collectors. This will impact Jaeger as well. You can learn more about [tail based sampling in the OpenTelemetry documentation](https://opentelemetry.io/docs/concepts/sampling/#tail-sampling).
Tail based sampling has advantages over head based sampling, but comes with additional impacts on load balancing spans along with a larger footprint of memory and CPU on the collectors. This will impact Jaeger as well. You can learn more about [tail based sampling in the OpenTelemetry documentation](https://opentelemetry.io/docs/concepts/sampling/#tail-sampling).

Jaeger v2 directly supports [tail sampling processor](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/processor/tailsamplingprocessor).

### Remote Sampling

Expand Down
15 changes: 6 additions & 9 deletions content/docs/next-release-v2/getting-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ If you are new to distributed tracing, please check the [Introduction](../) page

Your applications must be instrumented before they can send tracing data to Jaeger. We recommend using the [OpenTelemetry][otel] instrumentation and SDKs.

The Jaeger SDKs are no longer supported, and all users must migrate to OpenTelemetry.
The Jaeger SDKs are no longer supported by the Jaeger project, the legacy Jaeger format is still supported for receiving traces.

## Default configuration

Expand All @@ -28,18 +28,15 @@ The binary exposes the following ports:

Port | Protocol | Component | Function
----- | ------- | --------- | ---
6831 | UDP | agent | accept `jaeger.thrift` over Thrift-compact protocol (used by most SDKs)
6832 | UDP | agent | accept `jaeger.thrift` over Thrift-binary protocol (used by Node.js SDK)
5775 | UDP | agent | (deprecated) accept `zipkin.thrift` over compact Thrift protocol (used by legacy clients only)
5778 | HTTP | agent | serve configs (sampling, etc.)
| | |
16686 | HTTP | query | serve frontend
| | |
(used by legacy clients only)
5778 | HTTP | collector | serve configs (sampling, etc.)
4317 | HTTP | collector | accept OpenTelemetry Protocol (OTLP) over gRPC
4318 | HTTP | collector | accept OpenTelemetry Protocol (OTLP) over HTTP
14268 | HTTP | collector | accept `jaeger.thrift` directly from clients
14250 | HTTP | collector | accept `model.proto`
14250 | gRPC | collector | accept `model.proto`
9411 | HTTP | collector | Zipkin compatible endpoint (optional)
| | |
16686 | HTTP | query | serve frontend

### With Service Performance Monitoring (SPM)

Expand Down
2 changes: 1 addition & 1 deletion content/docs/next-release-v2/migration.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,4 +5,4 @@ hasparent: true

## Migration Guide from v1 to v2

Placeholder
Please refer to the this [Google Doc](https://docs.google.com/document/d/1z4QrNtB9dMgT5SHNx-7Vc38XPLqnjmM2jFIupvkAEHo/view).

0 comments on commit bb60377

Please sign in to comment.