opentelemetry-semantic_conventions 1.43.0 → 1.45.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (67) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +8 -0
  3. data/lib/opentelemetry/semantic_conventions/version.rb +2 -2
  4. data/lib/opentelemetry/semconv/client/attributes.rb +3 -3
  5. data/lib/opentelemetry/semconv/code/attributes.rb +1 -1
  6. data/lib/opentelemetry/semconv/container/attributes.rb +1 -1
  7. data/lib/opentelemetry/semconv/db/attributes.rb +16 -11
  8. data/lib/opentelemetry/semconv/incubating/android/attributes.rb +1 -1
  9. data/lib/opentelemetry/semconv/incubating/app/attributes.rb +1 -1
  10. data/lib/opentelemetry/semconv/incubating/artifact/attributes.rb +3 -3
  11. data/lib/opentelemetry/semconv/incubating/aws/attributes.rb +1 -1
  12. data/lib/opentelemetry/semconv/incubating/azure/attributes.rb +20 -0
  13. data/lib/opentelemetry/semconv/incubating/browser/attributes.rb +30 -0
  14. data/lib/opentelemetry/semconv/incubating/client/attributes.rb +73 -3
  15. data/lib/opentelemetry/semconv/incubating/cloudfoundry/attributes.rb +1 -1
  16. data/lib/opentelemetry/semconv/incubating/code/attributes.rb +1 -1
  17. data/lib/opentelemetry/semconv/incubating/container/attributes.rb +3 -3
  18. data/lib/opentelemetry/semconv/incubating/container/metrics.rb +40 -34
  19. data/lib/opentelemetry/semconv/incubating/cpu/attributes.rb +4 -2
  20. data/lib/opentelemetry/semconv/incubating/db/attributes.rb +24 -14
  21. data/lib/opentelemetry/semconv/incubating/db/metrics.rb +8 -2
  22. data/lib/opentelemetry/semconv/incubating/deployment/attributes.rb +1 -1
  23. data/lib/opentelemetry/semconv/incubating/destination/attributes.rb +53 -2
  24. data/lib/opentelemetry/semconv/incubating/enduser/attributes.rb +2 -0
  25. data/lib/opentelemetry/semconv/incubating/faas/attributes.rb +7 -3
  26. data/lib/opentelemetry/semconv/incubating/file/attributes.rb +3 -3
  27. data/lib/opentelemetry/semconv/incubating/gcp/attributes.rb +20 -0
  28. data/lib/opentelemetry/semconv/incubating/host/attributes.rb +61 -2
  29. data/lib/opentelemetry/semconv/incubating/http/attributes.rb +59 -0
  30. data/lib/opentelemetry/semconv/incubating/jvm/attributes.rb +24 -0
  31. data/lib/opentelemetry/semconv/incubating/jvm/metrics.rb +45 -2
  32. data/lib/opentelemetry/semconv/incubating/k8s/metrics.rb +315 -73
  33. data/lib/opentelemetry/semconv/incubating/kafka/attributes.rb +55 -0
  34. data/lib/opentelemetry/semconv/incubating/kafka.rb +21 -0
  35. data/lib/opentelemetry/semconv/incubating/log/attributes.rb +7 -7
  36. data/lib/opentelemetry/semconv/incubating/mcp/attributes.rb +1 -1
  37. data/lib/opentelemetry/semconv/incubating/messaging/attributes.rb +78 -29
  38. data/lib/opentelemetry/semconv/incubating/network/attributes.rb +107 -5
  39. data/lib/opentelemetry/semconv/incubating/opentracing/attributes.rb +1 -0
  40. data/lib/opentelemetry/semconv/incubating/oracle/attributes.rb +1 -1
  41. data/lib/opentelemetry/semconv/incubating/otel/metrics.rb +25 -8
  42. data/lib/opentelemetry/semconv/incubating/peer/attributes.rb +1 -1
  43. data/lib/opentelemetry/semconv/incubating/pprof/attributes.rb +2 -2
  44. data/lib/opentelemetry/semconv/incubating/process/metrics.rb +16 -1
  45. data/lib/opentelemetry/semconv/incubating/rabbitmq/attributes.rb +41 -0
  46. data/lib/opentelemetry/semconv/incubating/rabbitmq.rb +21 -0
  47. data/lib/opentelemetry/semconv/incubating/rocketmq/attributes.rb +71 -0
  48. data/lib/opentelemetry/semconv/incubating/rocketmq.rb +21 -0
  49. data/lib/opentelemetry/semconv/incubating/rpc/attributes.rb +111 -36
  50. data/lib/opentelemetry/semconv/incubating/rpc/metrics.rb +6 -2
  51. data/lib/opentelemetry/semconv/incubating/server/attributes.rb +71 -1
  52. data/lib/opentelemetry/semconv/incubating/service/attributes.rb +16 -0
  53. data/lib/opentelemetry/semconv/incubating/session/attributes.rb +1 -1
  54. data/lib/opentelemetry/semconv/incubating/source/attributes.rb +53 -2
  55. data/lib/opentelemetry/semconv/incubating/system/attributes.rb +15 -9
  56. data/lib/opentelemetry/semconv/incubating/system/metrics.rb +18 -5
  57. data/lib/opentelemetry/semconv/incubating/url/attributes.rb +15 -3
  58. data/lib/opentelemetry/semconv/incubating/v8js/attributes.rb +2 -1
  59. data/lib/opentelemetry/semconv/incubating/zos/attributes.rb +4 -2
  60. data/lib/opentelemetry/semconv/network/attributes.rb +2 -2
  61. data/lib/opentelemetry/semconv/rpc/attributes.rb +77 -0
  62. data/lib/opentelemetry/semconv/rpc/metrics.rb +45 -0
  63. data/lib/opentelemetry/semconv/rpc.rb +22 -0
  64. data/lib/opentelemetry/semconv/server/attributes.rb +1 -1
  65. data/lib/opentelemetry/semconv/url/attributes.rb +12 -0
  66. data/lib/opentelemetry/semconv.rb +4 -0
  67. metadata +14 -5
@@ -94,22 +94,23 @@ module OpenTelemetry
94
94
  #
