opentelemetry-semantic_conventions 1.44.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 (49) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +4 -0
  3. data/lib/opentelemetry/semantic_conventions/version.rb +2 -2
  4. data/lib/opentelemetry/semconv/client/attributes.rb +2 -2
  5. data/lib/opentelemetry/semconv/db/attributes.rb +16 -11
  6. data/lib/opentelemetry/semconv/incubating/aws/attributes.rb +1 -1
  7. data/lib/opentelemetry/semconv/incubating/azure/attributes.rb +20 -0
  8. data/lib/opentelemetry/semconv/incubating/client/attributes.rb +72 -2
  9. data/lib/opentelemetry/semconv/incubating/container/metrics.rb +20 -25
  10. data/lib/opentelemetry/semconv/incubating/cpu/attributes.rb +4 -2
  11. data/lib/opentelemetry/semconv/incubating/db/attributes.rb +17 -12
  12. data/lib/opentelemetry/semconv/incubating/db/metrics.rb +8 -2
  13. data/lib/opentelemetry/semconv/incubating/destination/attributes.rb +53 -2
  14. data/lib/opentelemetry/semconv/incubating/enduser/attributes.rb +2 -0
  15. data/lib/opentelemetry/semconv/incubating/faas/attributes.rb +7 -3
  16. data/lib/opentelemetry/semconv/incubating/gcp/attributes.rb +20 -0
  17. data/lib/opentelemetry/semconv/incubating/host/attributes.rb +60 -1
  18. data/lib/opentelemetry/semconv/incubating/http/attributes.rb +59 -0
  19. data/lib/opentelemetry/semconv/incubating/jvm/attributes.rb +24 -0
  20. data/lib/opentelemetry/semconv/incubating/jvm/metrics.rb +45 -2
  21. data/lib/opentelemetry/semconv/incubating/k8s/metrics.rb +268 -66
  22. data/lib/opentelemetry/semconv/incubating/kafka/attributes.rb +55 -0
  23. data/lib/opentelemetry/semconv/incubating/kafka.rb +21 -0
  24. data/lib/opentelemetry/semconv/incubating/log/attributes.rb +5 -5
  25. data/lib/opentelemetry/semconv/incubating/messaging/attributes.rb +68 -26
  26. data/lib/opentelemetry/semconv/incubating/network/attributes.rb +103 -1
  27. data/lib/opentelemetry/semconv/incubating/opentracing/attributes.rb +1 -0
  28. data/lib/opentelemetry/semconv/incubating/otel/metrics.rb +7 -1
  29. data/lib/opentelemetry/semconv/incubating/peer/attributes.rb +1 -1
  30. data/lib/opentelemetry/semconv/incubating/rabbitmq/attributes.rb +41 -0
  31. data/lib/opentelemetry/semconv/incubating/rabbitmq.rb +21 -0
  32. data/lib/opentelemetry/semconv/incubating/rocketmq/attributes.rb +71 -0
  33. data/lib/opentelemetry/semconv/incubating/rocketmq.rb +21 -0
  34. data/lib/opentelemetry/semconv/incubating/rpc/attributes.rb +110 -33
  35. data/lib/opentelemetry/semconv/incubating/rpc/metrics.rb +6 -2
  36. data/lib/opentelemetry/semconv/incubating/server/attributes.rb +70 -0
  37. data/lib/opentelemetry/semconv/incubating/service/attributes.rb +16 -0
  38. data/lib/opentelemetry/semconv/incubating/source/attributes.rb +53 -2
  39. data/lib/opentelemetry/semconv/incubating/system/attributes.rb +15 -9
  40. data/lib/opentelemetry/semconv/incubating/system/metrics.rb +7 -3
  41. data/lib/opentelemetry/semconv/incubating/url/attributes.rb +12 -0
  42. data/lib/opentelemetry/semconv/incubating/v8js/attributes.rb +2 -1
  43. data/lib/opentelemetry/semconv/incubating/zos/attributes.rb +4 -2
  44. data/lib/opentelemetry/semconv/rpc/attributes.rb +77 -0
  45. data/lib/opentelemetry/semconv/rpc/metrics.rb +45 -0
  46. data/lib/opentelemetry/semconv/rpc.rb +22 -0
  47. data/lib/opentelemetry/semconv/url/attributes.rb +12 -0
  48. data/lib/opentelemetry/semconv.rb +4 -0
  49. 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'
