opentelemetry-semantic_conventions 1.43.0 → 1.45.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (67) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +8 -0
  3. data/lib/opentelemetry/semantic_conventions/version.rb +2 -2
  4. data/lib/opentelemetry/semconv/client/attributes.rb +3 -3
  5. data/lib/opentelemetry/semconv/code/attributes.rb +1 -1
  6. data/lib/opentelemetry/semconv/container/attributes.rb +1 -1
  7. data/lib/opentelemetry/semconv/db/attributes.rb +16 -11
  8. data/lib/opentelemetry/semconv/incubating/android/attributes.rb +1 -1
  9. data/lib/opentelemetry/semconv/incubating/app/attributes.rb +1 -1
  10. data/lib/opentelemetry/semconv/incubating/artifact/attributes.rb +3 -3
  11. data/lib/opentelemetry/semconv/incubating/aws/attributes.rb +1 -1
  12. data/lib/opentelemetry/semconv/incubating/azure/attributes.rb +20 -0
  13. data/lib/opentelemetry/semconv/incubating/browser/attributes.rb +30 -0
  14. data/lib/opentelemetry/semconv/incubating/client/attributes.rb +73 -3
  15. data/lib/opentelemetry/semconv/incubating/cloudfoundry/attributes.rb +1 -1
  16. data/lib/opentelemetry/semconv/incubating/code/attributes.rb +1 -1
  17. data/lib/opentelemetry/semconv/incubating/container/attributes.rb +3 -3
  18. data/lib/opentelemetry/semconv/incubating/container/metrics.rb +40 -34
  19. data/lib/opentelemetry/semconv/incubating/cpu/attributes.rb +4 -2
  20. data/lib/opentelemetry/semconv/incubating/db/attributes.rb +24 -14
  21. data/lib/opentelemetry/semconv/incubating/db/metrics.rb +8 -2
  22. data/lib/opentelemetry/semconv/incubating/deployment/attributes.rb +1 -1
  23. data/lib/opentelemetry/semconv/incubating/destination/attributes.rb +53 -2
  24. data/lib/opentelemetry/semconv/incubating/enduser/attributes.rb +2 -0
  25. data/lib/opentelemetry/semconv/incubating/faas/attributes.rb +7 -3
  26. data/lib/opentelemetry/semconv/incubating/file/attributes.rb +3 -3
  27. data/lib/opentelemetry/semconv/incubating/gcp/attributes.rb +20 -0
  28. data/lib/opentelemetry/semconv/incubating/host/attributes.rb +61 -2
  29. data/lib/opentelemetry/semconv/incubating/http/attributes.rb +59 -0
  30. data/lib/opentelemetry/semconv/incubating/jvm/attributes.rb +24 -0
  31. data/lib/opentelemetry/semconv/incubating/jvm/metrics.rb +45 -2
  32. data/lib/opentelemetry/semconv/incubating/k8s/metrics.rb +315 -73
  33. data/lib/opentelemetry/semconv/incubating/kafka/attributes.rb +55 -0
  34. data/lib/opentelemetry/semconv/incubating/kafka.rb +21 -0
  35. data/lib/opentelemetry/semconv/incubating/log/attributes.rb +7 -7
  36. data/lib/opentelemetry/semconv/incubating/mcp/attributes.rb +1 -1
  37. data/lib/opentelemetry/semconv/incubating/messaging/attributes.rb +78 -29
  38. data/lib/opentelemetry/semconv/incubating/network/attributes.rb +107 -5
  39. data/lib/opentelemetry/semconv/incubating/opentracing/attributes.rb +1 -0
  40. data/lib/opentelemetry/semconv/incubating/oracle/attributes.rb +1 -1
  41. data/lib/opentelemetry/semconv/incubating/otel/metrics.rb +25 -8
  42. data/lib/opentelemetry/semconv/incubating/peer/attributes.rb +1 -1
  43. data/lib/opentelemetry/semconv/incubating/pprof/attributes.rb +2 -2
  44. data/lib/opentelemetry/semconv/incubating/process/metrics.rb +16 -1
  45. data/lib/opentelemetry/semconv/incubating/rabbitmq/attributes.rb +41 -0
  46. data/lib/opentelemetry/semconv/incubating/rabbitmq.rb +21 -0
  47. data/lib/opentelemetry/semconv/incubating/rocketmq/attributes.rb +71 -0
  48. data/lib/opentelemetry/semconv/incubating/rocketmq.rb +21 -0
  49. data/lib/opentelemetry/semconv/incubating/rpc/attributes.rb +111 -36
  50. data/lib/opentelemetry/semconv/incubating/rpc/metrics.rb +6 -2
  51. data/lib/opentelemetry/semconv/incubating/server/attributes.rb +71 -1
  52. data/lib/opentelemetry/semconv/incubating/service/attributes.rb +16 -0
  53. data/lib/opentelemetry/semconv/incubating/session/attributes.rb +1 -1
  54. data/lib/opentelemetry/semconv/incubating/source/attributes.rb +53 -2
  55. data/lib/opentelemetry/semconv/incubating/system/attributes.rb +15 -9
  56. data/lib/opentelemetry/semconv/incubating/system/metrics.rb +18 -5
  57. data/lib/opentelemetry/semconv/incubating/url/attributes.rb +15 -3
  58. data/lib/opentelemetry/semconv/incubating/v8js/attributes.rb +2 -1
  59. data/lib/opentelemetry/semconv/incubating/zos/attributes.rb +4 -2
  60. data/lib/opentelemetry/semconv/network/attributes.rb +2 -2
  61. data/lib/opentelemetry/semconv/rpc/attributes.rb +77 -0
  62. data/lib/opentelemetry/semconv/rpc/metrics.rb +45 -0
  63. data/lib/opentelemetry/semconv/rpc.rb +22 -0
  64. data/lib/opentelemetry/semconv/server/attributes.rb +1 -1
  65. data/lib/opentelemetry/semconv/url/attributes.rb +12 -0
  66. data/lib/opentelemetry/semconv.rb +4 -0
  67. metadata +14 -5