95
95
  # The current CPU request reflects the request applied to the running container, as reported by
96
96
  # [ContainerStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.34/#containerstatus-v1-core).
97
- # The value range is [0.0,1.0]. A value of 1.0 means the container is using 100% of its actual CPU request.
98
- # If the CPU request is not set, this metric SHOULD NOT be emitted for that container.
97
+ # A value of 1.0 means the container is using exactly its CPU request. Since a CPU request is a scheduling
98
+ # reservation and not a hard cap, values above 1.0 are possible and indicate the container is using more CPU
99
+ # than requested. If the CPU request is not set, this metric SHOULD NOT be emitted for that container.
99
100
  #
100
101
  # @note Stability Level: development
101
102
  K8S_CONTAINER_CPU_REQUEST_UTILIZATION = 'k8s.container.cpu.request.utilization'
102
103
 
103
104
  # Maximum ephemeral storage resource limit set for the container.
104
105
  #
105
- # See https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.34/#resourcerequirements-v1-core for details.
106
+ # See the [Kubernetes ResourceRequirements API](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.34/#resourcerequirements-v1-core) for details.
106
107
  #
107
108
  # @note Stability Level: development
108
109
  K8S_CONTAINER_EPHEMERAL_STORAGE_LIMIT = 'k8s.container.ephemeral_storage.limit'
109
110
 
110
111
  # Ephemeral storage resource requested for the container.
111
112
  #
112
- # See https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.34/#resourcerequirements-v1-core for details.
113
+ # See the [Kubernetes ResourceRequirements API](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.34/#resourcerequirements-v1-core) for details.
113
114
  #
114
115
  # @note Stability Level: development
115
116
  K8S_CONTAINER_EPHEMERAL_STORAGE_REQUEST = 'k8s.container.ephemeral_storage.request'
@@ -149,6 +150,17 @@ module OpenTelemetry
149
150
  # @note Stability Level: development
150
151
  K8S_CONTAINER_MEMORY_LIMIT_DESIRED = 'k8s.container.memory.limit.desired'
151
152
 
153
+ # The ratio of container memory working set to its current memory limit.
154
+ #
155
+ # The numerator is the container memory working set, as reported by `container.memory.working_set`. The current memory limit
156
+ # reflects the actual resources applied to the container, as reported by
157
+ # [ContainerStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.34/#containerstatus-v1-core).
158
+ # A value of 1.0 means the container is using 100% of its actual memory limit. Values above 1.0 can occur transiently, since memory usage can briefly exceed the limit.
159
+ # If the memory limit is not set, this metric SHOULD NOT be emitted for that container.
160
+ #
161
+ # @note Stability Level: development
162
+ K8S_CONTAINER_MEMORY_LIMIT_UTILIZATION = 'k8s.container.memory.limit.utilization'
163
+
152
164
  # Deprecated, use `k8s.container.memory.request.desired` and `k8s.container.memory.request.current` instead.
153
165
  #
154
166
  # @note Stability Level: development
@@ -177,6 +189,19 @@ module OpenTelemetry
177
189
  # @note Stability Level: development
178
190
  K8S_CONTAINER_MEMORY_REQUEST_DESIRED = 'k8s.container.memory.request.desired'
179
191
 
192
+ # The ratio of container memory working set to its current memory request.
193
+ #
194
+ # The numerator is the container memory working set, as reported by `container.memory.working_set`. The current memory request
195
+ # reflects the request applied to the running container, as reported by
196
+ # [ContainerStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.34/#containerstatus-v1-core).
197
+ # A value of 1.0 means the container is using exactly its memory request. Since a memory request is a
198
+ # scheduling reservation and not a hard cap, values above 1.0 are possible and indicate the container is
199
+ # using more memory than requested. If the memory request is not set, this metric SHOULD NOT be emitted for
200
+ # that container.
201
+ #
202
+ # @note Stability Level: development
203
+ K8S_CONTAINER_MEMORY_REQUEST_UTILIZATION = 'k8s.container.memory.request.utilization'
204
+
180
205
  # Indicates whether the container is currently marked as ready to accept traffic, based on its readiness probe (1 = ready, 0 = not ready).
181
206
  #
182
207
  # This metric SHOULD reflect the value of the `ready` field in the
@@ -214,14 +239,14 @@ module OpenTelemetry
214
239
 
215
240
  # Maximum storage resource limit set for the container.
216
241
  #
217
- # See https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.34/#resourcerequirements-v1-core for details.
242
+ # See the [Kubernetes ResourceRequirements API](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.34/#resourcerequirements-v1-core) for details.
218
243
  #
219
244
  # @note Stability Level: development
220
245
  K8S_CONTAINER_STORAGE_LIMIT = 'k8s.container.storage.limit'
221
246
 
222
247
  # Storage resource requested for the container.
223
248
  #
224
- # See https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.34/#resourcerequirements-v1-core for details.
249
+ # See the [Kubernetes ResourceRequirements API](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.34/#resourcerequirements-v1-core) for details.
225
250
  #
226
251
  # @note Stability Level: development
227
252
  K8S_CONTAINER_STORAGE_REQUEST = 'k8s.container.storage.request'
@@ -564,7 +589,7 @@ module OpenTelemetry
564
589
  # @note Stability Level: development
565
590
  K8S_NODE_CONDITION_STATUS = 'k8s.node.condition.status'
566
591
 
567
- # Amount of cpu allocatable on the node.
592
+ # Amount of CPU allocatable on the node.
568
593
  #
569
594
  # @note Stability Level: development
570
595
  K8S_NODE_CPU_ALLOCATABLE = 'k8s.node.cpu.allocatable'
@@ -576,11 +601,11 @@ module OpenTelemetry
576
601
  # @note Stability Level: release_candidate
577
602
  K8S_NODE_CPU_TIME = 'k8s.node.cpu.time'
578
603
 
579
- # Node's CPU usage, measured in cpus. Range from 0 to the number of allocatable CPUs.
604
+ # Node's CPU usage, measured in CPUs. Range from 0 to the number of allocatable CPUs.
580
605
  #
