[k8sclusterreceiver] add k8s.pod.qos_class optional resource attribute (

#27485)

**Description:** <Describe what has changed.>

add k8s.pod.qos_class optional resource attriute

**Link to tracking Issue:** <Issue number if applicable>

#27483

**Testing:** <Describe what testing was performed and which tests were
added.>
- updated unit tests

**Documentation:** <Describe the documentation added.>

- generated

.chloggen/k8sclusterreceiver-qos-class.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. filelogreceiver)
+component: k8sclusterreceiver
+
+# A brief description of the change.  Surround your text with quotes ("") if it needs to start with a backtick (`).
+note: "add optional k8s.pod.qos_class resource attribute"
+
+# Mandatory: One or more tracking issues related to the change. You can use the PR number here if no issue exists.
+issues: [27483]
+
+# (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: [user]

receiver/k8sclusterreceiver/documentation.md

@@ -429,6 +429,7 @@ Current status reason of the pod (1 - Evicted, 2 - NodeAffinity, 3 - NodeLost, 4
 | k8s.node.name | The k8s node name. | Any Str | true |
 | k8s.node.uid | The k8s node uid. | Any Str | true |
 | k8s.pod.name | The k8s pod name. | Any Str | true |
+| k8s.pod.qos_class | The k8s pod qos class name. One of Guaranteed, Burstable, BestEffort. | Any Str | false |
 | k8s.pod.uid | The k8s pod uid. | Any Str | true |
 | k8s.replicaset.name | The k8s replicaset name | Any Str | true |
 | k8s.replicaset.uid | The k8s replicaset uid | Any Str | true |

receiver/k8sclusterreceiver/internal/metadata/testdata/config.yaml

@@ -130,6 +130,8 @@ all_set:
       enabled: true
     k8s.pod.name:
       enabled: true
+    k8s.pod.qos_class:
+      enabled: true
     k8s.pod.uid:
       enabled: true
     k8s.replicaset.name:
@@ -283,6 +285,8 @@ none_set:
       enabled: false
     k8s.pod.name:
       enabled: false
+    k8s.pod.qos_class:
+      enabled: false
     k8s.pod.uid:
       enabled: false
     k8s.replicaset.name:

receiver/k8sclusterreceiver/internal/pod/pods.go

@@ -41,7 +41,8 @@ func Transform(pod *corev1.Pod) *corev1.Pod {
 			NodeName: pod.Spec.NodeName,
 		},
 		Status: corev1.PodStatus{
-			Phase: pod.Status.Phase,
+			Phase:    pod.Status.Phase,
+			QOSClass: pod.Status.QOSClass,
 		},
 	}
 	for _, cs := range pod.Status.ContainerStatuses {
@@ -76,6 +77,7 @@ func RecordMetrics(logger *zap.Logger, mb *metadata.MetricsBuilder, pod *corev1.
 	rb.SetK8sNodeName(pod.Spec.NodeName)
 	rb.SetK8sPodName(pod.Name)
 	rb.SetK8sPodUID(string(pod.UID))
+	rb.SetK8sPodQosClass(string(pod.Status.QOSClass))
 	mb.EmitForResource(metadata.WithResource(rb.Emit()))
 
 	for _, c := range pod.Spec.Containers {

receiver/k8sclusterreceiver/internal/pod/pods_test.go

@@ -68,6 +68,7 @@ func TestPodStatusReasonAndContainerMetricsReportCPUMetrics(t *testing.T) {
 
 	mbc := metadata.DefaultMetricsBuilderConfig()
 	mbc.Metrics.K8sPodStatusReason.Enabled = true
+	mbc.ResourceAttributes.K8sPodQosClass.Enabled = true
 	ts := pcommon.Timestamp(time.Now().UnixNano())
 	mb := metadata.NewMetricsBuilder(mbc, receivertest.NewNopCreateSettings())
 	RecordMetrics(zap.NewNop(), mb, pod, ts)

receiver/k8sclusterreceiver/internal/pod/testdata/expected_evicted.yaml

@@ -10,6 +10,9 @@ resourceMetrics:
         - key: k8s.pod.name
           value:
             stringValue: test-pod-1
+        - key: k8s.pod.qos_class
+          value:
+            stringValue: BestEffort
         - key: k8s.pod.uid
           value:
             stringValue: test-pod-1-uid

receiver/k8sclusterreceiver/internal/testutils/objects.go

@@ -264,8 +264,9 @@ func NewPodStatusWithContainer(containerName, containerID string) *corev1.PodSta
 
 func NewEvictedTerminatedPodStatusWithContainer(containerName, containerID string) *corev1.PodStatus {
 	return &corev1.PodStatus{
-		Phase:  corev1.PodFailed,
-		Reason: "Evicted",
+		Phase:    corev1.PodFailed,
+		QOSClass: corev1.PodQOSBestEffort,
+		Reason:   "Evicted",
 		ContainerStatuses: []corev1.ContainerStatus{
 			{
 				Name:         containerName,

receiver/k8sclusterreceiver/metadata.yaml

@@ -62,6 +62,11 @@ resource_attributes:
     type: string
     enabled: true
 
+  k8s.pod.qos_class:
+    description: "The k8s pod qos class name. One of Guaranteed, Burstable, BestEffort."
+    type: string
+    enabled: false
+
   k8s.replicaset.name:
     description: The k8s replicaset name
     type: string