pr review

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

Author: odubajDT

docs/non-normative/k8s-migration.md

@@ -85,6 +85,25 @@ The changes in their attributes are the following:
 
 <!-- prettier-ignore-end -->
 
+### K8s Node allocatable metrics
+
+The K8s node allocatable metrics implemented by the Collector and specifically the
+[k8scluster](https://github.com/open-telemetry/opentelemetry-collector-contrib/blob/v0.127.0/receiver/k8sclusterreceiver/documentation.md)
+receiver.
+
+The changes between collector implementation and semantic conventions:
+
+<!-- prettier-ignore-start -->
+
+| Old (Collector) ![changed](https://img.shields.io/badge/changed-orange?style=flat) | New                                                              |
+|------------------------------------------------------------------------------------|------------------------------------------------------------------|
+| `k8s.node.allocatable_cpu`                 (type: `gauge`)                         | `k8s.node.allocatable.cpu`               (type: `updowncounter`) |
+| `k8s.node.allocatable_memory`              (type: `gauge`)                         | `k8s.node.allocatable.memory`            (type: `updowncounter`) |
+| `k8s.node.allocatable_ephemeral_storage`   (type: `gauge`)                         | `k8s.node.allocatable.ephemeral_storage` (type: `updowncounter`) |
+| `k8s.node.allocatable_pods`                (type: `gauge`)                         | `k8s.node.allocatable.pods`              (type: `updowncounter`) |
+
+<!-- prettier-ignore-end -->
+
 ### K8s Deployment metrics
 
 The K8s Deployment metrics implemented by the Collector and specifically the

docs/system/k8s-metrics.md

@@ -371,7 +371,7 @@ This metric is [recommended][MetricRecommended].
 
 | Name     | Instrument Type | Unit (UCUM) | Description    | Stability | Entity Associations |
 | -------- | --------------- | ----------- | -------------- | --------- | ------ |
-| `k8s.node.allocatable.cpu` | UpDownCounter | `{cpu}` | Amount of cpu allocatable on the node | ![Development](https://img.shields.io/badge/-development-blue) |  |
+| `k8s.node.allocatable.cpu` | UpDownCounter | `{cpu}` | Amount of cpu allocatable on the node | ![Development](https://img.shields.io/badge/-development-blue) | `k8s.node` |
 
 <!-- markdownlint-restore -->
 <!-- prettier-ignore-end -->
@@ -391,7 +391,7 @@ This metric is [recommended][MetricRecommended].
 
 | Name     | Instrument Type | Unit (UCUM) | Description    | Stability | Entity Associations |
 | -------- | --------------- | ----------- | -------------- | --------- | ------ |
-| `k8s.node.allocatable.memory` | UpDownCounter | `By` | Amount of memory allocatable on the node | ![Development](https://img.shields.io/badge/-development-blue) |  |
+| `k8s.node.allocatable.memory` | UpDownCounter | `By` | Amount of memory allocatable on the node | ![Development](https://img.shields.io/badge/-development-blue) | `k8s.node` |
 
 <!-- markdownlint-restore -->
 <!-- prettier-ignore-end -->
@@ -411,7 +411,7 @@ This metric is [recommended][MetricRecommended].
 
 | Name     | Instrument Type | Unit (UCUM) | Description    | Stability | Entity Associations |
 | -------- | --------------- | ----------- | -------------- | --------- | ------ |
-| `k8s.node.allocatable.ephemeral_storage` | UpDownCounter | `By` | Amount of ephemeral-storage allocatable on the node | ![Development](https://img.shields.io/badge/-development-blue) |  |
+| `k8s.node.allocatable.ephemeral_storage` | UpDownCounter | `By` | Amount of ephemeral-storage allocatable on the node | ![Development](https://img.shields.io/badge/-development-blue) | `k8s.node` |
 
 <!-- markdownlint-restore -->
 <!-- prettier-ignore-end -->
@@ -431,7 +431,7 @@ This metric is [recommended][MetricRecommended].
 
 | Name     | Instrument Type | Unit (UCUM) | Description    | Stability | Entity Associations |
 | -------- | --------------- | ----------- | -------------- | --------- | ------ |
-| `k8s.node.allocatable.pods` | UpDownCounter | `{pod}` | Amount of pods allocatable on the node | ![Development](https://img.shields.io/badge/-development-blue) |  |
+| `k8s.node.allocatable.pods` | UpDownCounter | `{pod}` | Amount of pods allocatable on the node | ![Development](https://img.shields.io/badge/-development-blue) | `k8s.node` |
 
 <!-- markdownlint-restore -->
 <!-- prettier-ignore-end -->

model/k8s/metrics.yaml

@@ -107,27 +107,35 @@ groups:
     metric_name: k8s.node.allocatable.cpu
     stability: development
     brief: "Amount of cpu allocatable on the node"
+    entity_associations:
+      - k8s.node
     instrument: updowncounter
     unit: "{cpu}"
   - id: metric.k8s.node.allocatable.ephemeral_storage
     type: metric
     metric_name: k8s.node.allocatable.ephemeral_storage
     stability: development
     brief: "Amount of ephemeral-storage allocatable on the node"
+    entity_associations:
+      - k8s.node
     instrument: updowncounter
     unit: "By"
   - id: metric.k8s.node.allocatable.memory
     type: metric
     metric_name: k8s.node.allocatable.memory
     stability: development
     brief: "Amount of memory allocatable on the node"
+    entity_associations:
+      - k8s.node
     instrument: updowncounter
     unit: "By"
   - id: metric.k8s.node.allocatable.pods
     type: metric
     metric_name: k8s.node.allocatable.pods
     stability: development
     brief: "Amount of pods allocatable on the node"
+    entity_associations:
+      - k8s.node
     instrument: updowncounter
     unit: "{pod}"
   # k8s.node.cpu.* metrics