581
- # CPU usage of the specific Node on all available CPU cores, averaged over the sample window
606
+ # CPU usage of the specific Node on all available CPU cores. It is calculated as the change in cumulative CPU time (k8s.node.cpu.time) over a measurement interval, divided by the elapsed time: usageCores = (cpuTimeEnd - cpuTimeStart) / elapsedSeconds
582
607
  #
583
- # @note Stability Level: development
608
+ # @note Stability Level: release_candidate
584
609
  K8S_NODE_CPU_USAGE = 'k8s.node.cpu.usage'
585
610
 
586
611
  # Amount of ephemeral-storage allocatable on the node.
@@ -591,33 +616,55 @@ module OpenTelemetry
591
616
  # Node filesystem available bytes.
592
617
  #
593
618
  # This metric is derived from the
594
- # [FsStats.AvailableBytes](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#FsStats) field
595
- # of the [NodeStats.Fs](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#NodeStats)
619
+ # [FsStats.AvailableBytes](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#FsStats) field
620
+ # of the [NodeStats.Fs](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#NodeStats)
596
621
  # of the Kubelet's stats API.
597
622
  #
598
- # @note Stability Level: development
623
+ # @note Stability Level: release_candidate
599
624
  K8S_NODE_FILESYSTEM_AVAILABLE = 'k8s.node.filesystem.available'
600
625
 
601
626
  # Node filesystem capacity.
602
627
  #
603
628
  # This metric is derived from the
604
- # [FsStats.CapacityBytes](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#FsStats) field
605
- # of the [NodeStats.Fs](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#NodeStats)
629
+ # [FsStats.CapacityBytes](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#FsStats) field
630
+ # of the [NodeStats.Fs](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#NodeStats)
606
631
  # of the Kubelet's stats API.
607
632
  #
608
- # @note Stability Level: development
633
+ # @note Stability Level: release_candidate
609
634
  K8S_NODE_FILESYSTEM_CAPACITY = 'k8s.node.filesystem.capacity'
610
635
 
611
- # Node filesystem usage.
636
+ # The total inodes in the node's root filesystem.
612
637
  #
613
- # This may not equal capacity - available.
638
+ # This metric is derived from the
639
+ # [FsStats.Inodes](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#FsStats) field
640
+ # of the [NodeStats.Fs](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#NodeStats)
641
+ # of the Kubelet's stats API.
642
+ #
643
+ # @note Stability Level: release_candidate
644
+ K8S_NODE_FILESYSTEM_INODE_COUNT = 'k8s.node.filesystem.inode.count'
645
+
646
+ # The free inodes in the node's root filesystem.
614
647
  #
615
648
  # This metric is derived from the
616
- # [FsStats.UsedBytes](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#FsStats) field
617
- # of the [NodeStats.Fs](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#NodeStats)
649
+ # [FsStats.InodesFree](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#FsStats) field
650
+ # of the [NodeStats.Fs](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#NodeStats)
618
651
  # of the Kubelet's stats API.
619
652
  #
620
- # @note Stability Level: development
653
+ # @note Stability Level: release_candidate
654
+ K8S_NODE_FILESYSTEM_INODE_FREE = 'k8s.node.filesystem.inode.free'
655
+
656
+ # Node filesystem usage.
657
+ #
658
+ # This metric is derived from the
659
+ # [FsStats.UsedBytes](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#FsStats) field
660
+ # of the [NodeStats.Fs](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#NodeStats)
661
+ # of the Kubelet's stats API.
662
+ #
663
+ # Capacity and available are reported for the backing filesystem,
664
+ # which may be shared with other workloads; therefore,
665
+ # usage may not equal `capacity - available`.
666
+ #
667
+ # @note Stability Level: release_candidate
621
668
  K8S_NODE_FILESYSTEM_USAGE = 'k8s.node.filesystem.usage'
622
669
 
623
670
  # Amount of memory allocatable on the node.
@@ -630,15 +677,16 @@ module OpenTelemetry
630
677
  # Available memory for use. This is defined as the memory limit - workingSetBytes. If memory limit is undefined, the available bytes is omitted.
631
678
  # This metric is derived from the [MemoryStats.AvailableBytes](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#MemoryStats) field of the [NodeStats.Memory](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#NodeStats) of the Kubelet's stats API.
632
679
  #
633
- # @note Stability Level: development
680
+ # @note Stability Level: release_candidate
634
681
  K8S_NODE_MEMORY_AVAILABLE = 'k8s.node.memory.available'
635
682
 
636
- # Node memory paging faults.
683
+ # Deprecated, use `k8s.node.paging.faults` instead.
637
684
  #
638
685
  # Cumulative number of major/minor page faults.
639
686
  # This metric is derived from the [MemoryStats.PageFaults](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#MemoryStats) and [MemoryStats.MajorPageFaults](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#MemoryStats) fields of the [NodeStats.Memory](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#NodeStats) of the Kubelet's stats API.
640
687
  #
641
688
  # @note Stability Level: development
689
+ # @deprecated Replaced by `k8s.node.paging.faults`.
642
690
  K8S_NODE_MEMORY_PAGING_FAULTS = 'k8s.node.memory.paging.faults'
643
691
 
644
692
  # Node memory RSS.
@@ -646,34 +694,64 @@ module OpenTelemetry
646
694
  # The amount of anonymous and swap cache memory (includes transparent hugepages).
647
695
  # This metric is derived from the [MemoryStats.RSSBytes](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#MemoryStats) field of the [NodeStats.Memory](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#NodeStats) of the Kubelet's stats API.
648
696
  #
649
- # @note Stability Level: development
697
+ # @note Stability Level: release_candidate
650
698
  K8S_NODE_MEMORY_RSS = 'k8s.node.memory.rss'
651
699
 
652
700
  # Memory usage of the Node.
653
701
  #
654
- # Total memory usage of the Node
702
+ # Total memory in use. This includes all memory regardless of when it was accessed.
703
+ # This metric is derived from the [MemoryStats.UsageBytes](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#MemoryStats) field of the [NodeStats.Memory](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#NodeStats) of the Kubelet's stats API.
655
704
  #
656
- # @note Stability Level: development
705
+ # @note Stability Level: release_candidate
657
706
  K8S_NODE_MEMORY_USAGE = 'k8s.node.memory.usage'