@@ -0,0 +1,55 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright The OpenTelemetry Authors
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # http://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+ #
17
+ # SPDX-License-Identifier: Apache-2.0
18
+ #
19
+ # This file was autogenerated. Do not edit it by hand.
20
+
21
+ module OpenTelemetry
22
+ module SemConv
23
+ module Incubating
24
+ module KAFKA
25
+ # @!group Attribute Names
26
+
27
+ # The Kafka cluster ID, obtained from the broker metadata exposed through the Kafka client (or AdminClient) API.
28
+ #
29
+ # 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.
30
+ #
31
+ # @note Stability Level: development
32
+ KAFKA_CLUSTER_ID = 'kafka.cluster.id'
33
+
34
+ # 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.
35
+ #
36
+ # If the key type is not string, its string representation has to be supplied for the attribute. If the key has no unambiguous, canonical string form, don't include its value.
37
+ #
38
+ # @note Stability Level: development
39
+ KAFKA_MESSAGE_KEY = 'kafka.message.key'
40
+
41
+ # A boolean that is true if the message is a tombstone.
42
+ #
43
+ # @note Stability Level: development
44
+ KAFKA_MESSAGE_TOMBSTONE = 'kafka.message.tombstone'
45
+
46
+ # The offset of a record in the corresponding Kafka partition.
47
+ #
48
+ # @note Stability Level: development
49
+ KAFKA_OFFSET = 'kafka.offset'
50
+
51
+ # @!endgroup
52
+ end
53
+ end
54
+ end
55
+ end
@@ -0,0 +1,21 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright The OpenTelemetry Authors
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # http://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+ #
17
+ # SPDX-License-Identifier: Apache-2.0
18
+
19
+ # This file was autogenerated. Do not edit it by hand.
20
+
21
+ require_relative 'kafka/attributes'
@@ -24,27 +24,27 @@ module OpenTelemetry
24
24
  module LOG
25
25
  # @!group Attribute Names
26
26
 
27
- # The basename of the file.
27
+ # The basename of the file to which the log record was emitted.
28
28
  #
29
29
  # @note Stability Level: development
30
30
  LOG_FILE_NAME = 'log.file.name'
31
31
 
32
- # The basename of the file, with symlinks resolved.
32
+ # The basename of the file to which the log record was emitted, with symlinks resolved.
33
33
  #
34
34
  # @note Stability Level: development
35
35
  LOG_FILE_NAME_RESOLVED = 'log.file.name_resolved'
36
36
 
37
- # The full path to the file.
37
+ # The full path to the file to which the log record was emitted.
38
38
  #
39
39
  # @note Stability Level: development
40
40
  LOG_FILE_PATH = 'log.file.path'
41
41
 
42
- # The full path to the file, with symlinks resolved.
42
+ # The full path to the file to which the log record was emitted, with symlinks resolved.
43
43
  #
44
44
  # @note Stability Level: development
45
45
  LOG_FILE_PATH_RESOLVED = 'log.file.path_resolved'
46
46
 
47
- # The stream associated with the log. See below for a list of well-known values.
47
+ # The stream the log record was emitted to.
48
48
  #
