docs(collector): update internal telemetry RPC metrics

[dol]

• I have read and followed the Contributing docs, especially the "First-time contributing?" section.
• This PR has content that I did not fully write myself.
  • I used AI and I have read and followed the Generative AI Contribution Policy.
• I have the experience and knowledge necessary to understand, review, and validate all content in this PR.¹

---

This PR updates the Collector internal telemetry docs to match the RPC metrics emitted by newer Collector builds.

It makes three concrete documentation corrections in content/en/docs/collector/internal-telemetry.md:

• rename the documented RPC duration metrics from rpc.client.duration / rpc.server.duration to rpc.client.call.duration / rpc.server.call.duration
• remove the deprecated rpc.*.requests_per_rpc and rpc.*.responses_per_rpc entries from the detailed metrics table
• add version-context explaining that older Collector releases may still expose the legacy rpc.client.duration and rpc.server.duration names

The reason for this change is a dependency chain across the semantic conventions, the generated Go semconv packages, the gRPC instrumentation used by the Collector, and finally the Collector docs.

The upstream source of truth is the semantic-conventions repo:

• In open-telemetry/semantic-conventions commit 9f213161a9bb24225da7a318365b24d497f8d466 (Deprecate rpc.*.requests_per_rpc and rpc.*.responses_per_rpc metrics semantic-conventions#2846), the RPC requests_per_rpc and responses_per_rpc metrics were deprecated and moved out of the active RPC metric model from model/rpc/metrics.yaml into model/rpc/deprecated/metrics-deprecated.yaml.
• In open-telemetry/semantic-conventions commit 494eb91991c877fcd82b6f17817c343f3dc600fd (Rename rpc.client|server.duration to rpc.client|server.call.duratio, change unit from ms to sec, clarify duration in case of streaming semantic-conventions#2961), rpc.client.duration and rpc.server.duration were renamed to rpc.client.call.duration and rpc.server.call.duration, and the duration unit changed from milliseconds to seconds.

Those semantic-convention changes then flowed into the generated Go semconv packages:

• In open-telemetry/opentelemetry-go commit 6af2f2ff6724b5d4a806d945a7224fa723718c39 (Generate semconv/v1.38.0 opentelemetry-go#7648, Generate semconv/v1.38.0), the generated Go RPC semconv package no longer includes rpc.server.responses_per_rpc and the corresponding *_per_rpc helpers.
• In open-telemetry/opentelemetry-go commit f809f7d7134d97d13bbf60bc8ddcc54f13ac6c07 (Generate semconv/v1.39.0 opentelemetry-go#7783, Generate semconv/v1.39.0), the generated Go RPC semconv package switches from rpc.server.duration to rpc.server.call.duration and from rpc.client.duration to rpc.client.call.duration.

That matters for the Collector because its gRPC internal telemetry is not hand-authored under Collector-specific metric names. Collector core wires the gRPC server and client through otelgrpc in config/configgrpc/configgrpc.go, and otelgrpc constructs its instruments from the generated rpcconv helpers. In current Go module versions that means:

• otelgrpc.NewServerHandler(...) uses rpcconv.NewServerCallDuration(...)
• otelgrpc.NewClientHandler(...) uses rpcconv.NewClientCallDuration(...)

So once Collector core upgraded its OpenTelemetry Go dependencies, the emitted internal RPC duration metrics changed as a consequence of that dependency update, even though the Collector’s own gRPC instrumentation wiring stayed conceptually the same.

This is the important part of the reasoning for the documentation change:

1. The docs page lists internal metrics for detailed verbosity.
2. The RPC metrics on that page come from instrumentation libraries, not from first-party Collector component metric definitions.
3. The semantic-conventions project deprecated the *_per_rpc metrics and renamed the duration metrics.
4. opentelemetry-go regenerated its semconv packages from those newer semantic conventions.
5. otelgrpc uses those regenerated semconv helpers to define the actual instrument names.
6. Collector core uses otelgrpc for internal gRPC client/server instrumentation.
7. Therefore newer Collector releases emit the new *.call.duration names and no longer expose the deprecated *_per_rpc metrics through the current Go-based internal RPC instrumentation path.

That is why the previous documentation became stale:

• it still listed rpc.client.duration and rpc.server.duration as if they were the current names
• it still listed rpc.*.requests_per_rpc and rpc.*.responses_per_rpc as if they were still part of the current generated Go instrumentation surface

This PR updates the page to reflect the current state while still noting that older Collector releases may show the legacy duration names. I kept that compatibility note because users may be comparing different Collector versions and the page should make the version boundary understandable instead of presenting the current names as timeless.

Validation:

• formatted the updated doc with Prettier
• attempted the repository quality gate via npm run check
• the full check does not currently pass because of pre-existing check:i18n drift in many unrelated translated files, not because of this doc change

Relevant upstream references:

• Deprecate rpc.*.requests_per_rpc and rpc.*.responses_per_rpc metrics semantic-conventions#2846
• Rename rpc.client|server.duration to rpc.client|server.call.duratio, change unit from ms to sec, clarify duration in case of streaming semantic-conventions#2961
• Generate semconv/v1.38.0 opentelemetry-go#7648
• Generate semconv/v1.39.0 opentelemetry-go#7783

Repo commit for this docs change:

• 37feaa1 docs(collector): update internal telemetry RPC metrics

Footnotes

1. Yes, I can answer maintainer questions about the content of this PR, without using AI. ↩

[jade-guiton-dd]

Looks mostly good to me, just a few notes.

(I guess the review request from collector-approvers was removed, but the bot is still tagging missing:sig-approval? Not sure how that works 🤔)

[tiffany76]

Thanks very much, @dol! I made a couple suggestions to integrate the information into the page.

[linux-foundation-easycla]

The committers listed above are authorized under a signed CLA.

• ✅ login: dol / name: Dominic Lüchinger (493da1a, 0c56862, b4173a3)
• ✅ login: odubajDT / name: odubajDT (a794085)
• ✅ login: tiffany76 / name: Tiffany Hrabusa (2157a35, 493da1a, a794085)