658
707
 
659
708
  # Node memory working set.
660
709
  #
661
- # The amount of working set memory. This includes recently accessed memory, dirty memory, and kernel memory. WorkingSetBytes is <= UsageBytes.
710
+ # The amount of working set memory. This includes recently accessed memory, dirty memory, and kernel memory. On Linux, the working set is calculated by excluding inactive file-backed memory from memory usage (`inactive_file` on cgroup v2, `total_inactive_file` on cgroup v1), so active file-backed memory remains included. On Linux, the kubelet uses the node working set when determining memory availability for the `memory.available` eviction signal. `WorkingSetBytes` is less than or equal to `UsageBytes`.
662
711
  # This metric is derived from the [MemoryStats.WorkingSetBytes](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#MemoryStats) field of the [NodeStats.Memory](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#NodeStats) of the Kubelet's stats API.
663
712
  #
664
- # @note Stability Level: development
713
+ # @note Stability Level: release_candidate
665
714
  K8S_NODE_MEMORY_WORKING_SET = 'k8s.node.memory.working_set'
666
715
 
667
716
  # Node network errors.
668
717
  #
669
- # @note Stability Level: development
718
+ # @note Stability Level: release_candidate
670
719
  K8S_NODE_NETWORK_ERRORS = 'k8s.node.network.errors'
671
720
 
672
721
  # Network bytes for the Node.
673
722
  #
674
- # @note Stability Level: development
723
+ # @note Stability Level: release_candidate
675
724
  K8S_NODE_NETWORK_IO = 'k8s.node.network.io'
676
725
 
726
+ # Node memory paging faults.
727
+ #
728
+ # Cumulative number of major and minor page faults.
729
+ # The [MemoryStats.MajorPageFaults](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#MemoryStats) field of the [NodeStats.Memory](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#NodeStats) of the Kubelet's stats API maps directly to `system.paging.fault.type=major`.
730
+ # The [MemoryStats.PageFaults](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#MemoryStats) field reports the total number of page faults (equivalent to `pgfault` in the cgroup `memory.stat`), with minor and major combined. The minor page faults MUST therefore be derived as `MemoryStats.PageFaults - MemoryStats.MajorPageFaults`, so that summing the metric over `system.paging.fault.type` yields the total number of page faults.
731
+ #
732
+ # @note Stability Level: release_candidate
733
+ K8S_NODE_PAGING_FAULTS = 'k8s.node.paging.faults'
734
+
735
+ # Total number of processes/threads allowed by the operating system on the node.
736
+ #
737
+ # Derived from the Kubelet Summary API
738
+ # ([RlimitStats.MaxPID](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#RlimitStats))
739
+ # field of the [NodeStats.Rlimit](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#NodeStats),
740
+ # representing the system-wide task limit (the lower of `kernel.pid_max` and `kernel.threads-max`).
741
+ #
742
+ # @note Stability Level: development
743
+ K8S_NODE_PID_LIMIT = 'k8s.node.pid.limit'
744
+
745
+ # Total number of existing processes and threads on the node.
746
+ #
747
+ # Derived from the Kubelet Summary API
748
+ # ([RlimitStats.NumOfRunningProcesses](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#RlimitStats))
749
+ # field of the [NodeStats.Rlimit](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#NodeStats),
750
+ # which reads the total count of scheduling entities (threads/processes across all states) from `/proc/loadavg`.
751
+ #
752
+ # @note Stability Level: development
753
+ K8S_NODE_PID_USAGE = 'k8s.node.pid.usage'
754
+
677
755
  # Amount of pods allocatable on the node.
678
756
  #
679
757
  # @note Stability Level: development
@@ -686,9 +764,9 @@ module OpenTelemetry
686
764
  # @note Stability Level: development
687
765
  K8S_NODE_SYSTEM_CONTAINER_CPU_TIME = 'k8s.node.system_container.cpu.time'
688
766
 
689
- # Node's system container CPU usage, measured in cpus.
767
+ # Node's system container CPU usage, measured in CPUs.
690
768
  #
691
- # This metric is derived from the [CPUStats.UsageNanoCores](https://github.com/kubernetes/kubelet/blob/v0.35.2/pkg/apis/stats/v1alpha1/types.go#L233) field of the [ContainerStats](https://github.com/kubernetes/kubelet/blob/v0.35.2/pkg/apis/stats/v1alpha1/types.go#L157C6-L157C20) of [Node.SystemContainers](https://github.com/kubernetes/kubelet/blob/v0.35.2/pkg/apis/stats/v1alpha1/types.go#L40) of the Kubelet's stats API.
769
+ # CPU usage of the specific System Container on all available CPU cores. It is calculated as the change in cumulative CPU time (k8s.node.system_container.cpu.time) over a measurement interval, divided by the elapsed time: usageCores = (cpuTimeEnd - cpuTimeStart) / elapsedSeconds
692
770
  #
693
771
  # @note Stability Level: development
694
772
  K8S_NODE_SYSTEM_CONTAINER_CPU_USAGE = 'k8s.node.system_container.cpu.usage'
@@ -709,10 +787,10 @@ module OpenTelemetry
709
787
 
710
788
  # The time the Node has been running.
711
789
  #
712
- # Instrumentations SHOULD use a gauge with type `double` and measure uptime in seconds as a floating point number with the highest precision available.
713
- # The actual accuracy would depend on the instrumentation and operating system.
790
+ # Instrumentations SHOULD use a gauge with type `double` and measure uptime in seconds as a floating point number with the highest precision available. The actual accuracy would depend on the instrumentation and operating system.
791
+ # This metric is derived from the [NodeStats.StartTime](https://github.com/kubernetes/kubelet/blob/v0.35.2/pkg/apis/stats/v1alpha1/types.go#L42) field of Kubelet's stats API, which is set to the [system boot time](https://github.com/kubernetes/kubernetes/blob/v1.36.3/pkg/kubelet/server/stats/summary.go#L113). This value resets when the node reboots.
714
792
  #