49
49
  # @note Stability Level: development
50
50
  LOG_IOSTREAM = 'log.iostream'
@@ -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'
@@ -98,31 +98,44 @@ module OpenTelemetry
98
98
  # @deprecated Replaced by `messaging.consumer.group.name`.
99
99
  MESSAGING_EVENTHUBS_CONSUMER_GROUP = 'messaging.eventhubs.consumer.group'
100
100
 
101
- # The UTC epoch seconds at which the message has been accepted and stored in the entity.
101
+ # Deprecated, use `azure.eventhubs.message.enqueued_time` instead.
102
102
  #
103
103
  # @note Stability Level: development
104
+ # @deprecated Replaced by `azure.eventhubs.message.enqueued_time`.
104
105
  MESSAGING_EVENTHUBS_MESSAGE_ENQUEUED_TIME = 'messaging.eventhubs.message.enqueued_time'
105
106
 
106
- # The ack deadline in seconds set for the modify ack deadline request.
107
+ # Deprecated, use `gcp.pubsub.message.ack_deadline` instead.
107
108
  #
108
109
  # @note Stability Level: development
110
+ # @deprecated Replaced by `gcp.pubsub.message.ack_deadline`.
109
111
  MESSAGING_GCP_PUBSUB_MESSAGE_ACK_DEADLINE = 'messaging.gcp_pubsub.message.ack_deadline'
110
112
 
111
- # The ack id for a given message.
113
+ # Deprecated, use `gcp.pubsub.message.ack_id` instead.
112
114
  #
113
115
  # @note Stability Level: development
116
+ # @deprecated Replaced by `gcp.pubsub.message.ack_id`.
114
117
  MESSAGING_GCP_PUBSUB_MESSAGE_ACK_ID = 'messaging.gcp_pubsub.message.ack_id'
115
118
 
116
- # The delivery attempt for a given message.
119
+ # Deprecated, use `gcp.pubsub.message.delivery_attempt` instead.
117
120
  #
118
121
  # @note Stability Level: development
122
+ # @deprecated Replaced by `gcp.pubsub.message.delivery_attempt`.
119
123
  MESSAGING_GCP_PUBSUB_MESSAGE_DELIVERY_ATTEMPT = 'messaging.gcp_pubsub.message.delivery_attempt'
120
124
 
121
- # The ordering key for a given message. If the attribute is not present, the message does not have an ordering key.
125
+ # Deprecated, use `gcp.pubsub.message.ordering_key` instead.
122
126
  #
123
127
  # @note Stability Level: development
128
+ # @deprecated Replaced by `gcp.pubsub.message.ordering_key`.
124
129
  MESSAGING_GCP_PUBSUB_MESSAGE_ORDERING_KEY = 'messaging.gcp_pubsub.message.ordering_key'
125
130
 
131
+ # Deprecated, use `kafka.cluster.id` instead.
132
+ #
133
+ # 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.
134
+ #
135
+ # @note Stability Level: development
136
+ # @deprecated Replaced by `kafka.cluster.id`.
137
+ MESSAGING_KAFKA_CLUSTER_ID = 'messaging.kafka.cluster.id'
138
+
126
139
  # Deprecated, use `messaging.consumer.group.name` instead.
127
140
  #
128
141
  # @note Stability Level: development
@@ -132,30 +145,33 @@ module OpenTelemetry
132
145
  # Deprecated, use `messaging.destination.partition.id` instead.
133
146
  #
134
147
  # @note Stability Level: development
135
- # @deprecated Record string representation of the partition id in `messaging.destination.partition.id` attribute.
148
+ # @deprecated Record string representation of the partition ID in `messaging.destination.partition.id` attribute.
136
149
  MESSAGING_KAFKA_DESTINATION_PARTITION = 'messaging.kafka.destination.partition'
137
150
 
138
- # 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.
151
+ # Deprecated, use `kafka.message.key` instead.
139
152
  #
140
153
  # If the key type is not string, it's string representation has to be supplied for the attribute. If the key has no unambiguous, canonical string form, don't include its value.
141
154
  #
142
155
  # @note Stability Level: development
156
+ # @deprecated Replaced by `kafka.message.key`.
143
157
  MESSAGING_KAFKA_MESSAGE_KEY = 'messaging.kafka.message.key'
144
158
 
145
- # Deprecated, use `messaging.kafka.offset` instead.
159
+ # Deprecated, use `kafka.offset` instead.
146
160
  #
147
161
  # @note Stability Level: development
148
- # @deprecated Replaced by `messaging.kafka.offset`.
162
+ # @deprecated Replaced by `kafka.offset`.
149
163
  MESSAGING_KAFKA_MESSAGE_OFFSET = 'messaging.kafka.message.offset'
