reverting docs

Signed-off-by: Andreas Gkizas <[email protected]>

Author: gizas

receiver/doc.go

@@ -9,24 +9,13 @@
 //
 // # Error Handling
 //
-// The nextConsumer.Consume*() function may return an error to indicate that the data
-// was not accepted. There are 2 types of possible errors: Permanent and non-Permanent.
-// The receiver must check the type of the error using IsPermanent() helper.
-//
-// If the error is Permanent, then the nextConsumer.Consume*() call should not be
-// retried with the same data. This typically happens when the data cannot be
-// serialized by the exporter that is attached to the pipeline or when the destination
-// refuses the data because it cannot decode it. The receiver must indicate to
-// the source from which it received the data that the received data was bad, if the
-// receiving protocol allows to do that. In case of OTLP/HTTP for example, this means
-// that HTTP 400 response is returned to the sender.
-//
-// If the error is non-Permanent then the nextConsumer.Consume*() call should be retried
-// with the same data. This may be done by the receiver itself, however typically it is
-// done by the original sender, after the receiver returns a response to the sender
-// indicating that the Collector is currently overloaded and the request must be
-// retried. In case of OTLP/HTTP for example, this means that HTTP 429 or 503 response
-// is returned.
+// The nextConsumer.Consume*() function may return an error to indicate that the data was not
+// accepted. This error should be handled as documented in the consumererror package.
+//
+// Depending on the error type, the receiver must indicate to the source from which it received the
+// data the type of error in a protocol-dependent way, if that is supported by the receiving protocol.
+// For example, a receiver for the OTLP/HTTP protocol would use the HTTP status codes as defined in
+// the OTLP specification.
 //
 // # Acknowledgment and Checkpointing
 //

receiver/receiverhelper/documentation.md

@@ -8,19 +8,19 @@ The following telemetry is emitted by this component.
 
 ### otelcol_receiver_accepted_log_records
 
-The number of log records successfully accepted by the receiver.
+Number of log records successfully pushed into the pipeline. [alpha]
 
 | Unit | Metric Type | Value Type | Monotonic |
 | ---- | ----------- | ---------- | --------- |
 | {records} | Sum | Int | true |
 
 ### otelcol_receiver_accepted_metric_points
 
-The number of metric points successfully accepted by the receiver.
+Number of metric points successfully pushed into the pipeline. [alpha]
 
 | Unit | Metric Type | Value Type | Monotonic |
 | ---- | ----------- | ---------- | --------- |
-| {points} | Sum | Int | true |
+| {datapoints} | Sum | Int | true |
 
 ### otelcol_receiver_accepted_spans
 
@@ -56,19 +56,19 @@ The number of spans that failed to be processed by the receiver due to internal
 
 ### otelcol_receiver_refused_log_records
 
-The number of log records refused by the receiver.
+Number of log records that could not be pushed into the pipeline. [alpha]
 
 | Unit | Metric Type | Value Type | Monotonic |
 | ---- | ----------- | ---------- | --------- |
 | {records} | Sum | Int | true |
 
 ### otelcol_receiver_refused_metric_points
 
-The number of metric points refused by the receiver.
+Number of metric points that could not be pushed into the pipeline. [alpha]
 
 | Unit | Metric Type | Value Type | Monotonic |
 | ---- | ----------- | ---------- | --------- |
-| {points} | Sum | Int | true |
+| {datapoints} | Sum | Int | true |
 
 ### otelcol_receiver_refused_spans
 

receiver/receiverhelper/metadata.yaml

@@ -4,78 +4,77 @@ status:
   disable_codecov_badge: true
   class: pkg
   stability:
-    stable: [metrics, traces, logs]
+    beta: [metrics, traces, logs]
 telemetry:
   metrics:
     receiver_accepted_spans:
       enabled: true
-      description: Number of spans successfully pushed into the pipeline. [alpha]
+      stability:
+        level: alpha
+      description: Number of spans successfully pushed into the pipeline.
       unit: "{spans}"
       sum:
         value_type: int
         monotonic: true
-        aggregation_temporality: cumulative
     receiver_refused_spans:
       enabled: true
-      description: Number of spans that could not be pushed into the pipeline. [alpha]
+      description: Number of spans that could not be pushed into the pipeline.
       unit: "{spans}"
       sum:
         value_type: int
         monotonic: true
-        aggregation_temporality: cumulative
     receiver_internal_errors_spans:
       enabled: true
       description: The number of spans that failed to be processed by the receiver due to internal errors.
       unit: "{spans}"
       sum:
         value_type: int
         monotonic: true
-        aggregation_temporality: cumulative
     receiver_accepted_metric_points:
+      stability:
+        level: alpha
       enabled: true
-      description: The number of metric points successfully accepted by the receiver.
-      unit: "{points}"
+      description: Number of metric points successfully pushed into the pipeline.
+      unit: "{datapoints}"
       sum:
         value_type: int
         monotonic: true
-        aggregation_temporality: cumulative
     receiver_refused_metric_points:
       enabled: true
-      description: The number of metric points refused by the receiver.
-      unit: "{points}"
+      description: Number of metric points that could not be pushed into the pipeline.
+      unit: "{datapoints}"
       sum:
         value_type: int
         monotonic: true
-        aggregation_temporality: cumulative
     receiver_internal_errors_metric_points:
       enabled: true
       description: The number of metric points that failed to be processed by the receiver due to internal errors.
-      unit: "{points}"
+      unit: "{datapoints}"
       sum:
         value_type: int
         monotonic: true
-        aggregation_temporality: cumulative
     receiver_accepted_log_records:
       enabled: true
-      description: The number of log records successfully accepted by the receiver.
+      stability:
+        level: alpha
+      description: Number of log records successfully pushed into the pipeline.
       unit: "{records}"
       sum:
         value_type: int
         monotonic: true
-        aggregation_temporality: cumulative
     receiver_refused_log_records:
       enabled: true
-      description: The number of log records refused by the receiver.
+      stability:
+        level: alpha
+      description: Number of log records that could not be pushed into the pipeline.
       unit: "{records}"
       sum:
         value_type: int
         monotonic: true
-        aggregation_temporality: cumulative
     receiver_internal_errors_log_records:
       enabled: true
       description: The number of log records that failed to be processed by the receiver due to internal errors.
       unit: "{records}"
       sum:
         value_type: int
         monotonic: true
-        aggregation_temporality: cumulative