715
- # @note Stability Level: development
793
+ # @note Stability Level: release_candidate
716
794
  K8S_NODE_UPTIME = 'k8s.node.uptime'
717
795
 
718
796
  # Number of PersistentVolumes in a given phase.
@@ -756,6 +834,77 @@ module OpenTelemetry
756
834
  # @note Stability Level: development
757
835
  K8S_PERSISTENTVOLUMECLAIM_STORAGE_REQUEST = 'k8s.persistentvolumeclaim.storage.request'
758
836
 
837
+ # Maximum CPU resource limit currently configured for a running Pod.
838
+ #
839
+ # This metric aligns with the limit in the
840
+ # [`resources`](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.35/#resourcerequirements-v1-core) field of
841
+ # [K8s PodStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.35/#podstatus-v1-core)
842
+ # (status.resources). Also see `Actual Resources` in
843
+ # [https://kubernetes.io/docs/tasks/configure-pod-container/resize-container-resources/](https://kubernetes.io/docs/tasks/configure-pod-container/resize-container-resources/) for more details.
844
+ #
845
+ # @note Stability Level: development
846
+ K8S_POD_CPU_LIMIT_CURRENT = 'k8s.pod.cpu.limit.current'
847
+
848
+ # Maximum CPU resource limit as defined by the Pod spec.
849
+ #
850
+ # This metric aligns with the limit in the
851
+ # [`resources`](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.35/#resourcerequirements-v1-core) field of
852
+ # [K8s PodSpec](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.35/#podspec-v1-core)
853
+ # (spec.resources). See
854
+ # [https://kubernetes.io/docs/tasks/configure-pod-container/assign-pod-level-resources/](https://kubernetes.io/docs/tasks/configure-pod-container/assign-pod-level-resources/)
855
+ # for more details on Pod level resources. Note that Kubernetes can default unset Pod level limits
856
+ # based on the aggregated limits of the Pod's containers. Also see `Desired Resources` in
857
+ # [https://kubernetes.io/docs/tasks/configure-pod-container/resize-container-resources/](https://kubernetes.io/docs/tasks/configure-pod-container/resize-container-resources/).
858
+ #
859
+ # @note Stability Level: development
860
+ K8S_POD_CPU_LIMIT_DESIRED = 'k8s.pod.cpu.limit.desired'
861
+
862
+ # The ratio of Pod CPU usage to its current CPU limit.
863
+ #
864
+ # The current CPU limit reflects the actual resources applied at the Pod level, as reported by
865
+ # [PodStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.35/#podstatus-v1-core).
866
+ # The value range is [0.0,1.0]. A value of 1.0 means the Pod is using 100% of its actual CPU limit.
867
+ # If the CPU limit is not set, this metric SHOULD NOT be emitted for that Pod.
868
+ #
869
+ # @note Stability Level: development
870
+ K8S_POD_CPU_LIMIT_UTILIZATION = 'k8s.pod.cpu.limit.utilization'
871
+
872
+ # CPU resource requested currently configured for a running Pod.
873
+ #
874
+ # This metric aligns with the request in the
875
+ # [`resources`](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.35/#resourcerequirements-v1-core) field of
876
+ # [K8s PodStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.35/#podstatus-v1-core)
877
+ # (status.resources). Also see `Actual Resources` in
878
+ # [https://kubernetes.io/docs/tasks/configure-pod-container/resize-container-resources/](https://kubernetes.io/docs/tasks/configure-pod-container/resize-container-resources/) for more details.
879
+ #
880
+ # @note Stability Level: development
881
+ K8S_POD_CPU_REQUEST_CURRENT = 'k8s.pod.cpu.request.current'
882
+
883
+ # CPU resource requested as defined by the Pod spec.
884
+ #
885
+ # This metric aligns with the request in the
886
+ # [`resources`](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.35/#resourcerequirements-v1-core) field of
887
+ # [K8s PodSpec](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.35/#podspec-v1-core)
888
+ # (spec.resources). See
889
+ # [https://kubernetes.io/docs/tasks/configure-pod-container/assign-pod-level-resources/](https://kubernetes.io/docs/tasks/configure-pod-container/assign-pod-level-resources/)
890
+ # for more details on Pod level resources. Note that Kubernetes can default unset Pod level requests
891
+ # based on the aggregated requests of the Pod's containers. Also see `Desired Resources` in
892
+ # [https://kubernetes.io/docs/tasks/configure-pod-container/resize-container-resources/](https://kubernetes.io/docs/tasks/configure-pod-container/resize-container-resources/).
893
+ #
894
+ # @note Stability Level: development
895
+ K8S_POD_CPU_REQUEST_DESIRED = 'k8s.pod.cpu.request.desired'
896
+
897
+ # The ratio of Pod CPU usage to its current CPU request.
898
+ #
899
+ # The current CPU request reflects the request applied at the Pod level, as reported by
900
+ # [PodStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.35/#podstatus-v1-core).
901
+ # A value of 1.0 means the Pod is using exactly its CPU request. Since a CPU request is a scheduling
902
+ # reservation and not a hard cap, values above 1.0 are possible and indicate the Pod is using more CPU
903
+ # than requested. If the CPU request is not set, this metric SHOULD NOT be emitted for that Pod.
904
+ #
905
+ # @note Stability Level: development
906
+ K8S_POD_CPU_REQUEST_UTILIZATION = 'k8s.pod.cpu.request.utilization'
907
+
759
908
  # Total CPU time consumed.
760
909
  #
761
910
  # Total CPU time consumed by the specific Pod on all available CPU cores
@@ -763,43 +912,44 @@ module OpenTelemetry
763
912
  # @note Stability Level: release_candidate
764
913
  K8S_POD_CPU_TIME = 'k8s.pod.cpu.time'
765
914
 
766
- # Pod's CPU usage, measured in cpus. Range from 0 to the number of allocatable CPUs.
915
+ # Pod's CPU usage, measured in CPUs. Range from 0 to the number of allocatable CPUs.
767
916
  #
768
- # CPU usage of the specific Pod on all available CPU cores, averaged over the sample window
917
+ # CPU usage of the specific Pod on all available CPU cores. It is calculated as the change in cumulative CPU time (k8s.pod.cpu.time) over a measurement interval, divided by the elapsed time: usageCores = (cpuTimeEnd - cpuTimeStart) / elapsedSeconds
769
918
  #