150
164
 
151
- # A boolean that is true if the message is a tombstone.
165
+ # Deprecated, use `kafka.message.tombstone` instead.
152
166
  #
153
167
  # @note Stability Level: development
168
+ # @deprecated Replaced by `kafka.message.tombstone`.
154
169
  MESSAGING_KAFKA_MESSAGE_TOMBSTONE = 'messaging.kafka.message.tombstone'
155
170
 
156
- # The offset of a record in the corresponding Kafka partition.
171
+ # Deprecated, use `kafka.offset` instead.
157
172
  #
158
173
  # @note Stability Level: development
174
+ # @deprecated Replaced by `kafka.offset`.
159
175
  MESSAGING_KAFKA_OFFSET = 'messaging.kafka.offset'
160
176
 
161
177
  # The size of the message body in bytes.
@@ -202,14 +218,16 @@ module OpenTelemetry
202
218
  # @note Stability Level: development
203
219
  MESSAGING_OPERATION_TYPE = 'messaging.operation.type'
204
220
 
205
- # RabbitMQ message routing key.
221
+ # Deprecated, use `rabbitmq.destination.routing_key` instead.
206
222
  #
207
223
  # @note Stability Level: development
224
+ # @deprecated Replaced by `rabbitmq.destination.routing_key`.
208
225
  MESSAGING_RABBITMQ_DESTINATION_ROUTING_KEY = 'messaging.rabbitmq.destination.routing_key'
209
226
 
210
- # RabbitMQ message delivery tag
227
+ # Deprecated, use `rabbitmq.message.delivery_tag` instead.
211
228
  #
212
229
  # @note Stability Level: development
230
+ # @deprecated Replaced by `rabbitmq.message.delivery_tag`.
213
231
  MESSAGING_RABBITMQ_MESSAGE_DELIVERY_TAG = 'messaging.rabbitmq.message.delivery_tag'
214
232
 
215
233
  # Deprecated, use `messaging.consumer.group.name` instead.
@@ -218,44 +236,52 @@ module OpenTelemetry
218
236
  # @deprecated Replaced by `messaging.consumer.group.name` on the consumer spans. No replacement for producer spans.
219
237
  MESSAGING_ROCKETMQ_CLIENT_GROUP = 'messaging.rocketmq.client_group'
220
238
 
221
- # Model of message consumption. This only applies to consumer spans.
239
+ # Deprecated, use `rocketmq.consumption_model` instead.
222
240
  #
223
241
  # @note Stability Level: development
242
+ # @deprecated Replaced by `rocketmq.consumption_model`.
224
243
  MESSAGING_ROCKETMQ_CONSUMPTION_MODEL = 'messaging.rocketmq.consumption_model'
225
244
 
226
- # The delay time level for delay message, which determines the message delay time.
245
+ # Deprecated, use `rocketmq.message.delay_time_level` instead.
227
246
  #
228
247
  # @note Stability Level: development
248
+ # @deprecated Replaced by `rocketmq.message.delay_time_level`.
229
249
  MESSAGING_ROCKETMQ_MESSAGE_DELAY_TIME_LEVEL = 'messaging.rocketmq.message.delay_time_level'
230
250
 
231
- # The timestamp in milliseconds that the delay message is expected to be delivered to consumer.
251
+ # Deprecated, use `rocketmq.message.delivery_timestamp` instead.
232
252
  #
233
253
  # @note Stability Level: development
254
+ # @deprecated Replaced by `rocketmq.message.delivery_timestamp`.
234
255
  MESSAGING_ROCKETMQ_MESSAGE_DELIVERY_TIMESTAMP = 'messaging.rocketmq.message.delivery_timestamp'
235
256
 
236
- # It is essential for FIFO message. Messages that belong to the same message group are always processed one by one within the same consumer group.
257
+ # Deprecated, use `rocketmq.message.group` instead.
237
258
  #
238
259
  # @note Stability Level: development
260
+ # @deprecated Replaced by `rocketmq.message.group`.
239
261
  MESSAGING_ROCKETMQ_MESSAGE_GROUP = 'messaging.rocketmq.message.group'
240
262
 
241
- # Key(s) of message, another way to mark message besides message id.
263
+ # Deprecated, use `rocketmq.message.keys` instead.
242
264
  #
243
265
  # @note Stability Level: development
266
+ # @deprecated Replaced by `rocketmq.message.keys`.
244
267
  MESSAGING_ROCKETMQ_MESSAGE_KEYS = 'messaging.rocketmq.message.keys'