@@ -580,7 +605,7 @@ module OpenTelemetry
580
605
  #
581
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,53 +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
636
  # The total inodes in the node's root filesystem.
612
637
  #
613
638
  # This metric is derived from the
614
- # [FsStats.Inodes](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#FsStats) field
615
- # of the [NodeStats.Fs](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#NodeStats)
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)
616
641
  # of the Kubelet's stats API.
617
642
  #
618
- # @note Stability Level: development
643
+ # @note Stability Level: release_candidate
619
644
  K8S_NODE_FILESYSTEM_INODE_COUNT = 'k8s.node.filesystem.inode.count'
620
645
 
621
646
  # The free inodes in the node's root filesystem.
622
647
  #
623
648
  # This metric is derived from the
624
- # [FsStats.InodesFree](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#FsStats) field
625
- # 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)
626
651
  # of the Kubelet's stats API.
627
652
  #
628
- # @note Stability Level: development
653
+ # @note Stability Level: release_candidate
629
654
  K8S_NODE_FILESYSTEM_INODE_FREE = 'k8s.node.filesystem.inode.free'
630
655
 
631
656
  # Node filesystem usage.
632
657
  #
633
- # This may not equal capacity - available.
634
- #
635
658
  # This metric is derived from the
636
- # [FsStats.UsedBytes](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#FsStats) field
637
- # of the [NodeStats.Fs](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#NodeStats)
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)
638
661
  # of the Kubelet's stats API.
639
662
  #
640
- # @note Stability Level: development
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
641
668
  K8S_NODE_FILESYSTEM_USAGE = 'k8s.node.filesystem.usage'
642
669
 
643
670
  # Amount of memory allocatable on the node.
@@ -680,7 +707,7 @@ module OpenTelemetry
680
707
 
681
708
  # Node memory working set.
682
709
  #
683
- # 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`.
684
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.
685
712
  #
686
713
  # @note Stability Level: release_candidate
@@ -688,22 +715,43 @@ module OpenTelemetry
688
715
 
689
716
  # Node network errors.
690
717
  #
691
- # @note Stability Level: development
718
+ # @note Stability Level: release_candidate
692
719
  K8S_NODE_NETWORK_ERRORS = 'k8s.node.network.errors'
693
720
 
694
721
  # Network bytes for the Node.
695
722
  #
696
- # @note Stability Level: development
723
+ # @note Stability Level: release_candidate
697
724
  K8S_NODE_NETWORK_IO = 'k8s.node.network.io'
698
725
 
699
726
  # Node memory paging faults.
700
727
  #
701
- # Cumulative number of major/minor page faults.
702
- # 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.
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.
703
731
  #
704
- # @note Stability Level: development
732
+ # @note Stability Level: release_candidate
705
733
  K8S_NODE_PAGING_FAULTS = 'k8s.node.paging.faults'
706
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
+
707
755
  # Amount of pods allocatable on the node.
708
756
  #
709
757
  # @note Stability Level: development
@@ -739,10 +787,10 @@ module OpenTelemetry
739
787
 
740
788
  # The time the Node has been running.
741
789
  #
742
- # Instrumentations SHOULD use a gauge with type `double` and measure uptime in seconds as a floating point number with the highest precision available.
743
- # 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.
744
792
  #
745
- # @note Stability Level: development
793
+ # @note Stability Level: release_candidate
746
794
  K8S_NODE_UPTIME = 'k8s.node.uptime'
