Skip to content

Commit a39bad2

Browse files
doltiffany76
andauthored
Update content/en/docs/collector/internal-telemetry.md
Co-authored-by: Tiffany Hrabusa <30397949+tiffany76@users.noreply.github.com>
1 parent 0c56862 commit a39bad2

File tree

1 file changed

+31
-1
lines changed

1 file changed

+31
-1
lines changed

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

Lines changed: 31 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -481,7 +481,37 @@ files in the repository.
481481
>
482482
> The `otelcol_receiver_`, `otelcol_scraper_`, `otelcol_processor_`, and
483483
> `otelcol_exporter_` metrics come from their respective `helper` packages. As
484-
> such, some components not using those packages might not emit them.
484+
#### Ownership of emitted metrics
485+
486+
Some metrics are not owned by the Collector SIG and some are limited to certain components.
487+
488+
**`http*`and `rpc` metrics**
489+
490+
These metrics are not under the Collector SIG's control, and as such, are not covered by the maturity levels below.
491+
492+
**`rpc` metrics**
493+
494+
The Collector's internal RPC metrics come from the upstream
495+
[`otelgrpc`](https://github.com/open-telemetry/opentelemetry-go-contrib/tree/main/instrumentation/google.golang.org/grpc/otelgrpc)
496+
instrumentation, which tracks the [OpenTelemetry RPC semantic conventions](/docs/specs/semconv/rpc/rpc-metrics/). The set of RPC
497+
metrics emitted by the Collector has changed across releases:
498+
499+
| Collector version | Emitted RPC metrics |
500+
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
501+
| v0.146.x and earlier | `rpc.client.duration`, `rpc.server.duration`, `rpc.*.request.size`, `rpc.*.response.size`, `rpc.*.requests_per_rpc`, `rpc.*.responses_per_rpc` |
502+
| v0.147.0 | `rpc.client.call.duration`, `rpc.server.call.duration`, `rpc.*.request.size`, `rpc.*.response.size` (the `*_per_rpc` metrics are deprecated and no longer emitted) |
503+
| v0.148.0 and later | `rpc.client.call.duration`, `rpc.server.call.duration` only |
504+
RPC size metrics are not emitted by
505+
Collector v0.148.0 or later. The [RPC semantic conventions v1.40.0](https://github.com/open-telemetry/semantic-conventions/releases/tag/v1.40.0)
506+
deprecated them due to ambiguous definitions and inconsistent implementation.
507+
508+
**`otelcol_processor_batch_*` metrics**
509+
510+
These metrics are unique to the `batchprocessor`.
511+
512+
**`helper` package metrics**
513+
514+
The `otelcol_receiver_`, `otelcol_scraper_`, `otelcol_processor_`, and `otelcol_exporter_` metrics come from their respective `helper` packages. As such, some components not using those packages might not emit them.
485515

486516
### Events observable with internal logs
487517

0 commit comments

Comments
 (0)