[processor/k8sattributes] introduce new selfmon metrics

Signed-off-by: odubajDT <[email protected]>

Author: odubajDT

.chloggen/k8sattributesprocessor-stable-observability.yaml

@@ -0,0 +1,27 @@
+# Use this changelog template to create an entry for release notes.
+
+# One of 'breaking', 'deprecation', 'new_component', 'enhancement', 'bug_fix'
+change_type: 'enhancement'
+
+# The name of the component, or a single word describing the area of concern, (e.g. receiver/filelog)
+component: processor/k8sattributes
+
+# A brief description of the change.  Surround your text with quotes ("") if it needs to start with a backtick (`).
+note: "Added processor-specific observability metrics: `processor_k8sattributes_pod_association_success`, `processor_k8sattributes_pod_association_error`, and `processor_k8sattributes_resource_attributes_added` with k8s_telemetry_type attribute for signal differentiation"
+
+# Mandatory: One or more tracking issues related to the change. You can use the PR number here if no issue exists.
+issues: [44587]
+
+# (Optional) One or more lines of additional information to render under the primary note.
+# These lines will be padded with 2 spaces and then inserted directly into the document.
+# Use pipe (|) for multiline entries.
+subtext:
+
+# If your change doesn't affect end users or the exported elements of any package,
+# you should instead start your pull request title with [chore] or use the "Skip Changelog" label.
+# Optional: The change log or logs in which this entry should be included.
+# e.g. '[user]' or '[user, api]'
+# Include 'user' if the change is relevant to end users.
+# Include 'api' if there is a change to a library API.
+# Default: '[user]'
+change_logs: []

processor/k8sattributesprocessor/documentation.md

@@ -152,3 +152,45 @@ Number of ReplicaSet update events received [Development]
 | Unit | Metric Type | Value Type | Monotonic | Stability |
 | ---- | ----------- | ---------- | --------- | --------- |
 | 1 | Sum | Int | true | Development |
+
+### otelcol_processor_k8sattributes_pod_association_error
+
+Number of failed pod associations [Development]
+
+| Unit | Metric Type | Value Type | Monotonic | Stability |
+| ---- | ----------- | ---------- | --------- | --------- |
+| {resources} | Sum | Int | true | Development |
+
+#### Attributes
+
+| Name | Description | Values |
+| ---- | ----------- | ------ |
+| k8s_telemetry_type | The type of telemetry data being processed (traces, metrics, logs, profiles) | Str: ``traces``, ``metrics``, ``logs``, ``profiles`` |
+
+### otelcol_processor_k8sattributes_pod_association_success
+
+Number of successful pod associations [Development]
+
+| Unit | Metric Type | Value Type | Monotonic | Stability |
+| ---- | ----------- | ---------- | --------- | --------- |
+| {resources} | Sum | Int | true | Development |
+
+#### Attributes
+
+| Name | Description | Values |
+| ---- | ----------- | ------ |
+| k8s_telemetry_type | The type of telemetry data being processed (traces, metrics, logs, profiles) | Str: ``traces``, ``metrics``, ``logs``, ``profiles`` |
+
+### otelcol_processor_k8sattributes_resource_attributes_added
+
+Number of times resource attributes were successfully added to resources [Development]
+
+| Unit | Metric Type | Value Type | Monotonic | Stability |
+| ---- | ----------- | ---------- | --------- | --------- |
+| {resources} | Sum | Int | true | Development |
+
+#### Attributes
+
+| Name | Description | Values |
+| ---- | ----------- | ------ |
+| k8s_telemetry_type | The type of telemetry data being processed (traces, metrics, logs, profiles) | Str: ``traces``, ``metrics``, ``logs``, ``profiles`` |

processor/k8sattributesprocessor/factory.go

@@ -14,6 +14,7 @@ import (
 	"go.opentelemetry.io/collector/processor/processorhelper"
 	"go.opentelemetry.io/collector/processor/processorhelper/xprocessorhelper"
 	"go.opentelemetry.io/collector/processor/xprocessor"
+	"go.uber.org/zap"
 
 	"github.com/open-telemetry/opentelemetry-collector-contrib/internal/k8sconfig"
 	"github.com/open-telemetry/opentelemetry-collector-contrib/processor/k8sattributesprocessor/internal/kube"
@@ -171,11 +172,17 @@ func createKubernetesProcessor(
 	cfg component.Config,
 	options ...option,
 ) *kubernetesprocessor {
+	telemetry, err := metadata.NewTelemetryBuilder(params.TelemetrySettings)
+	if err != nil {
+		params.Logger.Error("failed to create telemetry builder", zap.Error(err))
+	}
+
 	kp := &kubernetesprocessor{
 		logger:            params.Logger,
 		cfg:               cfg,
 		options:           options,
 		telemetrySettings: params.TelemetrySettings,
+		telemetry:         telemetry,
 	}
 
 	return kp

processor/k8sattributesprocessor/internal/metadata/generated_telemetry.go

@@ -140,6 +140,16 @@ tests:
   goleak:
     skip: true
 
+attributes:
+  k8s_telemetry_type:
+    description: The type of telemetry data being processed (traces, metrics, logs, profiles)
+    type: string
+    enum:
+      - traces
+      - metrics
+      - logs
+      - profiles
+
 telemetry:
   metrics:
     otelsvc_k8s_daemonset_added:
@@ -375,3 +385,34 @@ telemetry:
       sum:
         value_type: int
         monotonic: true
+    processor_k8sattributes_pod_association_error:
+      enabled: true
+      description: Number of failed pod associations
+      stability:
+        level: development
+      unit: "{resources}"
+      attributes: [k8s_telemetry_type]
+      sum:
+        value_type: int
+        monotonic: true
+    processor_k8sattributes_pod_association_success:
+      enabled: true
+      description: Number of successful pod associations
+      stability:
+        level: development
+      unit: "{resources}"
+      attributes: [k8s_telemetry_type]
+      sum:
+        value_type: int
+        monotonic: true
+    processor_k8sattributes_resource_attributes_added:
+      enabled: true
+      description: Number of times resource attributes were successfully added to resources
+      stability:
+        level: development
+      unit: "{resources}"
+      attributes: [k8s_telemetry_type]
+      sum:
+        value_type: int
+        monotonic: true
+