747
795
 
748
796
  # Number of PersistentVolumes in a given phase.
@@ -786,6 +834,77 @@ module OpenTelemetry
786
834
  # @note Stability Level: development
787
835
  K8S_PERSISTENTVOLUMECLAIM_STORAGE_REQUEST = 'k8s.persistentvolumeclaim.storage.request'
788
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
+
789
908
  # Total CPU time consumed.
790
909
  #
791
910
  # Total CPU time consumed by the specific Pod on all available CPU cores
@@ -797,39 +916,40 @@ module OpenTelemetry
797
916
  #
798
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
799
918
  #
800
- # @note Stability Level: development
919
+ # @note Stability Level: release_candidate
801
920
  K8S_POD_CPU_USAGE = 'k8s.pod.cpu.usage'
802
921
 
803
922
  # Pod filesystem available bytes.
804
923
  #
805
924
  # This metric is derived from the
806
- # [FsStats.AvailableBytes](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#FsStats) field
807
- # 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)
808
927
  # of the Kubelet's stats API.
809
928
  #
810
- # @note Stability Level: development
929
+ # @note Stability Level: release_candidate
811
930
  K8S_POD_FILESYSTEM_AVAILABLE = 'k8s.pod.filesystem.available'
812
931
 
813
932
  # Pod filesystem capacity.
814
933
  #
815
934
  # This metric is derived from the
816
- # [FsStats.CapacityBytes](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#FsStats) field
817
- # 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)
818
937
  # of the Kubelet's stats API.
819
938
  #
820
- # @note Stability Level: development
939
+ # @note Stability Level: release_candidate
821
940
  K8S_POD_FILESYSTEM_CAPACITY = 'k8s.pod.filesystem.capacity'
822
941
 
823
942
  # Pod filesystem usage.
824
943
  #
825
- # This may not equal capacity - available.
826
- #
827
944
  # This metric is derived from the
828
- # [FsStats.UsedBytes](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#FsStats) field
829
- # 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)
830
947
  # of the Kubelet's stats API.
831
948
  #
832
- # @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
833
953
  K8S_POD_FILESYSTEM_USAGE = 'k8s.pod.filesystem.usage'
834
954
 
835
955
  # Pod memory available.
@@ -840,6 +960,42 @@ module OpenTelemetry
840
960
  # @note Stability Level: release_candidate
841
961
  K8S_POD_MEMORY_AVAILABLE = 'k8s.pod.memory.available'
842
962
 
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
+
843
999
  # Deprecated, use `k8s.pod.paging.faults` instead.
844
1000
  #
845
1001
  # Cumulative number of major/minor page faults.
@@ -849,6 +1005,43 @@ module OpenTelemetry
849
1005
  # @deprecated Replaced by `k8s.pod.paging.faults`.
850
1006
  K8S_POD_MEMORY_PAGING_FAULTS = 'k8s.pod.memory.paging.faults'
851
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
+
852
1045
  # Pod memory RSS.
853
1046
  #
854
1047
  # The amount of anonymous and swap cache memory (includes transparent hugepages).
@@ -867,7 +1060,7 @@ module OpenTelemetry
867
1060
 
868
1061
  # Pod memory working set.
869
1062
  #
870
- # 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`.
871
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.
872
1065
  #
873
1066
  # @note Stability Level: release_candidate
@@ -875,20 +1068,21 @@ module OpenTelemetry
875
1068
 
876
1069
  # Pod network errors.
877
1070
  #
878
- # @note Stability Level: development
1071
+ # @note Stability Level: release_candidate
879
1072
  K8S_POD_NETWORK_ERRORS = 'k8s.pod.network.errors'
880
1073
 
881
1074
  # Network bytes for the Pod.
882
1075
  #
883
- # @note Stability Level: development
1076
+ # @note Stability Level: release_candidate
884
1077
  K8S_POD_NETWORK_IO = 'k8s.pod.network.io'
