Skip to content

Commit 6add9de

Browse files
committed
[docs/collector] Clarify stance with regards to third-party instrumentation
1 parent 4575bd5 commit 6add9de

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
@@ -293,7 +293,9 @@ There are currently no metrics specific to `normal` verbosity.
293293
{{% alert title="Note" color="info" %}} The `http_` and `rpc_` metrics come from
294294
instrumentation libraries. Their original names use dots (`.`), but when
295295
exposing internal metrics with Prometheus, they are translated to use
296-
underscores (`_`) to match Prometheus' naming constraints.
296+
underscores (`_`) to match Prometheus' naming constraints. These metrics are not
297+
covered by the maturity levels below since they are not under the Collector SIG
298+
control.
297299

298300
The `otelcol_processor_batch_` metrics are unique to the `batchprocessor`.
299301

@@ -317,6 +319,10 @@ The Collector logs the following internal events:
317319

318320
## Telemetry maturity levels
319321

322+
The Collector telemetry levels apply to all first-party telemetry produced by
323+
the Collector. Third-party libraries, including those of OpenTelemetry Go, are
324+
not covered by these maturity levels.
325+
320326
### Traces
321327

322328
Tracing instrumentation is still under active development, and changes might be
@@ -326,10 +332,13 @@ guarantees of backwards compatibility for tracing instrumentation.
326332

327333
### Metrics
328334

329-
The Collector's metrics follow a four-stage lifecycle:
335+
The Collector's first-party metrics follow a four-stage lifecycle:
330336

331337
> Alpha metric → Stable metric → Deprecated metric → Deleted metric
332338

339+
Third-party metrics, including those generated by OpenTelemetry Go
340+
instrumentation libraries, are not covered by these maturity levels.
341+
333342
#### Alpha
334343

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

0 commit comments

Comments
 (0)