245
268
 
246
- # The secondary classifier of message besides topic.
269
+ # Deprecated, use `rocketmq.message.tag` instead.
247
270
  #
248
271
  # @note Stability Level: development
272
+ # @deprecated Replaced by `rocketmq.message.tag`.
249
273
  MESSAGING_ROCKETMQ_MESSAGE_TAG = 'messaging.rocketmq.message.tag'
250
274
 
251
- # Type of message.
275
+ # Deprecated, use `rocketmq.message.type` instead.
252
276
  #
253
277
  # @note Stability Level: development
278
+ # @deprecated Replaced by `rocketmq.message.type`.
254
279
  MESSAGING_ROCKETMQ_MESSAGE_TYPE = 'messaging.rocketmq.message.type'
255
280
 
256
- # Namespace of RocketMQ resources, resources in different namespaces are individual.
281
+ # Deprecated, use `rocketmq.namespace` instead.
257
282
  #
258
283
  # @note Stability Level: development
284
+ # @deprecated Replaced by `rocketmq.namespace`.
259
285
  MESSAGING_ROCKETMQ_NAMESPACE = 'messaging.rocketmq.namespace'
260
286
 
261
287
  # Deprecated, use `messaging.destination.subscription.name` instead.
@@ -264,28 +290,51 @@ module OpenTelemetry
264
290
  # @deprecated Replaced by `messaging.destination.subscription.name`.
265
291
  MESSAGING_SERVICEBUS_DESTINATION_SUBSCRIPTION_NAME = 'messaging.servicebus.destination.subscription_name'
266
292
 
267
- # Describes the [settlement type](https://learn.microsoft.com/azure/service-bus-messaging/message-transfers-locks-settlement#peeklock).
293
+ # Deprecated, use `azure.servicebus.disposition_status` instead.
268
294
  #
269
295
  # @note Stability Level: development
296
+ # @deprecated Replaced by `azure.servicebus.disposition_status`.
270
297
  MESSAGING_SERVICEBUS_DISPOSITION_STATUS = 'messaging.servicebus.disposition_status'
271
298
 
272
- # Number of deliveries that have been attempted for this message.
299
+ # Deprecated, use `azure.servicebus.message.delivery_count` instead.
273
300
  #
274
301
  # @note Stability Level: development
302
+ # @deprecated Replaced by `azure.servicebus.message.delivery_count`.
275
303
  MESSAGING_SERVICEBUS_MESSAGE_DELIVERY_COUNT = 'messaging.servicebus.message.delivery_count'
276
304
 
277
- # The UTC epoch seconds at which the message has been accepted and stored in the entity.
305
+ # Deprecated, use `azure.servicebus.message.enqueued_time` instead.
278
306
  #
279
307
  # @note Stability Level: development
308
+ # @deprecated Replaced by `azure.servicebus.message.enqueued_time`.
280
309
  MESSAGING_SERVICEBUS_MESSAGE_ENQUEUED_TIME = 'messaging.servicebus.message.enqueued_time'
281
310
 
282
- # The messaging system as identified by the client instrumentation.
311
+ # Deprecated, use `messaging.system.name` instead.
312
+ #
313
+ # The actual messaging system may differ from the one known by the client.
314
+ # For example, when using Kafka client libraries to communicate with Azure Event Hubs, the `messaging.system`
315
+ # is set to `kafka` based on the instrumentation's best knowledge.
316
+ #
317
+ # When migrating to `messaging.system.name`, update the following values:
283
318
  #
284
- # The actual messaging system may differ from the one known by the client. For example, when using Kafka client libraries to communicate with Azure Event Hubs, the `messaging.system` is set to `kafka` based on the instrumentation's best knowledge.
319
+ # - `aws_sqs` to `aws.sqs`
320
+ # - `eventgrid` to `azure.eventgrid`
321
+ # - `eventhubs` to `azure.eventhubs`
322
+ # - `servicebus` to `azure.servicebus`
323
+ # - `gcp_pubsub` to `gcp.pubsub`
324
+ #
325
+ # All other values are unchanged.
285
326
  #
286
327
  # @note Stability Level: development
328
+ # @deprecated Replaced by `messaging.system.name`.
287
329
  MESSAGING_SYSTEM = 'messaging.system'
288
330
 
331
+ # The messaging system as identified by the client instrumentation.
332
+ #
333
+ # The actual messaging system may differ from the one known by the client. For example, when using Kafka client libraries to communicate with Azure Event Hubs, the `messaging.system.name` is set to `kafka` based on the instrumentation's best knowledge.
334
+ #
335
+ # @note Stability Level: development
336
+ MESSAGING_SYSTEM_NAME = 'messaging.system.name'
337
+
289
338
  # @!endgroup