770
- # @note Stability Level: development
919
+ # @note Stability Level: release_candidate
771
920
  K8S_POD_CPU_USAGE = 'k8s.pod.cpu.usage'
772
921
 
773
922
  # Pod filesystem available bytes.
774
923
  #
775
924
  # This metric is derived from the
776
- # [FsStats.AvailableBytes](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#FsStats) field
777
- # of the [PodStats.EphemeralStorage](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#PodStats)
925
+ # [FsStats.AvailableBytes](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#FsStats) field
926
+ # of the [PodStats.EphemeralStorage](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#PodStats)
778
927
  # of the Kubelet's stats API.
779
928
  #
780
- # @note Stability Level: development
929
+ # @note Stability Level: release_candidate
781
930
  K8S_POD_FILESYSTEM_AVAILABLE = 'k8s.pod.filesystem.available'
782
931
 
783
932
  # Pod filesystem capacity.
784
933
  #
785
934
  # This metric is derived from the
786
- # [FsStats.CapacityBytes](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#FsStats) field
787
- # of the [PodStats.EphemeralStorage](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#PodStats)
935
+ # [FsStats.CapacityBytes](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#FsStats) field
936
+ # of the [PodStats.EphemeralStorage](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#PodStats)
788
937
  # of the Kubelet's stats API.
789
938
  #
790
- # @note Stability Level: development
939
+ # @note Stability Level: release_candidate
791
940
  K8S_POD_FILESYSTEM_CAPACITY = 'k8s.pod.filesystem.capacity'
792
941
 
793
942
  # Pod filesystem usage.
794
943
  #
795
- # This may not equal capacity - available.
796
- #
797
944
  # This metric is derived from the
798
- # [FsStats.UsedBytes](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#FsStats) field
799
- # of the [PodStats.EphemeralStorage](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#PodStats)
945
+ # [FsStats.UsedBytes](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#FsStats) field
946
+ # of the [PodStats.EphemeralStorage](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#PodStats)
800
947
  # of the Kubelet's stats API.
801
948
  #
802
- # @note Stability Level: development
949
+ # Capacity and available are reported for the backing filesystem, which may be shared
950
+ # with other workloads; therefore, usage may not equal `capacity - available`.
951
+ #
952
+ # @note Stability Level: release_candidate
803
953
  K8S_POD_FILESYSTEM_USAGE = 'k8s.pod.filesystem.usage'
804
954
 
805
955
  # Pod memory available.
@@ -807,50 +957,134 @@ module OpenTelemetry
807
957
  # Available memory for use. This is defined as the memory limit - workingSetBytes. If memory limit is undefined, the available bytes is omitted.
808
958
  # This metric is derived from the [MemoryStats.AvailableBytes](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#MemoryStats) field of the [PodStats.Memory](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#PodStats) of the Kubelet's stats API.
809
959
  #
810
- # @note Stability Level: development
960
+ # @note Stability Level: release_candidate
811
961
  K8S_POD_MEMORY_AVAILABLE = 'k8s.pod.memory.available'
812
962
 
813
- # Pod memory paging faults.
963
+ # Maximum memory resource limit currently configured for a running Pod.
964
+ #
965
+ # This metric aligns with the limit in the
966
+ # [`resources`](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.35/#resourcerequirements-v1-core) field of
967
+ # [K8s PodStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.35/#podstatus-v1-core)
968
+ # (status.resources). Also see `Actual Resources` in
969
+ # [https://kubernetes.io/docs/tasks/configure-pod-container/resize-container-resources/](https://kubernetes.io/docs/tasks/configure-pod-container/resize-container-resources/) for more details.
970
+ #
971
+ # @note Stability Level: development
972
+ K8S_POD_MEMORY_LIMIT_CURRENT = 'k8s.pod.memory.limit.current'
973
+
974
+ # Maximum memory resource limit as defined by the Pod spec.
975
+ #
976
+ # This metric aligns with the limit in the
977
+ # [`resources`](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.35/#resourcerequirements-v1-core) field of
978
+ # [K8s PodSpec](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.35/#podspec-v1-core)
979
+ # (spec.resources). See
980
+ # [https://kubernetes.io/docs/tasks/configure-pod-container/assign-pod-level-resources/](https://kubernetes.io/docs/tasks/configure-pod-container/assign-pod-level-resources/)
981
+ # for more details on Pod level resources. Note that Kubernetes can default unset Pod level limits
982
+ # based on the aggregated limits of the Pod's containers. Also see `Desired Resources` in
983
+ # [https://kubernetes.io/docs/tasks/configure-pod-container/resize-container-resources/](https://kubernetes.io/docs/tasks/configure-pod-container/resize-container-resources/).
984
+ #
985
+ # @note Stability Level: development
986
+ K8S_POD_MEMORY_LIMIT_DESIRED = 'k8s.pod.memory.limit.desired'
987
+
988
+ # The ratio of Pod memory working set to its current memory limit.
989
+ #
990
+ # The numerator is the Pod memory working set, as reported by `k8s.pod.memory.working_set`. The current memory limit
991
+ # reflects the actual resources applied at the Pod level, as reported by
992
+ # [PodStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.35/#podstatus-v1-core).
993
+ # A value of 1.0 means the Pod is using 100% of its actual memory limit. Values above 1.0 can occur transiently, since memory usage can briefly exceed the limit.
994
+ # If the memory limit is not set, this metric SHOULD NOT be emitted for that Pod.
995
+ #
996
+ # @note Stability Level: development
997
+ K8S_POD_MEMORY_LIMIT_UTILIZATION = 'k8s.pod.memory.limit.utilization'
998
+
999
+ # Deprecated, use `k8s.pod.paging.faults` instead.
814
1000
  #
815
1001
  # Cumulative number of major/minor page faults.
816
1002
  # This metric is derived from the [MemoryStats.PageFaults](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#MemoryStats) and [MemoryStats.MajorPageFaults](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#MemoryStats) field of the [PodStats.Memory](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#PodStats) of the Kubelet's stats API.
