Skip to content

Commit a061555

Browse files
authored
[docs/collector] Clarify stance with regards to third-party instrumentation (#6195)
1 parent 44d9f0e commit a061555

File tree

1 file changed

+11
-2
lines changed

1 file changed

+11
-2
lines changed

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

+11-2
Original file line numberDiff line numberDiff line change
@@ -305,7 +305,9 @@ There are currently no metrics specific to `normal` verbosity.
305305
{{% alert title="Note" color="info" %}} The `http_` and `rpc_` metrics come from
306306
instrumentation libraries. Their original names use dots (`.`), but when
307307
exposing internal metrics with Prometheus, they are translated to use
308-
underscores (`_`) to match Prometheus' naming constraints.
308+
underscores (`_`) to match Prometheus' naming constraints. These metrics are not
309+
covered by the maturity levels below since they are not under the Collector SIG
310+
control.
309311

310312
The `otelcol_processor_batch_` metrics are unique to the `batchprocessor`.
311313

@@ -329,6 +331,10 @@ The Collector logs the following internal events:
329331

330332
## Telemetry maturity levels
331333

334+
The Collector telemetry levels apply to all first-party telemetry produced by
335+
the Collector. Third-party libraries, including those of OpenTelemetry Go, are
336+
not covered by these maturity levels.
337+
332338
### Traces
333339

334340
Tracing instrumentation is still under active development, and changes might be
@@ -338,10 +344,13 @@ guarantees of backwards compatibility for tracing instrumentation.
338344

339345
### Metrics
340346

341-
The Collector's metrics follow a four-stage lifecycle:
347+
The Collector's first-party metrics follow a four-stage lifecycle:
342348

343349
> Alpha metric → Stable metric → Deprecated metric → Deleted metric
344350

351+
Third-party metrics, including those generated by OpenTelemetry Go
352+
instrumentation libraries, are not covered by these maturity levels.
353+
345354
#### Alpha
346355

347356
Alpha metrics have no stability guarantees. These metrics can be modified or

0 commit comments

Comments
 (0)