290
339
  end
291
340
  end
@@ -48,10 +48,10 @@ module OpenTelemetry
48
48
  #
49
49
  # Connection states are defined as part of the [rfc9293](https://datatracker.ietf.org/doc/html/rfc9293#section-3.3.2)
50
50
  #
51
- # @note Stability Level: development
51
+ # @note Stability Level: release_candidate
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,13 +71,37 @@ 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
  #
78
78
  # @deprecated Now available in the stable namespace at {OpenTelemetry::SemConv::NETWORK::NETWORK_LOCAL_ADDRESS}.
79
79
  NETWORK_LOCAL_ADDRESS = 'network.local.address'
80
80
 
81
+ # The [Autonomous System Number (ASN)](https://www.iana.org/assignments/as-numbers/as-numbers.xhtml) associated with the local IP address.
82
+ #
83
+ # This attribute SHOULD only be set when the local address is an IP address and the ASN is available from routing, enrichment, or lookup data. The value SHOULD be represented as an integer without the `AS` prefix.
84
+ #
85
+ # @note Stability Level: development
86
+ NETWORK_LOCAL_AS_NUMBER = 'network.local.as.number'
87
+
88
+ # The name of the organization associated with the autonomous system of the local IP address.
89
+ #
90
+ # This attribute SHOULD only be set when `network.local.as.number` is set and the organization name is available. The value SHOULD be the organization name as provided by the lookup or enrichment source, not the AS name or short code.
91
+ #
92
+ # @note Stability Level: development
93
+ NETWORK_LOCAL_AS_ORGANIZATION = 'network.local.as.organization'
94
+
95
+ # Local Media Access Control (MAC) address of the network connection.
96
+ #
97
+ # MAC addresses MUST be represented in [IEEE RA hexadecimal form](https://standards.ieee.org/wp-content/uploads/import/documents/tutorials/eui.pdf):
98
+ # as hyphen-separated octets in uppercase hexadecimal form from most to least significant.
99
+ #
100
+ # > [!WARNING]> This attribute may contain sensitive (PII) information.
101
+ #
102
+ # @note Stability Level: development
103
+ NETWORK_LOCAL_MAC_ADDRESS = 'network.local.mac.address'
104
+
81
105
  # Local port number of the network connection.
82
106
  #
83
107
  # @note Stability Level: stable
@@ -85,13 +109,64 @@ module OpenTelemetry
85
109
  # @deprecated Now available in the stable namespace at {OpenTelemetry::SemConv::NETWORK::NETWORK_LOCAL_PORT}.
86
110
  NETWORK_LOCAL_PORT = 'network.local.port'
87
111
 
88
- # Peer address of the network connection - IP address or Unix domain socket name.
112
+ # The IP prefix associated with the local IP address, in CIDR notation.
113
+ #
114
+ # > [!WARNING]> This attribute may contain sensitive (PII) information. A `/32`> IPv4 prefix
115
+ # > or `/128`> IPv6 prefix preserves the complete endpoint IP address.
116
+ # > Using CIDR notation does not guarantee that the data is anonymous.
117
+ #
118
+ # The value MUST be an IPv4 or IPv6 network prefix in CIDR notation, as defined in
119
+ # [RFC 4632](https://www.rfc-editor.org/rfc/rfc4632.html) for IPv4 and
120
+ # [RFC 4291](https://www.rfc-editor.org/rfc/rfc4291.html#section-2.3) for IPv6.
121
+ # IPv4 prefixes MUST use a dotted-decimal address followed by `/` and a decimal
122
+ # prefix length from 0 to 32. IPv6 prefixes MUST use the canonical address text
123
+ # representation defined in [RFC 5952](https://www.rfc-editor.org/rfc/rfc5952.html),
124
+ # followed by `/` and a decimal prefix length from 0 to 128. All host bits in
125
+ # the address MUST be set to zero. The value MUST NOT contain a domain name,
126
+ # UNIX domain socket name, or IPv6 zone identifier.
127
+ #
128
+ # Instrumentation or Collector receivers that populate this attribute MUST
129
+ # convert native representations, such as an address and subnet mask or an
130
+ # address and prefix length, to equivalent CIDR notation before emitting it.
131
+ #
132
+ # This attribute MAY be set whether or not `network.local.address` is set. If
133
+ # `network.local.address` is also set to an IP address, it MUST use the same IP version
134
+ # and be contained in this prefix.
135
+ #
136
+ # @note Stability Level: development
137
+ NETWORK_LOCAL_PREFIX = 'network.local.prefix'
138
+
139
+ # Peer address of the network connection - IP address or UNIX domain socket name.
89
140
  #
