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.
- checksums.yaml +4 -4
- data/CHANGELOG.md +8 -0
- data/lib/opentelemetry/semantic_conventions/version.rb +2 -2
- data/lib/opentelemetry/semconv/client/attributes.rb +3 -3
- data/lib/opentelemetry/semconv/code/attributes.rb +1 -1
- data/lib/opentelemetry/semconv/container/attributes.rb +1 -1
- data/lib/opentelemetry/semconv/db/attributes.rb +16 -11
- data/lib/opentelemetry/semconv/incubating/android/attributes.rb +1 -1
- data/lib/opentelemetry/semconv/incubating/app/attributes.rb +1 -1
- data/lib/opentelemetry/semconv/incubating/artifact/attributes.rb +3 -3
- data/lib/opentelemetry/semconv/incubating/aws/attributes.rb +1 -1
- data/lib/opentelemetry/semconv/incubating/azure/attributes.rb +20 -0
- data/lib/opentelemetry/semconv/incubating/browser/attributes.rb +30 -0
- data/lib/opentelemetry/semconv/incubating/client/attributes.rb +73 -3
- data/lib/opentelemetry/semconv/incubating/cloudfoundry/attributes.rb +1 -1
- data/lib/opentelemetry/semconv/incubating/code/attributes.rb +1 -1
- data/lib/opentelemetry/semconv/incubating/container/attributes.rb +3 -3
- data/lib/opentelemetry/semconv/incubating/container/metrics.rb +40 -34
- data/lib/opentelemetry/semconv/incubating/cpu/attributes.rb +4 -2
- data/lib/opentelemetry/semconv/incubating/db/attributes.rb +24 -14
- data/lib/opentelemetry/semconv/incubating/db/metrics.rb +8 -2
- data/lib/opentelemetry/semconv/incubating/deployment/attributes.rb +1 -1
- data/lib/opentelemetry/semconv/incubating/destination/attributes.rb +53 -2
- data/lib/opentelemetry/semconv/incubating/enduser/attributes.rb +2 -0
- data/lib/opentelemetry/semconv/incubating/faas/attributes.rb +7 -3
- data/lib/opentelemetry/semconv/incubating/file/attributes.rb +3 -3
- data/lib/opentelemetry/semconv/incubating/gcp/attributes.rb +20 -0
- data/lib/opentelemetry/semconv/incubating/host/attributes.rb +61 -2
- data/lib/opentelemetry/semconv/incubating/http/attributes.rb +59 -0
- data/lib/opentelemetry/semconv/incubating/jvm/attributes.rb +24 -0
- data/lib/opentelemetry/semconv/incubating/jvm/metrics.rb +45 -2
- data/lib/opentelemetry/semconv/incubating/k8s/metrics.rb +315 -73
- data/lib/opentelemetry/semconv/incubating/kafka/attributes.rb +55 -0
- data/lib/opentelemetry/semconv/incubating/kafka.rb +21 -0
- data/lib/opentelemetry/semconv/incubating/log/attributes.rb +7 -7
- data/lib/opentelemetry/semconv/incubating/mcp/attributes.rb +1 -1
- data/lib/opentelemetry/semconv/incubating/messaging/attributes.rb +78 -29
- data/lib/opentelemetry/semconv/incubating/network/attributes.rb +107 -5
- data/lib/opentelemetry/semconv/incubating/opentracing/attributes.rb +1 -0
- data/lib/opentelemetry/semconv/incubating/oracle/attributes.rb +1 -1
- data/lib/opentelemetry/semconv/incubating/otel/metrics.rb +25 -8
- data/lib/opentelemetry/semconv/incubating/peer/attributes.rb +1 -1
- data/lib/opentelemetry/semconv/incubating/pprof/attributes.rb +2 -2
- data/lib/opentelemetry/semconv/incubating/process/metrics.rb +16 -1
- data/lib/opentelemetry/semconv/incubating/rabbitmq/attributes.rb +41 -0
- data/lib/opentelemetry/semconv/incubating/rabbitmq.rb +21 -0
- data/lib/opentelemetry/semconv/incubating/rocketmq/attributes.rb +71 -0
- data/lib/opentelemetry/semconv/incubating/rocketmq.rb +21 -0
- data/lib/opentelemetry/semconv/incubating/rpc/attributes.rb +111 -36
- data/lib/opentelemetry/semconv/incubating/rpc/metrics.rb +6 -2
- data/lib/opentelemetry/semconv/incubating/server/attributes.rb +71 -1
- data/lib/opentelemetry/semconv/incubating/service/attributes.rb +16 -0
- data/lib/opentelemetry/semconv/incubating/session/attributes.rb +1 -1
- data/lib/opentelemetry/semconv/incubating/source/attributes.rb +53 -2
- data/lib/opentelemetry/semconv/incubating/system/attributes.rb +15 -9
- data/lib/opentelemetry/semconv/incubating/system/metrics.rb +18 -5
- data/lib/opentelemetry/semconv/incubating/url/attributes.rb +15 -3
- data/lib/opentelemetry/semconv/incubating/v8js/attributes.rb +2 -1
- data/lib/opentelemetry/semconv/incubating/zos/attributes.rb +4 -2
- data/lib/opentelemetry/semconv/network/attributes.rb +2 -2
- data/lib/opentelemetry/semconv/rpc/attributes.rb +77 -0
- data/lib/opentelemetry/semconv/rpc/metrics.rb +45 -0
- data/lib/opentelemetry/semconv/rpc.rb +22 -0
- data/lib/opentelemetry/semconv/server/attributes.rb +1 -1
- data/lib/opentelemetry/semconv/url/attributes.rb +12 -0
- data/lib/opentelemetry/semconv.rb +4 -0
- 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
|
-
#
|
|
98
|
-
#
|
|
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
|
|
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
|
|
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
|
|
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:
|
|
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.
|
|
595
|
-
# of the [NodeStats.Fs](https://pkg.go.dev/k8s.io/kubelet@v0.
|
|
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:
|
|
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.
|
|
605
|
-
# of the [NodeStats.Fs](https://pkg.go.dev/k8s.io/kubelet@v0.
|
|
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:
|
|
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
|
-
# This
|
|
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.
|
|
617
|
-
# of the [NodeStats.Fs](https://pkg.go.dev/k8s.io/kubelet@v0.
|
|
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:
|
|
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:
|
|
680
|
+
# @note Stability Level: release_candidate
|
|
634
681
|
K8S_NODE_MEMORY_AVAILABLE = 'k8s.node.memory.available'
|
|
635
682
|
|
|
636
|
-
#
|
|
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:
|
|
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
|
|
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:
|
|
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
|
|
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:
|
|
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:
|
|
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:
|
|
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
|
|
767
|
+
# Node's system container CPU usage, measured in CPUs.
|
|
690
768
|
#
|
|
691
|
-
#
|
|
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
|
-
#
|
|
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:
|
|
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
|
|
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
|
|
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:
|
|
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.
|
|
777
|
-
# of the [PodStats.EphemeralStorage](https://pkg.go.dev/k8s.io/kubelet@v0.
|
|
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:
|
|
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.
|
|
787
|
-
# of the [PodStats.EphemeralStorage](https://pkg.go.dev/k8s.io/kubelet@v0.
|
|
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:
|
|
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.
|
|
799
|
-
# of the [PodStats.EphemeralStorage](https://pkg.go.dev/k8s.io/kubelet@v0.
|
|
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
|
-
#
|
|
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:
|
|
960
|
+
# @note Stability Level: release_candidate
|
|
811
961
|
K8S_POD_MEMORY_AVAILABLE = 'k8s.pod.memory.available'
|
|
812
962
|
|
|
813
|
-
#
|
|
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:
|
|
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
|
|
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:
|
|
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
|
|
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:
|
|
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:
|
|
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:
|
|
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
|
-
#
|
|
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:
|
|
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.
|
|
882
|
-
# of the [PodStats](https://pkg.go.dev/k8s.io/kubelet@v0.
|
|
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.
|
|
892
|
-
# of the [PodStats](https://pkg.go.dev/k8s.io/kubelet@v0.
|
|
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.
|
|
902
|
-
# of the [PodStats](https://pkg.go.dev/k8s.io/kubelet@v0.
|
|
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.
|
|
912
|
-
# of the [PodStats](https://pkg.go.dev/k8s.io/kubelet@v0.
|
|
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.
|
|
922
|
-
# of the [PodStats](https://pkg.go.dev/k8s.io/kubelet@v0.
|
|
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.
|
|
936
|
-
# of the [PodStats](https://pkg.go.dev/k8s.io/kubelet@v0.
|
|
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
|