opentelemetry-semantic_conventions 1.43.0 → 1.44.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 (38) 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 +1 -1
  5. data/lib/opentelemetry/semconv/code/attributes.rb +1 -1
  6. data/lib/opentelemetry/semconv/container/attributes.rb +1 -1
  7. data/lib/opentelemetry/semconv/incubating/android/attributes.rb +1 -1
  8. data/lib/opentelemetry/semconv/incubating/app/attributes.rb +1 -1
  9. data/lib/opentelemetry/semconv/incubating/artifact/attributes.rb +3 -3
  10. data/lib/opentelemetry/semconv/incubating/browser/attributes.rb +30 -0
  11. data/lib/opentelemetry/semconv/incubating/client/attributes.rb +1 -1
  12. data/lib/opentelemetry/semconv/incubating/cloudfoundry/attributes.rb +1 -1
  13. data/lib/opentelemetry/semconv/incubating/code/attributes.rb +1 -1
  14. data/lib/opentelemetry/semconv/incubating/container/attributes.rb +3 -3
  15. data/lib/opentelemetry/semconv/incubating/container/metrics.rb +23 -12
  16. data/lib/opentelemetry/semconv/incubating/db/attributes.rb +7 -2
  17. data/lib/opentelemetry/semconv/incubating/deployment/attributes.rb +1 -1
  18. data/lib/opentelemetry/semconv/incubating/destination/attributes.rb +1 -1
  19. data/lib/opentelemetry/semconv/incubating/file/attributes.rb +3 -3
  20. data/lib/opentelemetry/semconv/incubating/host/attributes.rb +1 -1
  21. data/lib/opentelemetry/semconv/incubating/k8s/metrics.rb +59 -19
  22. data/lib/opentelemetry/semconv/incubating/log/attributes.rb +2 -2
  23. data/lib/opentelemetry/semconv/incubating/mcp/attributes.rb +1 -1
  24. data/lib/opentelemetry/semconv/incubating/messaging/attributes.rb +13 -6
  25. data/lib/opentelemetry/semconv/incubating/network/attributes.rb +4 -4
  26. data/lib/opentelemetry/semconv/incubating/oracle/attributes.rb +1 -1
  27. data/lib/opentelemetry/semconv/incubating/otel/metrics.rb +18 -7
  28. data/lib/opentelemetry/semconv/incubating/pprof/attributes.rb +2 -2
  29. data/lib/opentelemetry/semconv/incubating/process/metrics.rb +16 -1
  30. data/lib/opentelemetry/semconv/incubating/rpc/attributes.rb +1 -3
  31. data/lib/opentelemetry/semconv/incubating/server/attributes.rb +1 -1
  32. data/lib/opentelemetry/semconv/incubating/session/attributes.rb +1 -1
  33. data/lib/opentelemetry/semconv/incubating/source/attributes.rb +1 -1
  34. data/lib/opentelemetry/semconv/incubating/system/metrics.rb +11 -2
  35. data/lib/opentelemetry/semconv/incubating/url/attributes.rb +3 -3
  36. data/lib/opentelemetry/semconv/network/attributes.rb +2 -2
  37. data/lib/opentelemetry/semconv/server/attributes.rb +1 -1
  38. metadata +5 -5
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: c87619f45a9752cbd827768b88976c4636aba6abb0376efc480113bc4664ef73
4
- data.tar.gz: b62d6d3745214c370d0316b2c95b0a0b35510dd53cb375d4ce15dcc07b7c5f6a
3
+ metadata.gz: 83a4fe1eefc8216b24d3c38fc0a6705987c5829681456ae0d84457f0f0d20e63
4
+ data.tar.gz: '0398ac350966985307a2987f9a5de63542b132afb7409ca013c2faf36a14f4d8'
5
5
  SHA512:
6
- metadata.gz: 3a2e44a598a565d9cedac1a31cfec2d5d8c5e9ba6c43b22e8cf34c7c94472ac516cee0f5bd56a58bd94cc8529d5c41ab5d73d3da3b8c36d01c7ba5da73dee6a9
7
- data.tar.gz: 9b537d4df0f26facf57fa5e411660287f6e81c8627fd9d046fd7a6edb66055d6c3f8ce512ed21d872c630b01c264949bfd50d336853483cebb349e3e095ace82
6
+ metadata.gz: 97fcd773f881a7489754145cebb68531a0ad94443e532127d0332d1ea08adea0a820ed3bd9965917734c9eedb1e5587f4ee2a3421214754aca2b6539838b5592
7
+ data.tar.gz: a9b7ef0a6a9bee697f0b13cd5658d8970742f26052dab4326e47d10a48785c51e7953a3cd01526b7f9d4966a7712a8ab01ba97425680558cdebda5242f7fc511
data/CHANGELOG.md CHANGED
@@ -1,5 +1,9 @@
1
1
  # Release History: opentelemetry-semantic_conventions
2
2
 