817
1003
  #
818
1004
  # @note Stability Level: development
1005
+ # @deprecated Replaced by `k8s.pod.paging.faults`.
819
1006
  K8S_POD_MEMORY_PAGING_FAULTS = 'k8s.pod.memory.paging.faults'
820
1007
 
1008
+ # Memory resource request currently configured for a running Pod.
1009
+ #
1010
+ # This metric aligns with the request in the
1011
+ # [`resources`](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.35/#resourcerequirements-v1-core) field of
1012
+ # [K8s PodStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.35/#podstatus-v1-core)
1013
+ # (status.resources). Also see `Actual Resources` in
1014
+ # [https://kubernetes.io/docs/tasks/configure-pod-container/resize-container-resources/](https://kubernetes.io/docs/tasks/configure-pod-container/resize-container-resources/) for more details.
1015
+ #
1016
+ # @note Stability Level: development
1017
+ K8S_POD_MEMORY_REQUEST_CURRENT = 'k8s.pod.memory.request.current'
1018
+
1019
+ # Memory resource requested as defined by the Pod spec.
1020
+ #
1021
+ # This metric aligns with the request in the
1022
+ # [`resources`](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.35/#resourcerequirements-v1-core) field of
1023
+ # [K8s PodSpec](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.35/#podspec-v1-core)
1024
+ # (spec.resources). See
1025
+ # [https://kubernetes.io/docs/tasks/configure-pod-container/assign-pod-level-resources/](https://kubernetes.io/docs/tasks/configure-pod-container/assign-pod-level-resources/)
1026
+ # for more details on Pod level resources. Note that Kubernetes can default unset Pod level requests
1027
+ # based on the aggregated requests of the Pod's containers. Also see `Desired Resources` in
1028
+ # [https://kubernetes.io/docs/tasks/configure-pod-container/resize-container-resources/](https://kubernetes.io/docs/tasks/configure-pod-container/resize-container-resources/).
1029
+ #
1030
+ # @note Stability Level: development
1031
+ K8S_POD_MEMORY_REQUEST_DESIRED = 'k8s.pod.memory.request.desired'
1032
+
1033
+ # The ratio of Pod memory working set to its current memory request.
1034
+ #
1035
+ # The numerator is the Pod memory working set, as reported by `k8s.pod.memory.working_set`. The current memory request
1036
+ # reflects the request applied at the Pod level, as reported by
1037
+ # [PodStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.35/#podstatus-v1-core).
1038
+ # A value of 1.0 means the Pod is using exactly its memory request. Since a memory request is a
1039
+ # scheduling reservation and not a hard cap, values above 1.0 are possible and indicate the Pod is using
1040
+ # more memory than requested. If the memory request is not set, this metric SHOULD NOT be emitted for that Pod.
1041
+ #
1042
+ # @note Stability Level: development
1043
+ K8S_POD_MEMORY_REQUEST_UTILIZATION = 'k8s.pod.memory.request.utilization'
1044
+
821
1045
  # Pod memory RSS.
822
1046
  #
823
1047
  # The amount of anonymous and swap cache memory (includes transparent hugepages).
824
1048
  # This metric is derived from the [MemoryStats.RSSBytes](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#MemoryStats) field of the [PodStats.Memory](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#PodStats) of the Kubelet's stats API.
825
1049
  #
826
- # @note Stability Level: development
1050
+ # @note Stability Level: release_candidate
827
1051
  K8S_POD_MEMORY_RSS = 'k8s.pod.memory.rss'
828
1052
 
829
1053
  # Memory usage of the Pod.
830
1054
  #
831
- # Total memory usage of the Pod
1055
+ # Total memory in use. This includes all memory regardless of when it was accessed.
1056
+ # This metric is derived from the [MemoryStats.UsageBytes](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#MemoryStats) field of the [PodStats.Memory](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#PodStats) of the Kubelet's stats API.
832
1057
  #
833
- # @note Stability Level: development
1058
+ # @note Stability Level: release_candidate
834
1059
  K8S_POD_MEMORY_USAGE = 'k8s.pod.memory.usage'
835
1060
 
836
1061
  # Pod memory working set.
837
1062
  #
838
- # The amount of working set memory. This includes recently accessed memory, dirty memory, and kernel memory. WorkingSetBytes is <= UsageBytes.
1063
+ # The amount of working set memory. This includes recently accessed memory, dirty memory, and kernel memory. On Linux, the working set is calculated by excluding inactive file-backed memory from memory usage (`inactive_file` on cgroup v2, `total_inactive_file` on cgroup v1), so active file-backed memory remains included. The kubelet uses the Pod working set when ranking Pods for eviction under memory pressure. `WorkingSetBytes` is less than or equal to `UsageBytes`.
839
1064
  # This metric is derived from the [MemoryStats.WorkingSetBytes](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#MemoryStats) field of the [PodStats.Memory](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#PodStats) of the Kubelet's stats API.
840
1065
  #
841
- # @note Stability Level: development
1066
+ # @note Stability Level: release_candidate
842
1067
  K8S_POD_MEMORY_WORKING_SET = 'k8s.pod.memory.working_set'
843
1068
 
844
1069
  # Pod network errors.
845
1070
  #
846
- # @note Stability Level: development
1071
+ # @note Stability Level: release_candidate
847
1072
  K8S_POD_NETWORK_ERRORS = 'k8s.pod.network.errors'
848
1073
 
849
1074
  # Network bytes for the Pod.
850
1075
  #
851
- # @note Stability Level: development
1076
+ # @note Stability Level: release_candidate
852
1077
  K8S_POD_NETWORK_IO = 'k8s.pod.network.io'
853
1078
 
