[chore][kafkaexporter] Add stability level per metric (open-telemetry#42994)

<!--Ex. Fixing a bug - Describe the bug and how this fixes the issue.
Ex. Adding a feature - Explain what this achieves.-->
#### Description

open-telemetry/opentelemetry-collector#13756
added support for exposing metrics' stability level in the generated
documentation. This PR makes use of this functionality.

We start by setting the stability of all metrics to `development`. More
info about levels can be found at
https://github.com/open-telemetry/opentelemetry-specification/blob/v1.49.0/oteps/0232-maturity-of-otel.md#maturity-levels.

Related to:
- open-telemetry/opentelemetry-collector#11878
- open-telemetry/opentelemetry-collector#13297
-
open-telemetry#35325
-
open-telemetry#42809

<!-- Issue number (e.g. open-telemetry#1234) or full URL to issue, if applicable. -->
#### Link to tracking issue
Fixes ~

<!--Describe what testing was performed and which tests were added.-->
#### Testing
~

<!--Describe the documentation added.-->
#### Documentation
Updated

<!--Please delete paragraphs that you did not use before submitting.-->

Signed-off-by: ChrsMark <[email protected]>
Co-authored-by: Alex Boten <[email protected]>

Author: ChrsMark

exporter/kafkaexporter/documentation.md

@@ -8,13 +8,13 @@ The following telemetry is emitted by this component.
 
 ### otelcol_kafka_broker_closed
 
-The total number of connections closed.
+The total number of connections closed. [development]
 
 Only produced when franz-go is enabled.
 
-| Unit | Metric Type | Value Type | Monotonic |
-| ---- | ----------- | ---------- | --------- |
-| 1 | Sum | Int | true |
+| Unit | Metric Type | Value Type | Monotonic | Stability |
+| ---- | ----------- | ---------- | --------- | --------- |
+| 1 | Sum | Int | true | development |
 
 #### Attributes
 
@@ -24,13 +24,13 @@ Only produced when franz-go is enabled.
 
 ### otelcol_kafka_broker_connects
 
-The total number of connections opened.
+The total number of connections opened. [development]
 
 Only produced when franz-go is enabled.
 
-| Unit | Metric Type | Value Type | Monotonic |
-| ---- | ----------- | ---------- | --------- |
-| 1 | Sum | Int | true |
+| Unit | Metric Type | Value Type | Monotonic | Stability |
+| ---- | ----------- | ---------- | --------- | --------- |
+| 1 | Sum | Int | true | development |
 
 #### Attributes
 
@@ -57,13 +57,13 @@ Only produced when franz-go is enabled. Deprecated in favor of kafka_broker_thro
 
 ### otelcol_kafka_broker_throttling_latency
 
-The throttling latency in seconds imposed by the broker when exporting records.
+The throttling latency in seconds imposed by the broker when exporting records. [development]
 
 Only produced when franz-go is enabled.
 
-| Unit | Metric Type | Value Type |
-| ---- | ----------- | ---------- |
-| s | Histogram | Double |
+| Unit | Metric Type | Value Type | Stability |
+| ---- | ----------- | ---------- | --------- |
+| s | Histogram | Double | development |
 
 #### Attributes
 
@@ -73,13 +73,13 @@ Only produced when franz-go is enabled.
 
 ### otelcol_kafka_exporter_bytes
 
-The size in bytes of exported records seen by the broker.
+The size in bytes of exported records seen by the broker. [development]
 
 Only produced when franz-go is enabled.
 
-| Unit | Metric Type | Value Type | Monotonic |
-| ---- | ----------- | ---------- | --------- |
-| By | Sum | Int | true |
+| Unit | Metric Type | Value Type | Monotonic | Stability |
+| ---- | ----------- | ---------- | --------- | --------- |
+| By | Sum | Int | true | development |
 
 #### Attributes
 
@@ -92,11 +92,11 @@ Only produced when franz-go is enabled.
 
 ### otelcol_kafka_exporter_bytes_uncompressed
 
-The uncompressed size in bytes of exported messages seen by the client.
+The uncompressed size in bytes of exported messages seen by the client. [development]
 
-| Unit | Metric Type | Value Type | Monotonic |
-| ---- | ----------- | ---------- | --------- |
-| By | Sum | Int | true |
+| Unit | Metric Type | Value Type | Monotonic | Stability |
+| ---- | ----------- | ---------- | --------- | --------- |
+| By | Sum | Int | true | development |
 
 #### Attributes
 
@@ -147,11 +147,11 @@ Deprecated in favor of kafka_exporter_records.
 
 ### otelcol_kafka_exporter_records
 
-The number of exported records.
+The number of exported records. [development]
 
-| Unit | Metric Type | Value Type | Monotonic |
-| ---- | ----------- | ---------- | --------- |
-| 1 | Sum | Int | true |
+| Unit | Metric Type | Value Type | Monotonic | Stability |
+| ---- | ----------- | ---------- | --------- | --------- |
+| 1 | Sum | Int | true | development |
 
 #### Attributes
 
@@ -164,11 +164,11 @@ The number of exported records.
 
 ### otelcol_kafka_exporter_write_latency
 
-The time it took in seconds to export a batch of records.
+The time it took in seconds to export a batch of records. [development]
 
-| Unit | Metric Type | Value Type |
-| ---- | ----------- | ---------- |
-| s | Histogram | Double |
+| Unit | Metric Type | Value Type | Stability |
+| ---- | ----------- | ---------- | --------- |
+| s | Histogram | Double | development |
 
 #### Attributes
 

exporter/kafkaexporter/internal/metadata/generated_telemetry.go

@@ -39,6 +39,8 @@ telemetry:
   metrics:
     kafka_broker_connects:
       enabled: true
+      stability:
+        level: development
       description: The total number of connections opened.
       extended_documentation: Only produced when franz-go is enabled.
       optional: true
@@ -49,6 +51,8 @@ telemetry:
       attributes: [node_id, outcome]
     kafka_broker_closed:
       enabled: true
+      stability:
+        level: development
       description: The total number of connections closed.
       extended_documentation: Only produced when franz-go is enabled.
       optional: true
@@ -72,6 +76,8 @@ telemetry:
         if_enabled: This metric is deprecated in favor of kafka_broker_throttling_latency and will be removed soon.
     kafka_broker_throttling_latency:
       enabled: true
+      stability:
+        level: development
       description: The throttling latency in seconds imposed by the broker when exporting records.
       extended_documentation: Only produced when franz-go is enabled.
       optional: true
@@ -95,6 +101,8 @@ telemetry:
         if_enabled: This metric is deprecated in favor of kafka_exporter_records and will be removed soon.
     kafka_exporter_records:
       enabled: true
+      stability:
+        level: development
       description: The number of exported records.
       unit: "1"
       sum:
@@ -103,6 +111,8 @@ telemetry:
       attributes: [node_id, topic, partition, outcome]
     kafka_exporter_bytes:
       enabled: true
+      stability:
+        level: development
       description: The size in bytes of exported records seen by the broker.
       extended_documentation: Only produced when franz-go is enabled.
       optional: true
@@ -113,6 +123,8 @@ telemetry:
       attributes: [node_id, topic, partition, outcome]
     kafka_exporter_bytes_uncompressed:
       enabled: true
+      stability:
+        level: development
       description: The uncompressed size in bytes of exported messages seen by the client.
       unit: By
       sum:
@@ -133,6 +145,8 @@ telemetry:
         if_enabled: This metric is deprecated in favor of kafka_exporter_write_latency and will be removed soon.
     kafka_exporter_write_latency:
       enabled: true
+      stability:
+        level: development
       description: The time it took in seconds to export a batch of records.
       unit: s
       histogram: