type: receiverhelper
github_project: open-telemetry/opentelemetry-collector
status:
  disable_codecov_badge: true
  class: pkg
  stability:
    beta: [metrics, traces, logs]
telemetry:
  metrics:
    receiver_accepted_log_records:
      enabled: true
      stability: alpha
      description: Number of log records successfully pushed into the pipeline.
      unit: "{record}"
      sum:
        value_type: int
        monotonic: true
    receiver_accepted_metric_points:
      stability: alpha
      enabled: true
      description: Number of metric points successfully pushed into the pipeline.
      unit: "{datapoint}"
      sum:
        value_type: int
        monotonic: true
    receiver_accepted_profile_samples:
      enabled: true
      stability: alpha
      description: Number of profile samples successfully pushed into the pipeline.
      unit: "{sample}"
      sum:
        value_type: int
        monotonic: true
    receiver_accepted_spans:
      enabled: true
      stability: alpha
      description: Number of spans successfully pushed into the pipeline.
      unit: "{span}"
      sum:
        value_type: int
        monotonic: true
    receiver_failed_log_records:
      enabled: true
      stability: alpha
      description: The number of log records that failed to be processed by the receiver due to internal errors.
      unit: "{record}"
      sum:
        value_type: int
        monotonic: true
    receiver_failed_metric_points:
      enabled: true
      stability: alpha
      description: The number of metric points that failed to be processed by the receiver due to internal errors.
      unit: "{datapoint}"
      sum:
        value_type: int
        monotonic: true
    receiver_failed_profile_samples:
      enabled: true
      stability: alpha
      description: The number of profile samples that failed to be processed by the receiver due to internal errors.
      unit: "{sample}"
      sum:
        value_type: int
        monotonic: true
    receiver_failed_spans:
      enabled: true
      stability: alpha
      description: The number of spans that failed to be processed by the receiver due to internal errors.
      unit: "{span}"
      sum:
        value_type: int
        monotonic: true
    receiver_refused_log_records:
      enabled: true
      stability: alpha
      description: Number of log records that could not be pushed into the pipeline.
      unit: "{record}"
      sum:
        value_type: int
        monotonic: true
    receiver_refused_metric_points:
      enabled: true
      stability: alpha
      description: Number of metric points that could not be pushed into the pipeline.
      unit: "{datapoint}"
      sum:
        value_type: int
        monotonic: true
    receiver_refused_profile_samples:
      enabled: true
      stability: alpha
      description: Number of profile samples that could not be pushed into the pipeline.
      unit: "{sample}"
      sum:
        value_type: int
        monotonic: true
    receiver_refused_spans:
      enabled: true
      stability: alpha
      description: Number of spans that could not be pushed into the pipeline.
      unit: "{span}"
      sum:
        value_type: int
        monotonic: true
    receiver_requests:
      enabled: true
      stability: alpha
      description: The number of requests performed.
      unit: "{request}"
      sum:
        value_type: int
        monotonic: true
      attributes:
        - outcome
attributes:
  outcome:
    description: The outcome of receiver requests
    type: string
    enum:
      - success
      - refused
      - failure

feature_gates:
  - id: receiverhelper.newReceiverMetrics
    description: 'Controls whether receivers emit new metrics and span attributes to distinguish downstream errors from internal errors. This is a breaking change for the semantics of the otelcol_receiver_refused_metric_points,  otelcol_receiver_refused_log_records and otelcol_receiver_refused_spans.'
    stage: alpha
    from_version: 'v0.138.0'
    reference_url: 'https://github.com/open-telemetry/opentelemetry-collector/pull/12802'