3
+ ### v1.44.0 / 2026-08-07
4
+
5
+ * ADDED: Update dependency open-telemetry/semantic-conventions to v1.44.0 (#2279)
6
+
3
7
  ### v1.43.0 / 2026-07-08
4
8
 
5
9
  * ADDED: Update dependency open-telemetry/semantic-conventions to v1.43.0 (#2218)
@@ -7,8 +7,8 @@
7
7
  module OpenTelemetry
8
8
  module SemanticConventions
9
9
  # Version of the OpenTelemetry Semantic Conventions from which this library was generated.
10
- SPEC_VERSION = '1.43.0'
10
+ SPEC_VERSION = '1.44.0'
11
11
  # Release version of this gem. May not match SPEC_VERSION until gem is released after a spec update.
12
- VERSION = '1.43.0'
12
+ VERSION = '1.44.0'
13
13
  end
14
14
  end
@@ -23,7 +23,7 @@ module OpenTelemetry
23
23
  module CLIENT
24
24
  # @!group Attribute Names
25
25
 
26
- # Client address - domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name.
26
+ # Client address - domain name if available without reverse DNS lookup; otherwise, IP address or UNIX domain socket name.
27
27
  #
28
28
  # When observed from the server side, and when communicating through an intermediary, `client.address` SHOULD represent the client address behind any intermediaries, for example proxies, if it's available.
29
29
  #
@@ -28,7 +28,7 @@ module OpenTelemetry
28
28
  # @note Stability Level: stable
29
29
  CODE_COLUMN_NUMBER = 'code.column.number'
30
30
 
31
- # The source code file name that identifies the code unit as uniquely as possible (preferably an absolute file path). This attribute MUST NOT be used on the Profile signal since the data is already captured in 'message Function'. This constraint is imposed to prevent redundancy and maintain data integrity.
31
+ # The source code filename that identifies the code unit as uniquely as possible (preferably an absolute file path). This attribute MUST NOT be used on the Profile signal since the data is already captured in 'message Function'. This constraint is imposed to prevent redundancy and maintain data integrity.
32
32
  #
33
33
  # @note Stability Level: stable
34
34
  CODE_FILE_PATH = 'code.file.path'
@@ -33,7 +33,7 @@ module OpenTelemetry
33
33
  # @note Stability Level: stable
34
34
  CONTAINER_IMAGE_NAME = 'container.image.name'
35
35
 
36
- # Repo digests of the container image as provided by the container runtime.
36
+ # Repository digests of the container image as provided by the container runtime.
37
37
  #
38
38
  # [Docker](https://docs.docker.com/reference/api/engine/version/v1.52/#tag/Image/operation/ImageInspect) and [CRI](https://github.com/kubernetes/cri-api/blob/c75ef5b473bbe2d0a4fc92f82235efd665ea8e9f/pkg/apis/runtime/v1/api.proto#L1237-L1238) report those under the `RepoDigests` field.
39
39
  #
@@ -31,7 +31,7 @@ module OpenTelemetry
31
31
  # @note Stability Level: development
32
32
  ANDROID_APP_STATE = 'android.app.state'
33
33
 
34
- # Uniquely identifies the framework API revision offered by a version (`os.version`) of the android operating system. More information can be found in the [Android API levels documentation](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels).
34
+ # Uniquely identifies the framework API revision offered by a version (`os.version`) of the Android operating system. More information can be found in the [Android API levels documentation](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels).
35
35
  #
36
36
  # @note Stability Level: development
37
37
  ANDROID_OS_API_LEVEL = 'android.os.api_level'
@@ -29,7 +29,7 @@ module OpenTelemetry
29
29
  # @note Stability Level: development
30
30
  APP_BUILD_ID = 'app.build_id'
31
31
 
32
- # A unique identifier representing an instance of an end-user facing app crash.
32
+ # A unique identifier representing an instance of an end user facing app crash.
33
33
  #
34
34
  # Its value MAY be meaningful and be used as a reference for telemetry and metadata recorded by
35
35
  # the same instrumentation (e.g. it is an ID generated by an external source that captured the crash).
@@ -34,14 +34,14 @@ module OpenTelemetry
34
34
  # @note Stability Level: development
35
35
  ARTIFACT_ATTESTATION_HASH = 'artifact.attestation.hash'
36
36
 
37
- # The id of the build [software attestation](https://slsa.dev/attestation-model).
37
+ # The ID of the build [software attestation](https://slsa.dev/attestation-model).
38
38
  #
39
39
  # @note Stability Level: development
40
40
  ARTIFACT_ATTESTATION_ID = 'artifact.attestation.id'
41
41
 
42
- # The human readable file name of the artifact, typically generated during build and release processes. Often includes the package name and version in the file name.
42
+ # The human readable filename of the artifact, typically generated during build and release processes. Often includes the package name and version in the filename.
43
43
  #
44
- # This file name can also act as the [Package Name](https://slsa.dev/spec/v1.0/terminology#package-model)
44
+ # This filename can also act as the [Package Name](https://slsa.dev/spec/v1.0/terminology#package-model)
45
45
  # in cases where the package ecosystem maps accordingly.
46
46
  # Additionally, the artifact [can be published](https://slsa.dev/spec/v1.0/terminology#software-supply-chain)
47
47
  # for others, but that is not a guarantee.
@@ -58,6 +58,36 @@ module OpenTelemetry
58
58
  # @note Stability Level: development
59
59
  BROWSER_PLATFORM = 'browser.platform'
60
60
 
61
+ # The delta between the current value and the last-reported value. See [delta](https://github.com/GoogleChrome/web-vitals?tab=readme-ov-file#report-only-the-delta-of-changes).
62
+ #
63
+ # @note Stability Level: development
64
+ BROWSER_WEB_VITAL_DELTA = 'browser.web_vital.delta'
65
+
66
+ # A unique ID representing this particular metric instance.
67
+ #
68
+ # @note Stability Level: development
69
+ BROWSER_WEB_VITAL_ID = 'browser.web_vital.id'
70
+
71
+ # Name of the web vital.
72
+ #
73
+ # @note Stability Level: development
74
+ BROWSER_WEB_VITAL_NAME = 'browser.web_vital.name'
75
+
76
+ # The type of navigation, as reported by the [Navigation Timing API](https://developer.mozilla.org/docs/Web/API/PerformanceNavigationTiming/type), with additional values reported by the web-vitals library.
77
+ #
78
+ # @note Stability Level: development
79
+ BROWSER_WEB_VITAL_NAVIGATION_TYPE = 'browser.web_vital.navigation_type'
80
+
81
+ # The rating of the web vital value against the "good", "needs improvement", and "poor" thresholds defined for the metric.
82
+ #
83
+ # @note Stability Level: development
84
+ BROWSER_WEB_VITAL_RATING = 'browser.web_vital.rating'
85
+
86
+ # Value of the web vital.
87
+ #
88
+ # @note Stability Level: development
89
+ BROWSER_WEB_VITAL_VALUE = 'browser.web_vital.value'
90
+
61
91
  # @!endgroup
62
92
  end
63
93
  end
@@ -24,7 +24,7 @@ module OpenTelemetry
24
24
  module CLIENT
25
25
  # @!group Attribute Names
26
26
 
27
- # Client address - domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name.
27
+ # Client address - domain name if available without reverse DNS lookup; otherwise, IP address or UNIX domain socket name.
28
28
  #
29
29
  # When observed from the server side, and when communicating through an intermediary, `client.address` SHOULD represent the client address behind any intermediaries, for example proxies, if it's available.
30
30
  #
@@ -129,7 +129,7 @@ module OpenTelemetry
129
129
  #
130
130
  # CloudFoundry defines the `instance_id` in the [Loggregator v2 envelope](https://github.com/cloudfoundry/loggregator-api#v2-envelope).
131
131
  # It is used for logs and metrics emitted by CloudFoundry. It is
132
- # supposed to contain the vm id for CloudFoundry components.
132
+ # supposed to contain the vm ID for CloudFoundry components.
133
133
  #
134
134
  # When system components are instrumented, values from the
135
135
  # [Bosh spec](https://bosh.io/docs/jobs/#properties-spec)
@@ -37,7 +37,7 @@ module OpenTelemetry
37
37
  # @deprecated Now available in the stable namespace at {OpenTelemetry::SemConv::CODE::CODE_COLUMN_NUMBER}.
38
38
  CODE_COLUMN_NUMBER = 'code.column.number'
39
39
 
40
- # The source code file name that identifies the code unit as uniquely as possible (preferably an absolute file path). This attribute MUST NOT be used on the Profile signal since the data is already captured in 'message Function'. This constraint is imposed to prevent redundancy and maintain data integrity.
40
+ # The source code filename that identifies the code unit as uniquely as possible (preferably an absolute file path). This attribute MUST NOT be used on the Profile signal since the data is already captured in 'message Function'. This constraint is imposed to prevent redundancy and maintain data integrity.
41
41
  #
42
42
  # @note Stability Level: stable
43
43
  #
@@ -70,7 +70,7 @@ module OpenTelemetry
70
70
 
71
71
  # Runtime specific image identifier. Usually a hash algorithm followed by a UUID.
72
72
  #
73
- # Docker defines a sha256 of the image id; `container.image.id` corresponds to the `Image` field from the Docker container inspect [API](https://docs.docker.com/reference/api/engine/version/v1.52/#tag/Container/operation/ContainerInspect) endpoint.
73
+ # Docker defines a sha256 of the image ID; `container.image.id` corresponds to the `Image` field from the Docker container inspect [API](https://docs.docker.com/reference/api/engine/version/v1.52/#tag/Container/operation/ContainerInspect) endpoint.
74
74
  # K8s defines a link to the container registry repository with digest `"imageID": "registry.azurecr.io /namespace/service/dockerfile@sha256:bdeabd40c3a8a492eaf9e8e44d0ebbb84bac7ee25ac0cf8a7159d25f62555625"`.
75
75
  # The ID is assigned by the container runtime and can vary in different environments. Consider using `oci.manifest.digest` if it is important to identify the same image in different environments/runtimes.
76
76
  #
@@ -84,7 +84,7 @@ module OpenTelemetry
84
84
  # @deprecated Now available in the stable namespace at {OpenTelemetry::SemConv::CONTAINER::CONTAINER_IMAGE_NAME}.
85
85
  CONTAINER_IMAGE_NAME = 'container.image.name'
86
86
 
87
- # Repo digests of the container image as provided by the container runtime.
87
+ # Repository digests of the container image as provided by the container runtime.
88
88
  #
89
89
  # [Docker](https://docs.docker.com/reference/api/engine/version/v1.52/#tag/Image/operation/ImageInspect) and [CRI](https://github.com/kubernetes/cri-api/blob/c75ef5b473bbe2d0a4fc92f82235efd665ea8e9f/pkg/apis/runtime/v1/api.proto#L1237-L1238) report those under the `RepoDigests` field.
90
90
  #
@@ -108,7 +108,7 @@ module OpenTelemetry
108
108
  #
109
109
  # Container labels, `<key>` being the label name, the value being the label value.
110
110
  #
111
- # For example, a docker container label `app` with value `nginx` SHOULD be recorded as the `container.label.app` attribute with value `"nginx"`.
111
+ # For example, a Docker container label `app` with value `nginx` SHOULD be recorded as the `container.label.app` attribute with value `"nginx"`.
112
112
  #
113
113
  # @note Stability Level: development
114
114
  CONTAINER_LABEL_LAMBDA = ->(key) { "container.label.#{key}" }
@@ -24,16 +24,16 @@ module OpenTelemetry
24
24
  module CONTAINER
25
25
  # @!group Metrics Names
26
26
 
27
- # CPU time consumed.
27
+ # Total CPU time consumed.
28
28
  #
29
29
  # CPU time consumed by the specific container on all available CPU cores
30
30
  #
31
31
  # @note Stability Level: release_candidate
32
32
  CONTAINER_CPU_TIME = 'container.cpu.time'
33
33
 
34
- # Container's CPU usage, measured in cpus. Range from 0 to the number of allocatable CPUs.
34
+ # Container's CPU usage, measured in CPUs. Range from 0 to the number of allocatable CPUs.
35
35
  #
36
- # CPU usage of the specific container on all available CPU cores, averaged over the sample window
36
+ # CPU usage of the specific container on all available CPU cores. It is calculated as the change in cumulative CPU time (container.cpu.time) over a measurement interval, divided by the elapsed time: usageCores = (cpuTimeEnd - cpuTimeStart) / elapsedSeconds
37
37
  #
38
38
  # @note Stability Level: development
39
39
  CONTAINER_CPU_USAGE = 'container.cpu.usage'
@@ -81,40 +81,43 @@ module OpenTelemetry
81
81
  #
82
82
  # Available memory for use. This is defined as the memory limit - workingSetBytes. If memory limit is undefined, the available bytes is omitted.
83
83
  # In general, this metric can be derived from [cadvisor](https://github.com/google/cadvisor/blob/v0.53.0/docs/storage/prometheus.md#prometheus-container-metrics) and by subtracting the `container_memory_working_set_bytes` metric from the `container_spec_memory_limit_bytes` metric.
84
- # In K8s, 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.
84
+ # In K8s, 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 [ContainerStats.Memory](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#ContainerStats) of the Kubelet's stats API.
85
85
  #
86
- # @note Stability Level: development
86
+ # @note Stability Level: release_candidate
87
87
  CONTAINER_MEMORY_AVAILABLE = 'container.memory.available'
88
88
 
89
- # Container memory paging faults.
89
+ # Deprecated, use `container.paging.faults` instead.
90
90
  #
91
91
  # In general, this metric can be derived from [cadvisor](https://github.com/google/cadvisor/blob/v0.53.0/docs/storage/prometheus.md#prometheus-container-metrics) and specifically the `container_memory_failures_total{failure_type=pgfault, scope=container}` and `container_memory_failures_total{failure_type=pgmajfault, scope=container}`metric.
92
92
  # In K8s, 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.
93
93
  #
94
94
  # @note Stability Level: development
95
+ # @deprecated Replaced by `container.paging.faults`.
95
96
  CONTAINER_MEMORY_PAGING_FAULTS = 'container.memory.paging.faults'
96
97
 
97
98
  # Container memory RSS.
98
99
  #
99
100
  # In general, this metric can be derived from [cadvisor](https://github.com/google/cadvisor/blob/v0.53.0/docs/storage/prometheus.md#prometheus-container-metrics) and specifically the `container_memory_rss` metric.
100
- # In K8s, 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.
101
+ # In K8s, 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 [ContainerStats.Memory](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#ContainerStats) of the Kubelet's stats API.
101
102
  #
102
- # @note Stability Level: development
103
+ # @note Stability Level: release_candidate
103
104
  CONTAINER_MEMORY_RSS = 'container.memory.rss'
104
105
 
105
106
  # Memory usage of the container.
106
107
  #
107
- # Memory usage of the container.
108
+ # Current memory usage, including all memory regardless of when it was accessed.
109
+ # In general, this metric can be derived from [cadvisor](https://github.com/google/cadvisor/blob/v0.53.0/docs/storage/prometheus.md#prometheus-container-metrics) and specifically the `container_memory_usage_bytes` metric.
110
+ # In K8s, 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 [ContainerStats.Memory](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#ContainerStats) of the Kubelet's stats API.
108
111
  #
109
- # @note Stability Level: development
112
+ # @note Stability Level: release_candidate
110
113
  CONTAINER_MEMORY_USAGE = 'container.memory.usage'
111
114
 
112
115
  # Container memory working set.
113
116
  #
114
117
  # In general, this metric can be derived from [cadvisor](https://github.com/google/cadvisor/blob/v0.53.0/docs/storage/prometheus.md#prometheus-container-metrics) and specifically the `container_memory_working_set_bytes` metric.
115
- # In K8s, 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.
118
+ # In K8s, 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 [ContainerStats.Memory](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#ContainerStats) of the Kubelet's stats API.
116
119
  #
117
- # @note Stability Level: development
120
+ # @note Stability Level: release_candidate
118
121
  CONTAINER_MEMORY_WORKING_SET = 'container.memory.working_set'
119
122
 
120
123
  # Network bytes for the container.
@@ -124,6 +127,14 @@ module OpenTelemetry
124
127
  # @note Stability Level: development
125
128
  CONTAINER_NETWORK_IO = 'container.network.io'
126
129
 
130
+ # Container memory paging faults.
131
+ #
132
+ # In general, this metric can be derived from [cadvisor](https://github.com/google/cadvisor/blob/v0.53.0/docs/storage/prometheus.md#prometheus-container-metrics) and specifically the `container_memory_failures_total{failure_type=pgfault, scope=container}` and `container_memory_failures_total{failure_type=pgmajfault, scope=container}`metric.
133
+ # In K8s, 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 [ContainerStats.Memory](https://pkg.go.dev/k8s.io/kubelet@v0.34.0/pkg/apis/stats/v1alpha1#ContainerStats) of the Kubelet's stats API.
134
+ #
135
+ # @note Stability Level: development
136
+ CONTAINER_PAGING_FAULTS = 'container.paging.faults'
137
+
127
138
  # The time the container has been running.
128
139
  #
129
140
  # Instrumentations SHOULD use a gauge with type `double` and measure uptime in seconds as a floating point number with the highest precision available.
@@ -326,7 +326,12 @@ module OpenTelemetry
326
326
  # up with the parameterized placeholders present in `db.query.text`.
327
327
  #
328
328
  # It is RECOMMENDED to capture the value as provided by the application
329
- # without attempting to do any case normalization.
329
+ # without attempting to do any case normalization or sanitization.
330
+ #
331
+ # Instrumentations SHOULD NOT capture `db.query.parameter.<key>` by default
332
+ # since values may contain PII or sensitive details.
333
+ # Application operators are expected to enable specific keys depending
334
+ # on their privacy and security considerations.
330
335
  #
331
336
  # `db.query.parameter.<key>` SHOULD NOT be captured on batch operations.
332
337
  #
@@ -376,7 +381,7 @@ module OpenTelemetry
376
381
  # Deprecated, use `db.namespace` instead.
377
382
  #
378
383
  # @note Stability Level: development
379
- # @deprecated Uncategorized.
384
+ # @deprecated Replaced by `db.namespace` (string).
380
385
  DB_REDIS_DATABASE_INDEX = 'db.redis.database_index'
381
386
 
382
387
  # Number of rows returned by the operation.
@@ -45,7 +45,7 @@ module OpenTelemetry
45
45
  # @deprecated Now available in the stable namespace at {OpenTelemetry::SemConv::DEPLOYMENT::DEPLOYMENT_ENVIRONMENT_NAME}.
46
46
  DEPLOYMENT_ENVIRONMENT_NAME = 'deployment.environment.name'
47
47
 
48
- # The id of the deployment.
48
+ # The ID of the deployment.
49
49
  #
50
50
  # @note Stability Level: development
51
51
  DEPLOYMENT_ID = 'deployment.id'
@@ -24,7 +24,7 @@ module OpenTelemetry
24
24
  module DESTINATION
25
25
  # @!group Attribute Names
26
26
 
27
- # Destination address - domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name.
27
+ # Destination address - domain name if available without reverse DNS lookup; otherwise, IP address or UNIX domain socket name.
28
28
  #
29
29
  # When observed from the source side, and when communicating through an intermediary, `destination.address` SHOULD represent the destination address behind any intermediaries, for example proxies, if it's available.
30
30
  #
@@ -59,7 +59,7 @@ module OpenTelemetry
59
59
 
60
60
  # File extension, excluding the leading dot.
61
61
  #
62
- # When the file name has multiple extensions (example.tar.gz), only the last one should be captured ("gz", not "tar.gz").
62
+ # When the filename has multiple extensions (example.tar.gz), only the last one should be captured ("gz", not "tar.gz").
63
63
  #
64
64
  # @note Stability Level: development
65
65
  FILE_EXTENSION = 'file.extension'
@@ -67,7 +67,7 @@ module OpenTelemetry
67
67
  # Name of the fork. A fork is additional data associated with a filesystem object.
68
68
  #
69
69
  # On Linux, a resource fork is used to store additional data with a filesystem object. A file always has at least one fork for the data portion, and additional forks may exist.
70
- # On NTFS, this is analogous to an Alternate Data Stream (ADS), and the default data stream for a file is just called $DATA. Zone.Identifier is commonly used by Windows to track contents downloaded from the Internet. An ADS is typically of the form: C:\path\to\filename.extension:some_fork_name, and some_fork_name is the value that should populate `fork_name`. `filename.extension` should populate `file.name`, and `extension` should populate `file.extension`. The full path, `file.path`, will include the fork name.
70
+ # On NTFS, this is analogous to an Alternate Data Stream (ADS), and the default data stream for a file is just called $DATA. Zone.Identifier is commonly used by Windows to track contents downloaded from the internet. An ADS is typically of the form: C:\path\to\filename.extension:some_fork_name, and some_fork_name is the value that should populate `fork_name`. `filename.extension` should populate `file.name`, and `extension` should populate `file.extension`. The full path, `file.path`, will include the fork name.
71
71
  #
72
72
  # @note Stability Level: development
73
73
  FILE_FORK_NAME = 'file.fork_name'
@@ -127,7 +127,7 @@ module OpenTelemetry
127
127
  # @note Stability Level: development
128
128
  FILE_OWNER_NAME = 'file.owner.name'
129
129
 
130
- # Full path to the file, including the file name. It should include the drive letter, when appropriate.
130
+ # Full path to the file, including the filename. It should include the drive letter, when appropriate.
131
131
  #
132
132
  # @note Stability Level: development
133
133
  FILE_PATH = 'file.path'
@@ -95,7 +95,7 @@ module OpenTelemetry
95
95
  # @note Stability Level: development
96
96
  HOST_MAC = 'host.mac'
97
97
 
98
- # Name of the host. On Unix systems, it may contain what the hostname command returns, or the fully qualified hostname, or another name specified by the user.
98
+ # Name of the host. On UNIX systems, it may contain what the hostname command returns, or the fully qualified hostname, or another name specified by the user.
99
99
  #
100
100
  # @note Stability Level: development
101
101
  HOST_NAME = 'host.name'
@@ -564,7 +564,7 @@ module OpenTelemetry
564
564
  # @note Stability Level: development
565
565
  K8S_NODE_CONDITION_STATUS = 'k8s.node.condition.status'
566
566
 
567
- # Amount of cpu allocatable on the node.
567
+ # Amount of CPU allocatable on the node.
568
568
  #
569
569
  # @note Stability Level: development
570
570
  K8S_NODE_CPU_ALLOCATABLE = 'k8s.node.cpu.allocatable'
@@ -576,9 +576,9 @@ module OpenTelemetry
576
576
  # @note Stability Level: release_candidate
577
577
  K8S_NODE_CPU_TIME = 'k8s.node.cpu.time'
578
578
 
579
- # Node's CPU usage, measured in cpus. Range from 0 to the number of allocatable CPUs.
579
+ # Node's CPU usage, measured in CPUs. Range from 0 to the number of allocatable CPUs.
580
580
  #
581
- # CPU usage of the specific Node on all available CPU cores, averaged over the sample window
581
+ # 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
582
  #
583
583
  # @note Stability Level: development
584
584
  K8S_NODE_CPU_USAGE = 'k8s.node.cpu.usage'
@@ -608,6 +608,26 @@ module OpenTelemetry
608
608
  # @note Stability Level: development
609
609
  K8S_NODE_FILESYSTEM_CAPACITY = 'k8s.node.filesystem.capacity'
610
610
 
611
+ # The total inodes in the node's root filesystem.
612
+ #
613
+ # 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)
616
+ # of the Kubelet's stats API.
617
+ #
618
+ # @note Stability Level: development
619
+ K8S_NODE_FILESYSTEM_INODE_COUNT = 'k8s.node.filesystem.inode.count'
620
+
621
+ # The free inodes in the node's root filesystem.
622
+ #
623
+ # 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)
626
+ # of the Kubelet's stats API.
627
+ #
628
+ # @note Stability Level: development
629
+ K8S_NODE_FILESYSTEM_INODE_FREE = 'k8s.node.filesystem.inode.free'
630
+
611
631
  # Node filesystem usage.
612
632
  #
613
633
  # This may not equal capacity - available.
@@ -630,15 +650,16 @@ module OpenTelemetry
630
650
  # Available memory for use. This is defined as the memory limit - workingSetBytes. If memory limit is undefined, the available bytes is omitted.
631
651
  # 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
652
  #
633
- # @note Stability Level: development
653
+ # @note Stability Level: release_candidate
634
654
  K8S_NODE_MEMORY_AVAILABLE = 'k8s.node.memory.available'
635
655
 
636
- # Node memory paging faults.
656
+ # Deprecated, use `k8s.node.paging.faults` instead.
637
657
  #
638
658
  # Cumulative number of major/minor page faults.
639
659
  # 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
660
  #
641
661
  # @note Stability Level: development
662
+ # @deprecated Replaced by `k8s.node.paging.faults`.
642
663
  K8S_NODE_MEMORY_PAGING_FAULTS = 'k8s.node.memory.paging.faults'
643
664
 
644
665
  # Node memory RSS.
@@ -646,14 +667,15 @@ module OpenTelemetry
646
667
  # The amount of anonymous and swap cache memory (includes transparent hugepages).
647
668
  # 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
669
  #
649
- # @note Stability Level: development
670
+ # @note Stability Level: release_candidate
650
671
  K8S_NODE_MEMORY_RSS = 'k8s.node.memory.rss'
651
672
 
652
673
  # Memory usage of the Node.
653
674
  #
654
- # Total memory usage of the Node
675
+ # Total memory in use. This includes all memory regardless of when it was accessed.
676
+ # 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
677
  #
656
- # @note Stability Level: development
678
+ # @note Stability Level: release_candidate
657
679
  K8S_NODE_MEMORY_USAGE = 'k8s.node.memory.usage'
658
680
 
659
681
  # Node memory working set.
@@ -661,7 +683,7 @@ module OpenTelemetry
661
683
  # The amount of working set memory. This includes recently accessed memory, dirty memory, and kernel memory. WorkingSetBytes is <= UsageBytes.
662
684
  # 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
685
  #
664
- # @note Stability Level: development
686
+ # @note Stability Level: release_candidate
665
687
  K8S_NODE_MEMORY_WORKING_SET = 'k8s.node.memory.working_set'
666
688
 
667
689
  # Node network errors.
@@ -674,6 +696,14 @@ module OpenTelemetry
674
696
  # @note Stability Level: development
675
697
  K8S_NODE_NETWORK_IO = 'k8s.node.network.io'
676
698
 
699
+ # Node memory paging faults.
700
+ #
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.
703
+ #
704
+ # @note Stability Level: development
705
+ K8S_NODE_PAGING_FAULTS = 'k8s.node.paging.faults'
706
+
677
707
  # Amount of pods allocatable on the node.
678
708
  #
679
709
  # @note Stability Level: development
@@ -686,9 +716,9 @@ module OpenTelemetry
686
716
  # @note Stability Level: development
687
717
  K8S_NODE_SYSTEM_CONTAINER_CPU_TIME = 'k8s.node.system_container.cpu.time'
688
718
 
689
- # Node's system container CPU usage, measured in cpus.
719
+ # Node's system container CPU usage, measured in CPUs.
690
720
  #
691
- # This metric is derived from the [CPUStats.UsageNanoCores](https://github.com/kubernetes/kubelet/blob/v0.35.2/pkg/apis/stats/v1alpha1/types.go#L233) field of the [ContainerStats](https://github.com/kubernetes/kubelet/blob/v0.35.2/pkg/apis/stats/v1alpha1/types.go#L157C6-L157C20) of [Node.SystemContainers](https://github.com/kubernetes/kubelet/blob/v0.35.2/pkg/apis/stats/v1alpha1/types.go#L40) of the Kubelet's stats API.
721
+ # 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
722
  #
693
723
  # @note Stability Level: development
694
724
  K8S_NODE_SYSTEM_CONTAINER_CPU_USAGE = 'k8s.node.system_container.cpu.usage'
@@ -763,9 +793,9 @@ module OpenTelemetry
763
793
  # @note Stability Level: release_candidate
764
794
  K8S_POD_CPU_TIME = 'k8s.pod.cpu.time'
765
795
 
766
- # Pod's CPU usage, measured in cpus. Range from 0 to the number of allocatable CPUs.
796
+ # Pod's CPU usage, measured in CPUs. Range from 0 to the number of allocatable CPUs.
767
797
  #
768
- # CPU usage of the specific Pod on all available CPU cores, averaged over the sample window
798
+ # 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
799
  #
770
800
  # @note Stability Level: development
771
801
  K8S_POD_CPU_USAGE = 'k8s.pod.cpu.usage'
@@ -807,15 +837,16 @@ module OpenTelemetry
807
837
  # Available memory for use. This is defined as the memory limit - workingSetBytes. If memory limit is undefined, the available bytes is omitted.
808
838
  # 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
839
  #
810
- # @note Stability Level: development
840
+ # @note Stability Level: release_candidate
811
841
  K8S_POD_MEMORY_AVAILABLE = 'k8s.pod.memory.available'
812
842
 
813
- # Pod memory paging faults.
843
+ # Deprecated, use `k8s.pod.paging.faults` instead.
814
844
  #
815
845
  # Cumulative number of major/minor page faults.
816
846
  # 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
847
  #
818
848
  # @note Stability Level: development
849
+ # @deprecated Replaced by `k8s.pod.paging.faults`.
819
850
  K8S_POD_MEMORY_PAGING_FAULTS = 'k8s.pod.memory.paging.faults'
820
851
 
821
852
  # Pod memory RSS.
@@ -823,14 +854,15 @@ module OpenTelemetry
823
854
  # The amount of anonymous and swap cache memory (includes transparent hugepages).
824
855
  # 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
856
  #
826
- # @note Stability Level: development
857
+ # @note Stability Level: release_candidate
827
858
  K8S_POD_MEMORY_RSS = 'k8s.pod.memory.rss'
828
859
 
829
860
  # Memory usage of the Pod.
830
861
  #
831
- # Total memory usage of the Pod
862
+ # Total memory in use. This includes all memory regardless of when it was accessed.
863
+ # 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
864
  #
833
- # @note Stability Level: development
865
+ # @note Stability Level: release_candidate
834
866
  K8S_POD_MEMORY_USAGE = 'k8s.pod.memory.usage'
835
867
 
836
868
  # Pod memory working set.
@@ -838,7 +870,7 @@ module OpenTelemetry
838
870
  # The amount of working set memory. This includes recently accessed memory, dirty memory, and kernel memory. WorkingSetBytes is <= UsageBytes.
839
871
  # 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
872
  #
841
- # @note Stability Level: development
873
+ # @note Stability Level: release_candidate
842
874
  K8S_POD_MEMORY_WORKING_SET = 'k8s.pod.memory.working_set'
843
875
 
844
876
  # Pod network errors.
@@ -851,6 +883,14 @@ module OpenTelemetry
851
883
  # @note Stability Level: development
852
884
  K8S_POD_NETWORK_IO = 'k8s.pod.network.io'
853
885
 
886
+ # Pod memory paging faults.
887
+ #
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.
890
+ #
891
+ # @note Stability Level: development
892
+ K8S_POD_PAGING_FAULTS = 'k8s.pod.paging.faults'
893
+
854
894
  # Describes number of K8s Pods that are currently in a given phase.
855
895
  #
856
896
  # All possible pod phases will be reported at each time interval to avoid missing metrics.
@@ -58,8 +58,8 @@ module OpenTelemetry
58
58
 
59
59
  # A unique identifier for the Log Record.
60
60
  #
61
- # If an id is provided, other log records with the same id will be considered duplicates and can be removed safely. This means, that two distinguishable log records MUST have different values.
62
- # The id MAY be an [Universally Unique Lexicographically Sortable Identifier (ULID)](https://github.com/ulid/spec), but other identifiers (e.g. UUID) may be used as needed.
61
+ # If an ID is provided, other log records with the same ID will be considered duplicates and can be removed safely. This means, that two distinguishable log records MUST have different values.
62
+ # The ID MAY be an [Universally Unique Lexicographically Sortable Identifier (ULID)](https://github.com/ulid/spec), but other identifiers (e.g. UUID) may be used as needed.
63
63
  #
64
64
  # @note Stability Level: development
65
65
  LOG_RECORD_UID = 'log.record.uid'
@@ -36,7 +36,7 @@ module OpenTelemetry
36
36
  # @deprecated Moved to the [OpenTelemetry GenAI semantic conventions repository](https://github.com/open-telemetry/semantic-conventions-genai).
37
37
  MCP_PROTOCOL_VERSION = 'mcp.protocol.version'
38
38
 
39
- # The value of the resource uri.
39
+ # The value of the resource URI.
40
40
  #
41
41
  # This is a URI of the resource provided in the following requests or notifications: `resources/read`, `resources/subscribe`, `resources/unsubscribe`, or `notifications/resources/updated`.
42
42
  #
@@ -50,8 +50,8 @@ module OpenTelemetry
50
50
 
51
51
  # The message destination name
52
52
  #
53
- # Destination name SHOULD uniquely identify a specific queue, topic or other entity within the broker. If
54
- # the broker doesn't have such notion, the destination name SHOULD uniquely identify the broker.
53
+ # SHOULD uniquely identify a specific queue, topic or other entity within the broker. If
54
+ # the broker doesn't have such notion, it SHOULD uniquely identify the broker.
55
55
  #
56
56
  # @note Stability Level: development
57
57
  MESSAGING_DESTINATION_NAME = 'messaging.destination.name'
@@ -70,7 +70,7 @@ module OpenTelemetry
70
70
 
71
71
  # Low cardinality representation of the messaging destination name
72
72
  #
73
- # Destination names could be constructed from templates. An example would be a destination name involving a user name or product id. Although the destination name in this case is of high cardinality, the underlying template is of low cardinality and can be effectively used for grouping and aggregation.
73
+ # Destination names could be constructed from templates. An example would be a destination name involving a username or product ID. Although the destination name in this case is of high cardinality, the underlying template is of low cardinality and can be effectively used for grouping and aggregation.
74
74
  #
75
75
  # @note Stability Level: development
76
76
  MESSAGING_DESTINATION_TEMPLATE = 'messaging.destination.template'
@@ -108,7 +108,7 @@ module OpenTelemetry
108
108
  # @note Stability Level: development
109
109
  MESSAGING_GCP_PUBSUB_MESSAGE_ACK_DEADLINE = 'messaging.gcp_pubsub.message.ack_deadline'
110
110
 
111
- # The ack id for a given message.
111
+ # The ack ID for a given message.
112
112
  #
113
113
  # @note Stability Level: development
114
114
  MESSAGING_GCP_PUBSUB_MESSAGE_ACK_ID = 'messaging.gcp_pubsub.message.ack_id'
@@ -123,6 +123,13 @@ module OpenTelemetry
123
123
  # @note Stability Level: development
124
124
  MESSAGING_GCP_PUBSUB_MESSAGE_ORDERING_KEY = 'messaging.gcp_pubsub.message.ordering_key'
125
125
 
126
+ # The Kafka cluster ID, obtained from the broker metadata exposed through the Kafka client (or AdminClient) API.
127
+ #
128
+ # The cluster ID is a unique identifier reported by the Kafka broker. It identifies the cluster independently of the individual brokers the client is configured to connect to, and remains stable even if broker hostnames, IP addresses, or ports change.
129
+ #
130
+ # @note Stability Level: development
131
+ MESSAGING_KAFKA_CLUSTER_ID = 'messaging.kafka.cluster.id'
132
+
126
133
  # Deprecated, use `messaging.consumer.group.name` instead.
127
134
  #
128
135
  # @note Stability Level: development
@@ -132,7 +139,7 @@ module OpenTelemetry
132
139
  # Deprecated, use `messaging.destination.partition.id` instead.
133
140
  #
134
141
  # @note Stability Level: development
135
- # @deprecated Record string representation of the partition id in `messaging.destination.partition.id` attribute.
142
+ # @deprecated Record string representation of the partition ID in `messaging.destination.partition.id` attribute.
136
143
  MESSAGING_KAFKA_DESTINATION_PARTITION = 'messaging.kafka.destination.partition'
137
144
 
138
145
  # Message keys in Kafka are used for grouping alike messages to ensure they're processed on the same partition. They differ from `messaging.message.id` in that they're not unique. If the key is `null`, the attribute MUST NOT be set.
@@ -238,7 +245,7 @@ module OpenTelemetry
238
245
  # @note Stability Level: development
239
246
  MESSAGING_ROCKETMQ_MESSAGE_GROUP = 'messaging.rocketmq.message.group'
240
247
 
241
- # Key(s) of message, another way to mark message besides message id.
248
+ # Key(s) of message, another way to mark message besides message ID.
242
249
  #
243
250
  # @note Stability Level: development
244
251
  MESSAGING_ROCKETMQ_MESSAGE_KEYS = 'messaging.rocketmq.message.keys'
@@ -51,7 +51,7 @@ module OpenTelemetry
51
51
  # @note Stability Level: development
52
52
  NETWORK_CONNECTION_STATE = 'network.connection.state'
53
53
 
54
- # This describes more details regarding the connection.type. It may be the type of cell technology connection, but it could be used for describing details about a wifi connection.
54
+ # This describes more details regarding the connection.type. It may be the type of cell technology connection, but it could be used for describing details about a Wi-Fi connection.
55
55
  #
56
56
  # @note Stability Level: development
57
57
  NETWORK_CONNECTION_SUBTYPE = 'network.connection.subtype'
@@ -63,7 +63,7 @@ module OpenTelemetry
63
63
 
64
64
  # The network interface name.
65
65
  #
66
- # @note Stability Level: development
66
+ # @note Stability Level: release_candidate
67
67
  NETWORK_INTERFACE_NAME = 'network.interface.name'
68
68
 
69
69
  # The direction of traffic from the perspective of the observing host's physical or virtual network interface. It should not be used to represent the logical direction of a stateful connection or network flow.
@@ -71,7 +71,7 @@ module OpenTelemetry
71
71
  # @note Stability Level: release_candidate
72
72
  NETWORK_IO_DIRECTION = 'network.io.direction'
73
73
 
74
- # Local address of the network connection - IP address or Unix domain socket name.
74
+ # Local address of the network connection - IP address or UNIX domain socket name.
75
75
  #
76
76
  # @note Stability Level: stable
77
77
  #
@@ -85,7 +85,7 @@ module OpenTelemetry
85
85
  # @deprecated Now available in the stable namespace at {OpenTelemetry::SemConv::NETWORK::NETWORK_LOCAL_PORT}.
86
86
  NETWORK_LOCAL_PORT = 'network.local.port'
87
87
 
88
- # Peer address of the network connection - IP address or Unix domain socket name.
88
+ # Peer address of the network connection - IP address or UNIX domain socket name.
89
89
  #
90
90
  # @note Stability Level: stable
91
91
  #
@@ -64,7 +64,7 @@ module OpenTelemetry
64
64
  # The service name currently associated with the database connection.
65
65
  #
66
66
  # The effective service name for a connection can change during its lifetime,
67
- # for example after executing sql, `ALTER SESSION`. If an instrumentation cannot reliably
67
+ # for example after executing SQL, `ALTER SESSION`. If an instrumentation cannot reliably
68
68
  # obtain the current service name for each operation without issuing an additional
69
69
  # query (such as `SELECT SYS_CONTEXT`), it is RECOMMENDED to fall back to the
70
70
  # service name originally provided at connection establishment.
@@ -66,8 +66,8 @@ module OpenTelemetry
66
66
 
67
67
  # The duration of exporting a batch of telemetry records.
68
68
  #
69
- # This metric defines successful operations using the full success definitions for [http](https://github.com/open-telemetry/opentelemetry-proto/blob/v1.5.0/docs/specification.md#full-success-1)
70
- # and [grpc](https://github.com/open-telemetry/opentelemetry-proto/blob/v1.5.0/docs/specification.md#full-success). Anything else is defined as an unsuccessful operation. For successful
69
+ # This metric defines successful operations using the full success definitions for [HTTP](https://github.com/open-telemetry/opentelemetry-proto/blob/v1.5.0/docs/specification.md#full-success-1)
70
+ # and [gRPC](https://github.com/open-telemetry/opentelemetry-proto/blob/v1.5.0/docs/specification.md#full-success). Anything else is defined as an unsuccessful operation. For successful
71
71
  # operations, `error.type` MUST NOT be set. For unsuccessful export operations, `error.type` MUST contain a relevant failure cause.
72
72
  # If the exporter retries failed export attempts, exactly one observation MUST be recorded per export operation,
73
73
  # covering the wall-clock duration from the start of the first attempt through the conclusion of the final attempt (including any backoff between attempts).
@@ -125,9 +125,14 @@ module OpenTelemetry
125
125
  #
126
126
  # For successful processing, `error.type` MUST NOT be set. For failed processing, `error.type` MUST contain the failure cause.
127
127
  # SDK Batching Log Record Processors MUST use `queue_full` as the value of `error.type` for log records dropped due to a full queue.
128
- # SDK Log Record Processors MUST use `already_shutdown` as the value of `error.type` for log records dropped because the processor has already been shut down.
129
- # For the SDK Simple and Batching Log Record Processor a log record is considered to be processed already when it has been submitted to the exporter,
130
- # not when the corresponding export call has finished.
128
+ # If a processor reports a log record dropped because it has already been shut down, `error.type` MUST be `already_shutdown`.
129
+ # Whether and when a processor drops such log records is governed by the SDK specification, not by this metric.
130
+ # For the SDK Simple and Batching Log Record Processors, a log record MUST be counted as successfully processed at the point the
131
+ # processor invokes the export operation. For batching processors, all log records in the batch passed to the exporter are counted
132
+ # at that point; log records accepted into the processor's queue but not yet passed to the exporter have not been processed.
133
+ # Implementations MUST NOT delay this count until the export operation concludes, and the outcome of the export operation,
134
+ # including an immediate failure of the invocation itself, MUST NOT affect this metric.
135
+ # Export outcomes are reported by `otel.sdk.exporter.log.exported`.
131
136
  #
132
137
  # @note Stability Level: development
133
138
  OTEL_SDK_PROCESSOR_LOG_PROCESSED = 'otel.sdk.processor.log.processed'
@@ -150,8 +155,14 @@ module OpenTelemetry
150
155
  #
151
156
  # For successful processing, `error.type` MUST NOT be set. For failed processing, `error.type` MUST contain the failure cause.
152
157
  # SDK Batching Span Processors MUST use `queue_full` as the value of `error.type` for spans dropped due to a full queue.
153
- # SDK Span Processors MUST use `already_shutdown` as the value of `error.type` for spans dropped because the processor has already been shut down.
154
- # For the SDK Simple and Batching Span Processor a span is considered to be processed already when it has been submitted to the exporter, not when the corresponding export call has finished.
158
+ # If a processor reports a span dropped because it has already been shut down, `error.type` MUST be `already_shutdown`.
159
+ # Whether and when a processor drops such spans is governed by the SDK specification, not by this metric.
160
+ # For the SDK Simple and Batching Span Processors, a span MUST be counted as successfully processed at the point the processor
161
+ # invokes the export operation. For batching processors, all spans in the batch passed to the exporter are counted at that point;
162
+ # spans accepted into the processor's queue but not yet passed to the exporter have not been processed.
163
+ # Implementations MUST NOT delay this count until the export operation concludes, and the outcome of the export operation,
164
+ # including an immediate failure of the invocation itself, MUST NOT affect this metric.
165
+ # Export outcomes are reported by `otel.sdk.exporter.span.exported`.
155
166
  #
156
167
  # @note Stability Level: development
157
168
  OTEL_SDK_PROCESSOR_SPAN_PROCESSED = 'otel.sdk.processor.span.processed'
@@ -61,12 +61,12 @@ module OpenTelemetry
61
61
  # @note Stability Level: development
62
62
  PPROF_PROFILE_DOC_URL = 'pprof.profile.doc_url'
63
63
 
64
- # Frames with Function.function_name fully matching the regexp will be dropped from the samples, along with their successors.
64
+ # Frames with Function.function_name fully matching the regular expression will be dropped from the samples, along with their successors.
65
65
  #
66
66
  # @note Stability Level: development
67
67
  PPROF_PROFILE_DROP_FRAMES = 'pprof.profile.drop_frames'
68
68
 
69
- # Frames with Function.function_name fully matching the regexp will be kept, even if it matches drop_frames.
69
+ # Frames with Function.function_name fully matching the regular expression will be kept, even if it matches drop_frames.
70
70
  #
71
71
  # @note Stability Level: development
72
72
  PPROF_PROFILE_KEEP_FRAMES = 'pprof.profile.keep_frames'
@@ -44,11 +44,21 @@ module OpenTelemetry
44
44
  # @note Stability Level: release_candidate
45
45
  PROCESS_DISK_IO = 'process.disk.io'
46
46
 
47
+ # Number of disk operations performed by the process.
48
+ #
49
+ # @note Stability Level: development
50
+ PROCESS_DISK_OPERATIONS = 'process.disk.operations'
51
+
47
52
  # The amount of physical memory in use.
48
53
  #
49
54
  # @note Stability Level: release_candidate
50
55
  PROCESS_MEMORY_USAGE = 'process.memory.usage'
51
56
 
57
+ # Percentage of total physical memory that is used by the process.
58
+ #
59
+ # @note Stability Level: development
60
+ PROCESS_MEMORY_UTILIZATION = 'process.memory.utilization'
61
+
52
62
  # The amount of committed virtual memory.
53
63
  #
54
64
  # @note Stability Level: release_candidate
@@ -70,12 +80,17 @@ module OpenTelemetry
70
80
  # @note Stability Level: release_candidate
71
81
  PROCESS_PAGING_FAULTS = 'process.paging.faults'
72
82
 
83
+ # Number of pending signals for the process.
84
+ #
85
+ # @note Stability Level: development
86
+ PROCESS_SIGNALS_PENDING = 'process.signals_pending'
87
+
73
88
  # Process threads count.
74
89
  #
75
90
  # @note Stability Level: release_candidate
76
91
  PROCESS_THREAD_COUNT = 'process.thread.count'
77
92
 
78
- # Number of unix file descriptors in use by the process.
93
+ # Number of UNIX file descriptors in use by the process.
79
94
  #
80
95
  # @note Stability Level: release_candidate
81
96
  PROCESS_UNIX_FILE_DESCRIPTOR_COUNT = 'process.unix.file_descriptor.count'
@@ -146,9 +146,7 @@ module OpenTelemetry
146
146
  # When the method is not recognized, for example, when the server receives
147
147
  # a request for a method that is not predefined on the server, or when
148
148
  # instrumentation is not able to reliably detect if the method is predefined,
149
- # the attribute MUST be set to `_OTHER`. In such cases, tracing
150
- # instrumentations MUST also set `rpc.method_original` attribute to
151
- # the original method value.
149
+ # the attribute MUST be set to `_OTHER`.
152
150
  #
153
151
  # If the RPC instrumentation could end up converting valid RPC methods to
154
152
  # `_OTHER`, then it SHOULD provide a way to configure the list of recognized
@@ -24,7 +24,7 @@ module OpenTelemetry
24
24
  module SERVER
25
25
  # @!group Attribute Names
26
26
 
27
- # Server domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name.
27
+ # Server domain name if available without reverse DNS lookup; otherwise, IP address or UNIX domain socket name.
28
28
  #
29
29
  # When observed from the client side, and when communicating through an intermediary, `server.address` SHOULD represent the server address behind any intermediaries, for example proxies, if it's available.
30
30
  #
@@ -24,7 +24,7 @@ module OpenTelemetry
24
24
  module SESSION
25
25
  # @!group Attribute Names
26
26
 
27
- # A unique id to identify a session.
27
+ # A unique ID to identify a session.
28
28
  #
29
29
  # @note Stability Level: development
30
30
  SESSION_ID = 'session.id'
@@ -24,7 +24,7 @@ module OpenTelemetry
24
24
  module SOURCE
25
25
  # @!group Attribute Names
26
26
 
27
- # Source address - domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name.
27
+ # Source address - domain name if available without reverse DNS lookup; otherwise, IP address or UNIX domain socket name.
28
28
  #
29
29
  # When observed from the destination side, and when communicating through an intermediary, `source.address` SHOULD represent the source address behind any intermediaries, for example proxies, if it's available.
30
30
  #
@@ -288,12 +288,12 @@ module OpenTelemetry
288
288
  # @note Stability Level: development
289
289
  SYSTEM_PAGING_OPERATIONS = 'system.paging.operations'
290
290
 
291
- # Unix swap or windows pagefile usage.
291
+ # UNIX swap or windows pagefile usage.
292
292
  #
293
293
  # @note Stability Level: development
294
294
  SYSTEM_PAGING_USAGE = 'system.paging.usage'
295
295
 
296
- # Swap (unix) or pagefile (windows) utilization.
296
+ # Swap (UNIX) or pagefile (windows) utilization.
297
297
  #
298
298
  # @note Stability Level: development
299
299
  SYSTEM_PAGING_UTILIZATION = 'system.paging.utilization'
@@ -308,6 +308,15 @@ module OpenTelemetry
308
308
  # @note Stability Level: development
309
309
  SYSTEM_PROCESS_CREATED = 'system.process.created'
310
310
 
311
+ # The maximum number of concurrent processes/tasks allowed by the operating system.
312
+ #
313
+ # On Linux, this corresponds to `/proc/sys/kernel/pid_max` or `/proc/sys/kernel/threads-max`.
314
+ # A per-user process limit may also be retrieved via `getrlimit(RLIMIT_NPROC)`.
315
+ # On BSD-like systems, this corresponds to `sysctl kern.maxproc`. This metric is unsupported on Windows systems.
316
+ #
317
+ # @note Stability Level: development
318
+ SYSTEM_PROCESS_LIMIT = 'system.process.limit'
319
+
311
320
  # The time the system has been running.
312
321
  #
313
322
  # Instrumentations SHOULD use a gauge with type `double` and measure uptime in seconds as a floating point number with the highest precision available.
@@ -33,7 +33,7 @@ module OpenTelemetry
33
33
 
34
34
  # The file extension extracted from the `url.full`, excluding the leading dot.
35
35
  #
36
- # The file extension is only set if it exists, as not every url has a file extension. When the file name has multiple extensions `example.tar.gz`, only the last one should be captured `gz`, not `tar.gz`.
36
+ # The file extension is only set if it exists, as not every URL has a file extension. When the filename has multiple extensions `example.tar.gz`, only the last one should be captured `gz`, not `tar.gz`.
37
37
  #
38
38
  # @note Stability Level: development
39
39
  URL_EXTENSION = 'url.extension'
@@ -141,7 +141,7 @@ module OpenTelemetry
141
141
  # @deprecated Now available in the stable namespace at {OpenTelemetry::SemConv::URL::URL_QUERY}.
142
142
  URL_QUERY = 'url.query'
143
143
 
144
- # The highest registered url domain, stripped of the subdomain.
144
+ # The highest registered URL domain, stripped of the subdomain.
145
145
  #
146
146
  # This value can be determined precisely with the [public suffix list](https://publicsuffix.org/). For example, the registered domain for `foo.example.com` is `example.com`. Trying to approximate this by simply taking the last two labels will not work well for TLDs such as `co.uk`.
147
147
  #
@@ -155,7 +155,7 @@ module OpenTelemetry
155
155
  # @deprecated Now available in the stable namespace at {OpenTelemetry::SemConv::URL::URL_SCHEME}.
156
156
  URL_SCHEME = 'url.scheme'
157
157
 
158
- # The subdomain portion of a fully qualified domain name includes all of the names except the host name under the registered_domain. In a partially qualified domain, or if the qualification level of the full name cannot be determined, subdomain contains all of the names below the registered domain.
158
+ # The subdomain portion of a fully qualified domain name includes all of the names except the hostname under the registered_domain. In a partially qualified domain, or if the qualification level of the full name cannot be determined, subdomain contains all of the names below the registered domain.
159
159
  #
160
160
  # The subdomain portion of `www.east.mydomain.co.uk` is `east`. If the domain has multiple levels of subdomain, such as `sub2.sub1.example.com`, the subdomain field should contain `sub2.sub1`, with no trailing period.
161
161
  #
@@ -23,7 +23,7 @@ module OpenTelemetry
23
23
  module NETWORK
24
24
  # @!group Attribute Names
25
25
 
26
- # Local address of the network connection - IP address or Unix domain socket name.
26
+ # Local address of the network connection - IP address or UNIX domain socket name.
27
27
  #
28
28
  # @note Stability Level: stable
29
29
  NETWORK_LOCAL_ADDRESS = 'network.local.address'
@@ -33,7 +33,7 @@ module OpenTelemetry
33
33
  # @note Stability Level: stable
34
34
  NETWORK_LOCAL_PORT = 'network.local.port'
35
35
 
36
- # Peer address of the network connection - IP address or Unix domain socket name.
36
+ # Peer address of the network connection - IP address or UNIX domain socket name.
37
37
  #
38
38
  # @note Stability Level: stable
39
39
  NETWORK_PEER_ADDRESS = 'network.peer.address'
@@ -23,7 +23,7 @@ module OpenTelemetry
23
23
  module SERVER
24
24
  # @!group Attribute Names
25
25
 
26
- # Server domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name.
26
+ # Server domain name if available without reverse DNS lookup; otherwise, IP address or UNIX domain socket name.
27
27
  #
28
28
  # When observed from the client side, and when communicating through an intermediary, `server.address` SHOULD represent the server address behind any intermediaries, for example proxies, if it's available.
29
29
  #
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: opentelemetry-semantic_conventions
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.43.0
4
+ version: 1.44.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - OpenTelemetry Authors
@@ -302,10 +302,10 @@ homepage: https://github.com/open-telemetry/opentelemetry-ruby
302
302
  licenses:
303
303
  - Apache-2.0
304
304
  metadata:
305
- changelog_uri: https://rubydoc.info/gems/opentelemetry-semantic_conventions/1.43.0/file/CHANGELOG.md
306
- source_code_uri: https://github.com/open-telemetry/opentelemetry-ruby/tree/opentelemetry-semantic_conventions/v1.43.0/semantic_conventions
305
+ changelog_uri: https://rubydoc.info/gems/opentelemetry-semantic_conventions/1.44.0/file/CHANGELOG.md
306
+ source_code_uri: https://github.com/open-telemetry/opentelemetry-ruby/tree/opentelemetry-semantic_conventions/v1.44.0/semantic_conventions
307
307
  bug_tracker_uri: https://github.com/open-telemetry/opentelemetry-ruby/issues
308
- documentation_uri: https://rubydoc.info/gems/opentelemetry-semantic_conventions/1.43.0
308
+ documentation_uri: https://rubydoc.info/gems/opentelemetry-semantic_conventions/1.44.0
309
309
  rdoc_options: []
310
310
  require_paths:
311
311
  - lib
@@ -320,7 +320,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
320
320
  - !ruby/object:Gem::Version
321
321
  version: '0'
322
322
  requirements: []
323
- rubygems_version: 4.0.10
323
+ rubygems_version: 4.0.16
324
324
  specification_version: 4
325
325
  summary: Semantic Convention definitions for OpenTelemetry
326
326
  test_files: []