Skip to content

Commit 37feaa1

Browse files
committed
docs(collector): update internal telemetry RPC metrics
Align the internal telemetry docs with the RPC metrics emitted by newer Collector builds that use the updated Go semantic conventions. Rename the documented RPC duration metrics to rpc.client.call.duration and rpc.server.call.duration, remove the deprecated *_per_rpc entries from the detailed metrics list, and note that older Collector releases may still expose the legacy rpc.client.duration and rpc.server.duration metric names.
1 parent aaffe18 commit 37feaa1

File tree

1 file changed

+22
-20
lines changed

1 file changed

+22
-20
lines changed

content/en/docs/collector/internal-telemetry.md

Lines changed: 22 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -370,12 +370,14 @@ With this configuration, `otelcol_process_uptime_seconds_total` is exported as
370370
names used dots (`.`). Prior to Collector v0.120.0, internal metrics exposed
371371
with Prometheus changed dots (`.`) to underscores (`_`) to match Prometheus
372372
naming conventions, resulting in metric names that looked like
373-
`rpc_server_duration`.
373+
`rpc_server_call_duration`.
374374

375375
Versions 0.120.0 and later of the Collector use Prometheus 3.0 scrapers, so the
376376
original `http*` and `rpc*` metric names with dots are preserved. The
377377
[internal metrics](#lists-of-internal-metrics) on this page are listed in their
378-
original form, such as`rpc.server.duration`. For more information, see the
378+
original form, such as `rpc.server.call.duration`. Because these metrics come
379+
from instrumentation libraries, their names can change as the underlying
380+
semantic conventions evolve. For more information, see the
379381
[Collector v0.120.0 release notes](https://github.com/open-telemetry/opentelemetry-collector-contrib/blob/main/CHANGELOG.md#v01200).
380382

381383
### Lists of internal metrics
@@ -453,30 +455,30 @@ files in the repository.
453455

454456
#### Additional `detailed`-level metrics
455457

456-
| Metric name | Description | Type |
457-
| ----------------------------------------------------- | ----------------------------------------------------------------------------------------- | --------- |
458-
| `http.client.request.body.size` | Measures the size of HTTP client request bodies. | Counter |
459-
| `http.client.request.duration` | Measures the duration of HTTP client requests. | Histogram |
460-
| `http.server.request.body.size` | Measures the size of HTTP server request bodies. | Counter |
461-
| `http.server.request.duration` | Measures the duration of HTTP server requests. | Histogram |
462-
| `http.server.response.body.size` | Measures the size of HTTP server response bodies. | Counter |
463-
| `otelcol_processor_batch_batch_`<br>`send_size_bytes` | Number of bytes in the batch that was sent. | Histogram |
464-
| `rpc.client.duration` | Measures the duration of outbound RPC. | Histogram |
465-
| `rpc.client.request.size` | Measures the size of RPC request messages (uncompressed). | Histogram |
466-
| `rpc.client.requests_per_rpc` | Measures the number of messages received per RPC. Should be 1 for all non-streaming RPCs. | Histogram |
467-
| `rpc.client.response.size` | Measures the size of RPC response messages (uncompressed). | Histogram |
468-
| `rpc.client.responses_per_rpc` | Measures the number of messages sent per RPC. Should be 1 for all non-streaming RPCs. | Histogram |
469-
| `rpc.server.duration` | Measures the duration of inbound RPC. | Histogram |
470-
| `rpc.server.request.size` | Measures the size of RPC request messages (uncompressed). | Histogram |
471-
| `rpc.server.requests_per_rpc` | Measures the number of messages received per RPC. Should be 1 for all non-streaming RPCs. | Histogram |
472-
| `rpc.server.response.size` | Measures the size of RPC response messages (uncompressed). | Histogram |
473-
| `rpc.server.responses_per_rpc` | Measures the number of messages sent per RPC. Should be 1 for all non-streaming RPCs. | Histogram |
458+
| Metric name | Description | Type |
459+
| ----------------------------------------------------- | --------------------------------------------------------------- | --------- |
460+
| `http.client.request.body.size` | Measures the size of HTTP client request bodies. | Counter |
461+
| `http.client.request.duration` | Measures the duration of HTTP client requests. | Histogram |
462+
| `http.server.request.body.size` | Measures the size of HTTP server request bodies. | Counter |
463+
| `http.server.request.duration` | Measures the duration of HTTP server requests. | Histogram |
464+
| `http.server.response.body.size` | Measures the size of HTTP server response bodies. | Counter |
465+
| `otelcol_processor_batch_batch_`<br>`send_size_bytes` | Number of bytes in the batch that was sent. | Histogram |
466+
| `rpc.client.call.duration` | Measures the duration of outbound remote procedure calls (RPC). | Histogram |
467+
| `rpc.client.request.size` | Measures the size of RPC request messages (uncompressed). | Histogram |
468+
| `rpc.client.response.size` | Measures the size of RPC response messages (uncompressed). | Histogram |
469+
| `rpc.server.call.duration` | Measures the duration of inbound remote procedure calls (RPC). | Histogram |
470+
| `rpc.server.request.size` | Measures the size of RPC request messages (uncompressed). | Histogram |
471+
| `rpc.server.response.size` | Measures the size of RPC response messages (uncompressed). | Histogram |
474472

475473
> [!NOTE]
476474
>
477475
> The `http*` and `rpc*` metrics are not covered by the maturity levels below
478476
> since they are not under the Collector SIG control.
479477
>
478+
> RPC metric names are version-dependent. Newer Collector releases expose
479+
> `rpc.client.call.duration` and `rpc.server.call.duration`. Older releases may
480+
> still expose `rpc.client.duration` and `rpc.server.duration`.
481+
>
480482
> The `otelcol_processor_batch_` metrics are unique to the `batchprocessor`.
481483
>
482484
> The `otelcol_receiver_`, `otelcol_scraper_`, `otelcol_processor_`, and

0 commit comments

Comments
 (0)