jaegertracing / jaegertracing/documentation

[Bug]: V2 docs give scaling/deployment instructions for removed V1 binaries (jaeger-collector, jaeger-ingester)

Open
#1,113 0 comments 0 reactions 0 assignees View on GitHub
bug
Dominant language
TypeScript
Stars
84
Forks
192
Avg merge
12h 25m
Merged PRs (30d)
4

Description

### What happened?

These sections still reference the v1 architecture. Jaeger v2 replaced the standalone jaeger-collector, jaeger-query, jaeger-ingester, and jaeger-agent binaries with a single unified jaeger binary built on the OpenTelemetry Collector framework (as described in v2/_dev/_index.md). The scaling guidance (e.g. "Adding jaeger-collector instances..." and jaeger-ingester recommendations) was carried over from the v1 docs without being updated for the v2 architecture, so it can mislead users deploying or scaling Jaeger v2.

### Steps to reproduce

1.Open content/docs/v2/_dev/operations/performance-tuning.md and review the "Scale the Collector up and down" and "Consider using Kafka as intermediate buffer" sections.
2.Open content/docs/v2/_dev/faq.md and review "Do I need to run multiple collectors?".
3.Compare them with the current jaegertracing/jaeger main branch. The cmd/ directory now contains only the unified jaeger binary; the standalone jaeger-collector, jaeger-query, and jaeger-ingester binaries no longer exist.

### Expected behavior

The documentation should reflect the Jaeger v2 architecture. Instead of describing scaling around standalone jaeger-collector and jaeger-ingester binaries, it should describe scaling by running multiple instances of the unified jaeger binary and its internal collector/ingester pipelines.

I already have a fix prepared and will open a PR shortly (branch: fix/v2-docs-stale-collector-references on my fork).

### Relevant log output

```shell

```

### Screenshot

_No response_

### Additional context

_No response_

### Jaeger backend version

_No response_

### SDK

_No response_

### Pipeline

_No response_

### Stogage backend

_No response_

### Operating system

_No response_

### Deployment model

_No response_

### Deployment configs

```shell

```

Contributor guide

Open the contributing guide

Research direction

Read content/docs/v2/_dev/operations/performance-tuning.md and content/docs/v2/_dev/faq.md, then compare the referenced architecture with v2/_dev/_index.md and the current cmd/ directory. Update the scaling and deployment guidance to match the unified v2 binary, and verify that the affected sections no longer describe removed standalone binaries.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Clearly specified
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.