Add notes about resource correlation

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

docs/system/k8s-metrics.md

@@ -345,7 +345,10 @@ This metric is [recommended][MetricRecommended].
 | `k8s.daemonset.current_scheduled_nodes` | UpDownCounter | `{node}` | Number of nodes that are running at least 1 daemon pod and are supposed to run the daemon pod [1] | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
 
 **[1]:** This metric aligns with the `currentNumberScheduled` field of the
-[K8s DaemonSetStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.30/#daemonsetstatus-v1-apps)
+[K8s DaemonSetStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.30/#daemonsetstatus-v1-apps).
+
+This metric SHOULD, at a minimum, be reported against a
+[`k8s.daemonset`](../resource/k8s.md#daemonset) resource.
 
 <!-- markdownlint-restore -->
 <!-- prettier-ignore-end -->
@@ -368,7 +371,10 @@ This metric is [recommended][MetricRecommended].
 | `k8s.daemonset.desired_scheduled_nodes` | UpDownCounter | `{node}` | Number of nodes that should be running the daemon pod (including nodes currently running the daemon pod) [1] | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
 
 **[1]:** This metric aligns with the `desiredNumberScheduled` field of the
-[K8s DaemonSetStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.30/#daemonsetstatus-v1-apps)
+[K8s DaemonSetStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.30/#daemonsetstatus-v1-apps).
+
+This metric SHOULD, at a minimum, be reported against a
+[`k8s.daemonset`](../resource/k8s.md#daemonset) resource.
 
 <!-- markdownlint-restore -->
 <!-- prettier-ignore-end -->
@@ -391,7 +397,10 @@ This metric is [recommended][MetricRecommended].
 | `k8s.daemonset.misscheduled_nodes` | UpDownCounter | `{node}` | Number of nodes that are running the daemon pod, but are not supposed to run the daemon pod [1] | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
 
 **[1]:** This metric aligns with the `numberMisscheduled` field of the
-[K8s DaemonSetStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.30/#daemonsetstatus-v1-apps)
+[K8s DaemonSetStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.30/#daemonsetstatus-v1-apps).
+
+This metric SHOULD, at a minimum, be reported against a
+[`k8s.daemonset`](../resource/k8s.md#daemonset) resource.
 
 <!-- markdownlint-restore -->
 <!-- prettier-ignore-end -->
@@ -414,7 +423,10 @@ This metric is [recommended][MetricRecommended].
 | `k8s.daemonset.ready_nodes` | UpDownCounter | `{node}` | Number of nodes that should be running the daemon pod and have one or more of the daemon pod running and ready [1] | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
 
 **[1]:** This metric aligns with the `numberReady` field of the
-[K8s DaemonSetStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.30/#daemonsetstatus-v1-apps)
+[K8s DaemonSetStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.30/#daemonsetstatus-v1-apps).
+
+This metric SHOULD, at a minimum, be reported against a
+[`k8s.daemonset`](../resource/k8s.md#daemonset) resource.
 
 <!-- markdownlint-restore -->
 <!-- prettier-ignore-end -->

model/k8s/metrics.yaml

@@ -135,7 +135,10 @@ groups:
     brief: "Number of nodes that are running at least 1 daemon pod and are supposed to run the daemon pod"
     note: |
       This metric aligns with the `currentNumberScheduled` field of the
-      [K8s DaemonSetStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.30/#daemonsetstatus-v1-apps)
+      [K8s DaemonSetStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.30/#daemonsetstatus-v1-apps).
+
+      This metric SHOULD, at a minimum, be reported against a
+      [`k8s.daemonset`](../resource/k8s.md#daemonset) resource.
     instrument: updowncounter
     unit: "{node}"
   - id: metric.k8s.daemonset.desired_scheduled_nodes
@@ -145,7 +148,10 @@ groups:
     brief: "Number of nodes that should be running the daemon pod (including nodes currently running the daemon pod)"
     note: |
       This metric aligns with the `desiredNumberScheduled` field of the
-      [K8s DaemonSetStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.30/#daemonsetstatus-v1-apps)
+      [K8s DaemonSetStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.30/#daemonsetstatus-v1-apps).
+
+      This metric SHOULD, at a minimum, be reported against a
+      [`k8s.daemonset`](../resource/k8s.md#daemonset) resource.
     instrument: updowncounter
     unit: "{node}"
   - id: metric.k8s.daemonset.misscheduled_nodes
@@ -155,7 +161,10 @@ groups:
     brief: "Number of nodes that are running the daemon pod, but are not supposed to run the daemon pod"
     note: |
       This metric aligns with the `numberMisscheduled` field of the
-      [K8s DaemonSetStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.30/#daemonsetstatus-v1-apps)
+      [K8s DaemonSetStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.30/#daemonsetstatus-v1-apps).
+
+      This metric SHOULD, at a minimum, be reported against a
+      [`k8s.daemonset`](../resource/k8s.md#daemonset) resource.
     instrument: updowncounter
     unit: "{node}"
   - id: metric.k8s.daemonset.ready_nodes
@@ -165,6 +174,9 @@ groups:
     brief: "Number of nodes that should be running the daemon pod and have one or more of the daemon pod running and ready"
     note: |
       This metric aligns with the `numberReady` field of the
-      [K8s DaemonSetStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.30/#daemonsetstatus-v1-apps)
+      [K8s DaemonSetStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.30/#daemonsetstatus-v1-apps).
+
+      This metric SHOULD, at a minimum, be reported against a
+      [`k8s.daemonset`](../resource/k8s.md#daemonset) resource.
     instrument: updowncounter
     unit: "{node}"