90
141
  # @note Stability Level: stable
91
142
  #
92
143
  # @deprecated Now available in the stable namespace at {OpenTelemetry::SemConv::NETWORK::NETWORK_PEER_ADDRESS}.
93
144
  NETWORK_PEER_ADDRESS = 'network.peer.address'
94
145
 
146
+ # The [Autonomous System Number (ASN)](https://www.iana.org/assignments/as-numbers/as-numbers.xhtml) associated with the peer IP address.
147
+ #
148
+ # This attribute SHOULD only be set when the peer address is an IP address and the ASN is available from routing, enrichment, or lookup data. The value SHOULD be represented as an integer without the `AS` prefix.
149
+ #
150
+ # @note Stability Level: development
151
+ NETWORK_PEER_AS_NUMBER = 'network.peer.as.number'
152
+
153
+ # The name of the organization associated with the autonomous system of the peer IP address.
154
+ #
155
+ # This attribute SHOULD only be set when `network.peer.as.number` is set and the organization name is available. The value SHOULD be the organization name as provided by the lookup or enrichment source, not the AS name or short code.
156
+ #
157
+ # @note Stability Level: development
158
+ NETWORK_PEER_AS_ORGANIZATION = 'network.peer.as.organization'
159
+
160
+ # Peer Media Access Control (MAC) address of the network connection.
161
+ #
162
+ # MAC addresses MUST be represented in [IEEE RA hexadecimal form](https://standards.ieee.org/wp-content/uploads/import/documents/tutorials/eui.pdf):
163
+ # as hyphen-separated octets in uppercase hexadecimal form from most to least significant.
164
+ #
165
+ # > [!WARNING]> This attribute may contain sensitive (PII) information.
166
+ #
167
+ # @note Stability Level: development
168
+ NETWORK_PEER_MAC_ADDRESS = 'network.peer.mac.address'
169
+
95
170
  # Peer port number of the network connection.
96
171
  #
97
172
  # @note Stability Level: stable
@@ -99,6 +174,33 @@ module OpenTelemetry
99
174
  # @deprecated Now available in the stable namespace at {OpenTelemetry::SemConv::NETWORK::NETWORK_PEER_PORT}.
100
175
  NETWORK_PEER_PORT = 'network.peer.port'
101
176
 
177
+ # The IP prefix associated with the peer IP address, in CIDR notation.
178
+ #
179
+ # > [!WARNING]> This attribute may contain sensitive (PII) information. A `/32`> IPv4 prefix
180
+ # > or `/128`> IPv6 prefix preserves the complete endpoint IP address.
181
+ # > Using CIDR notation does not guarantee that the data is anonymous.
182
+ #
183
+ # The value MUST be an IPv4 or IPv6 network prefix in CIDR notation, as defined in
184
+ # [RFC 4632](https://www.rfc-editor.org/rfc/rfc4632.html) for IPv4 and
185
+ # [RFC 4291](https://www.rfc-editor.org/rfc/rfc4291.html#section-2.3) for IPv6.
186
+ # IPv4 prefixes MUST use a dotted-decimal address followed by `/` and a decimal
187
+ # prefix length from 0 to 32. IPv6 prefixes MUST use the canonical address text
188
+ # representation defined in [RFC 5952](https://www.rfc-editor.org/rfc/rfc5952.html),
189
+ # followed by `/` and a decimal prefix length from 0 to 128. All host bits in
190
+ # the address MUST be set to zero. The value MUST NOT contain a domain name,
191
+ # UNIX domain socket name, or IPv6 zone identifier.
192
+ #
193
+ # Instrumentation or Collector receivers that populate this attribute MUST
194
+ # convert native representations, such as an address and subnet mask or an
195
+ # address and prefix length, to equivalent CIDR notation before emitting it.
196
+ #
197
+ # This attribute MAY be set whether or not `network.peer.address` is set. If
198
+ # `network.peer.address` is also set to an IP address, it MUST use the same IP version
199
+ # and be contained in this prefix.
200
+ #
201
+ # @note Stability Level: development
202
+ NETWORK_PEER_PREFIX = 'network.peer.prefix'
203
+
102
204
  # [OSI application layer](https://wikipedia.org/wiki/Application_layer) or non-OSI equivalent.
103
205
  #
104
206
  # The value SHOULD be normalized to lowercase.
@@ -29,6 +29,7 @@ module OpenTelemetry
29
29
  # The causal relationship between a child Span and a parent Span.
30
30
  #
31
31
  # @note Stability Level: development