885
1078
 
886
1079
  # Pod memory paging faults.
887
1080
  #
888
- # Cumulative number of major/minor page faults.
889
- # 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.
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.
890
1084
  #
891
- # @note Stability Level: development
1085
+ # @note Stability Level: release_candidate
892
1086
  K8S_POD_PAGING_FAULTS = 'k8s.pod.paging.faults'
893
1087
 
894
1088
  # Describes number of K8s Pods that are currently in a given phase.
@@ -909,17 +1103,17 @@ module OpenTelemetry
909
1103
 
910
1104
  # The time the Pod has been running.
911
1105
  #
912
- # Instrumentations SHOULD use a gauge with type `double` and measure uptime in seconds as a floating point number with the highest precision available.
913
- # 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.
914
1108
  #
915
- # @note Stability Level: development
1109
+ # @note Stability Level: release_candidate
916
1110
  K8S_POD_UPTIME = 'k8s.pod.uptime'
917
1111
 
918
1112
  # Pod volume storage space available.
919
1113
  #
920
1114
  # This metric is derived from the
921
- # [VolumeStats.AvailableBytes](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
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
923
1117
  # Kubelet's stats API.
924
1118
  #
925
1119
  # @note Stability Level: development
@@ -928,8 +1122,8 @@ module OpenTelemetry
928
1122
  # Pod volume total capacity.
929
1123
  #
930
1124
  # This metric is derived from the
931
- # [VolumeStats.CapacityBytes](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#VolumeStats) field
932
- # 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
933
1127
  # Kubelet's stats API.
934
1128
  #
935
1129
  # @note Stability Level: development
@@ -938,8 +1132,8 @@ module OpenTelemetry
938
1132
  # The total inodes in the filesystem of the Pod's volume.
939
1133
  #
940
1134
  # This metric is derived from the
941
- # [VolumeStats.Inodes](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#VolumeStats) field
942
- # 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
943
1137
  # Kubelet's stats API.
944
1138
  #
945
1139
  # @note Stability Level: development
@@ -948,8 +1142,8 @@ module OpenTelemetry
948
1142
  # The free inodes in the filesystem of the Pod's volume.
949
1143
  #
950
1144
  # This metric is derived from the
951
- # [VolumeStats.InodesFree](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#VolumeStats) field
952
- # 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
953
1147
  # Kubelet's stats API.
954
1148
  #
955
1149
  # @note Stability Level: development
@@ -958,8 +1152,8 @@ module OpenTelemetry
958
1152
  # The inodes used by the filesystem of the Pod's volume.
959
1153
  #
960
1154
  # This metric is derived from the
961
- # [VolumeStats.InodesUsed](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#VolumeStats) field
962
- # 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
963
1157
  # Kubelet's stats API.
964
1158
  #
965
1159
  # This may not be equal to `inodes - free` because filesystem may share inodes with other filesystems.
@@ -972,8 +1166,8 @@ module OpenTelemetry
972
1166
  # This may not equal capacity - available.
973
1167
  #
974
1168
  # This metric is derived from the
975
- # [VolumeStats.UsedBytes](https://pkg.go.dev/k8s.io/kubelet@v0.33.0/pkg/apis/stats/v1alpha1#VolumeStats) field
976
- # 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
977
1171
  # Kubelet's stats API.
978
1172
  #
979
1173
  # @note Stability Level: development
@@ -1306,6 +1500,14 @@ module OpenTelemetry
1306
1500
  # @deprecated Replaced by `k8s.statefulset.pod.desired`.
1307
1501
  K8S_STATEFULSET_DESIRED_PODS = 'k8s.statefulset.desired_pods'
1308
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
+
1309
1511
  # The number of replica pods created by the statefulset controller from the statefulset version indicated by currentRevision.
1310
1512
  #
1311
1513
  # This metric aligns with the `currentReplicas` field of the