1079
+ # Pod memory paging faults.
1080
+ #
1081
+ # Cumulative number of major and minor page faults.
1082
+ # The [MemoryStats.MajorPageFaults](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#MemoryStats) field of the [PodStats.Memory](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#PodStats) of the Kubelet's stats API maps directly to `system.paging.fault.type=major`.
1083
+ # The [MemoryStats.PageFaults](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#MemoryStats) field reports the total number of page faults (equivalent to `pgfault` in the cgroup `memory.stat`), with minor and major combined. The minor page faults MUST therefore be derived as `MemoryStats.PageFaults - MemoryStats.MajorPageFaults`, so that summing the metric over `system.paging.fault.type` yields the total number of page faults.
1084
+ #
1085
+ # @note Stability Level: release_candidate
1086
+ K8S_POD_PAGING_FAULTS = 'k8s.pod.paging.faults'
1087
+
854
1088
  # Describes number of K8s Pods that are currently in a given phase.
855
1089
  #
856
1090
  # All possible pod phases will be reported at each time interval to avoid missing metrics.
@@ -869,17 +1103,17 @@ module OpenTelemetry
869
1103
 
870
1104
  # The time the Pod has been running.
871
1105
  #
872
- # Instrumentations SHOULD use a gauge with type `double` and measure uptime in seconds as a floating point number with the highest precision available.
873
- # The actual accuracy would depend on the instrumentation and operating system.
1106
+ # Instrumentations SHOULD use a gauge with type `double` and measure uptime in seconds as a floating point number with the highest precision available. The actual accuracy would depend on the instrumentation and operating system.
1107
+ # This metric is derived from the [PodStats.StartTime](https://github.com/kubernetes/kubelet/blob/v0.35.2/pkg/apis/stats/v1alpha1/types.go#L122) field of Kubelet's stats API, where `StartTime` represents the pod sandbox creation time as [noted in the Kubelet source](https://github.com/kubernetes/kubernetes/blob/v1.36.3/pkg/kubelet/stats/cri_stats_provider.go#L299). This value resets when the node restarts, as the pod sandbox is recreated.
874
1108
  #
875
- # @note Stability Level: development
1109
+ # @note Stability Level: release_candidate
876
1110
  K8S_POD_UPTIME = 'k8s.pod.uptime'
877
1111
 
878
1112
  # Pod volume storage space available.
879
1113
  #
880
1114
  # This metric is derived from the
881
- # [VolumeStats.AvailableBytes](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#VolumeStats) field
882
- # of the [PodStats](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#PodStats) of the
1115
+ # [VolumeStats.AvailableBytes](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#VolumeStats) field
1116
+ # of the [PodStats](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#PodStats) of the
883
1117
  # Kubelet's stats API.
884
1118
  #
885
1119
  # @note Stability Level: development
@@ -888,8 +1122,8 @@ module OpenTelemetry
888
1122
  # Pod volume total capacity.
889
1123
  #
890
1124
  # This metric is derived from the
891
- # [VolumeStats.CapacityBytes](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#VolumeStats) field
892
- # of the [PodStats](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#PodStats) of the
1125
+ # [VolumeStats.CapacityBytes](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#VolumeStats) field
1126
+ # of the [PodStats](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#PodStats) of the
893
1127
  # Kubelet's stats API.
894
1128
  #
895
1129
  # @note Stability Level: development
@@ -898,8 +1132,8 @@ module OpenTelemetry
898
1132
  # The total inodes in the filesystem of the Pod's volume.
899
1133
  #
900
1134
  # This metric is derived from the
901
- # [VolumeStats.Inodes](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#VolumeStats) field
902
- # of the [PodStats](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#PodStats) of the
1135
+ # [VolumeStats.Inodes](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#VolumeStats) field
1136
+ # of the [PodStats](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#PodStats) of the
903
1137
  # Kubelet's stats API.
904
1138
  #
905
1139
  # @note Stability Level: development
@@ -908,8 +1142,8 @@ module OpenTelemetry
908
1142
  # The free inodes in the filesystem of the Pod's volume.
909
1143
  #
910
1144
  # This metric is derived from the
911
- # [VolumeStats.InodesFree](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#VolumeStats) field
912
- # of the [PodStats](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#PodStats) of the
1145
+ # [VolumeStats.InodesFree](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#VolumeStats) field
1146
+ # of the [PodStats](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#PodStats) of the
913
1147
  # Kubelet's stats API.
914
1148
  #
915
1149
  # @note Stability Level: development
@@ -918,8 +1152,8 @@ module OpenTelemetry
918
1152
  # The inodes used by the filesystem of the Pod's volume.
919
1153
  #
920
1154
  # This metric is derived from the
921
- # [VolumeStats.InodesUsed](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#VolumeStats) field
922
- # of the [PodStats](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#PodStats) of the
1155
+ # [VolumeStats.InodesUsed](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#VolumeStats) field
1156
+ # of the [PodStats](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#PodStats) of the
923
1157
  # Kubelet's stats API.
924
1158
  #
925
1159
  # This may not be equal to `inodes - free` because filesystem may share inodes with other filesystems.
@@ -932,8 +1166,8 @@ module OpenTelemetry
932
1166
  # This may not equal capacity - available.
933
1167
  #
934
1168
  # This metric is derived from the
935
- # [VolumeStats.UsedBytes](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#VolumeStats) field
936
- # of the [PodStats](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#PodStats) of the
1169
+ # [VolumeStats.UsedBytes](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#VolumeStats) field
1170
+ # of the [PodStats](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#PodStats) of the
937
1171
  # Kubelet's stats API.
938
1172
  #
939
1173
  # @note Stability Level: development
@@ -1266,6 +1500,14 @@ module OpenTelemetry
1266
1500
  # @deprecated Replaced by `k8s.statefulset.pod.desired`.
1267
1501
  K8S_STATEFULSET_DESIRED_PODS = 'k8s.statefulset.desired_pods'
1268
1502
 
1503
+ # Total number of available replica pods (ready for at least minReadySeconds) targeted by this statefulset.
1504
+ #
1505
+ # This metric aligns with the `availableReplicas` field of the
1506
+ # [K8s StatefulSetStatus](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.34/#statefulsetstatus-v1-apps).
1507
+ #
1508
+ # @note Stability Level: development
1509
+ K8S_STATEFULSET_POD_AVAILABLE = 'k8s.statefulset.pod.available'
1510
+
1269
1511
  # The number of replica pods created by the statefulset controller from the statefulset version indicated by currentRevision.
1270
1512
  #
1271
1513
  # This metric aligns with the `currentReplicas` field of the