32
+ # @deprecated OpenTracing compatibility requirements are [deprecated in OpenTelemetry Specification](https://opentelemetry.io/docs/specs/otel/compatibility/opentracing/)
32
33
  OPENTRACING_REF_TYPE = 'opentracing.ref_type'
33
34
 
34
35
  # @!endgroup
@@ -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).
@@ -108,7 +108,13 @@ module OpenTelemetry
108
108
  # @deprecated Replaced by `otel.sdk.exporter.span.inflight`.
109
109
  OTEL_SDK_EXPORTER_SPAN_INFLIGHT_COUNT = 'otel.sdk.exporter.span.inflight.count'
110
110
 
111
- # The number of logs submitted to enabled SDK Loggers.
111
+ # The number of log records submitted to an enabled `Logger`.
112
+ #
113
+ # In OpenTelemetry SDKs a `Logger` is enabled by default, and can be disabled via configuration i.e. `LoggerConfig.enabled` = `false` when supported;
114
+ # a disabled `Logger` is a No-op: emitting to it has no effect, so its records are not counted.
115
+ # Every log record submitted to an enabled `Logger` is counted, even if it is later filtered or dropped within the SDK
116
+ # (e.g. by minimum severity or trace-based rules, or by a processor or the export pipeline), making this metric the top of the log delivery funnel.
117
+ # Records not submitted to the SDK are not counted (e.g. a caller that skips calling `Emit()` based on an `Enabled()` check, or an upstream logging library that filters first).
112
118
  #
113
119
  # @note Stability Level: development
114
120
  OTEL_SDK_LOG_CREATED = 'otel.sdk.log.created'
@@ -125,9 +131,14 @@ module OpenTelemetry
125
131
  #
126
132
  # For successful processing, `error.type` MUST NOT be set. For failed processing, `error.type` MUST contain the failure cause.
127
133
  # 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.
134
+ # If a processor reports a log record dropped because it has already been shut down, `error.type` MUST be `already_shutdown`.
135
+ # Whether and when a processor drops such log records is governed by the SDK specification, not by this metric.
136
+ # For the SDK Simple and Batching Log Record Processors, a log record MUST be counted as successfully processed at the point the
137
+ # processor invokes the export operation. For batching processors, all log records in the batch passed to the exporter are counted
138
+ # at that point; log records accepted into the processor's queue but not yet passed to the exporter have not been processed.
139
+ # Implementations MUST NOT delay this count until the export operation concludes, and the outcome of the export operation,
140
+ # including an immediate failure of the invocation itself, MUST NOT affect this metric.
141
+ # Export outcomes are reported by `otel.sdk.exporter.log.exported`.
131
142
  #
132
143
  # @note Stability Level: development
133
144
  OTEL_SDK_PROCESSOR_LOG_PROCESSED = 'otel.sdk.processor.log.processed'
@@ -150,8 +161,14 @@ module OpenTelemetry
150
161
  #
151
162
  # For successful processing, `error.type` MUST NOT be set. For failed processing, `error.type` MUST contain the failure cause.
152
163
  # 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.
164
+ # If a processor reports a span dropped because it has already been shut down, `error.type` MUST be `already_shutdown`.
165
+ # Whether and when a processor drops such spans is governed by the SDK specification, not by this metric.
166
+ # For the SDK Simple and Batching Span Processors, a span MUST be counted as successfully processed at the point the processor
167
+ # invokes the export operation. For batching processors, all spans in the batch passed to the exporter are counted at that point;
168
+ # spans accepted into the processor's queue but not yet passed to the exporter have not been processed.
169
+ # Implementations MUST NOT delay this count until the export operation concludes, and the outcome of the export operation,
170
+ # including an immediate failure of the invocation itself, MUST NOT affect this metric.
171
+ # Export outcomes are reported by `otel.sdk.exporter.span.exported`.
155
172
  #
156
173
  # @note Stability Level: development
157
174
  OTEL_SDK_PROCESSOR_SPAN_PROCESSED = 'otel.sdk.processor.span.processed'
@@ -32,7 +32,7 @@ module OpenTelemetry
32
32
  # - A gRPC service `rpc.service="io.opentelemetry.AuthService"` may be hosted in both a gateway, `peer.service="ExternalApiService"` and a backend, `peer.service="AuthService"`.
33
33
  #
34
34
  # @note Stability Level: development
35
- # @deprecated Replaced by `service.peer.name`.
35
+ # @deprecated Use `server.service.name` on the client side or `client.service.name` on the server side.
36
36
  PEER_SERVICE = 'peer.service'
37
37
 
38
38
  # @!endgroup