build

Author: lmolkova

semantic_conventions/trace/database.yaml

@@ -8,7 +8,7 @@ groups:
       - id: system
         tag: connection-level
         brief: An identifier for the database management system (DBMS) product being used. See below for a list of well-known identifiers.
-        requirement_level: required
+        required: always
         type:
           allow_custom_values: true
           members:
@@ -175,8 +175,8 @@ groups:
       - id: name
         tag: call-level
         type: string
-        requirement_level:
-          conditionally_required: If applicable.
+        required:
+          conditional: Required, if applicable.
         brief: >
           This attribute is used to report the name of the database being accessed.
           For commands that switch the database, this should be set to the target database
@@ -190,18 +190,18 @@ groups:
       - id: statement
         tag: call-level
         type: string
-        requirement_level:
-          conditionally_required: >
-            If applicable and not explicitly disabled via instrumentation configuration.
+        required:
+          conditional: >
+            Required if applicable and not explicitly disabled via instrumentation configuration.
         brief: >
           The database statement being executed.
         note: The value may be sanitized to exclude sensitive information.
         examples: ['SELECT * FROM wuser_table', 'SET mykey "WuValue"']
       - id: operation
         tag: call-level
         type: string
-        requirement_level:
-          conditionally_required: If `db.statement` is not applicable.
+        required:
+          conditional: Required, if `db.statement` is not applicable.
         brief: >
           The name of the operation being executed, e.g. the [MongoDB command name](https://docs.mongodb.com/manual/reference/command/#database-operations)
           such as `findAndModify`, or the SQL keyword.
@@ -215,20 +215,20 @@ groups:
         examples: ['findAndModify', 'HMSET', 'SELECT']
       - ref: net.peer.name
         tag: connection-level
-        requirement_level:
-          conditionally_required: See below.
+        required:
+          conditional: See below.
       - ref: net.peer.ip
         tag: connection-level
-        requirement_level:
-          conditionally_required: See below.
+        required:
+          conditional: See below.
       - ref: net.peer.port
         tag: connection-level
-        requirement_level:
-          conditionally_required: If using a port other than the default port for this DBMS.
+        required:
+          conditional: Required if using a port other than the default port for this DBMS.
       - ref: net.transport
         tag: connection-level
-        requirement_level:
-          conditionally_required: If database type is in-process (`"inproc"`), recommended for other database types.
+        required:
+          conditional: Recommended in general, required for in-process databases (`"inproc"`).
     constraints:
       - any_of:
           - 'net.peer.name'
@@ -294,7 +294,8 @@ groups:
       - id: table
         type: string
         tag: call-level-tech-specific-cassandra
-        requirement_level: recommended
+        required:
+          conditional: Recommended if available.
         brief: The name of the primary table that the operation is acting upon, including the keyspace name (if applicable).
         note: >
           This mirrors the db.sql.table attribute but references cassandra rather than sql.
@@ -336,8 +337,8 @@ groups:
     attributes:
       - id: database_index
         type: int
-        requirement_level:
-          conditionally_required: If other than the default database (`0`).
+        required:
+          conditional: Required, if other than the default database (`0`).
         tag: call-level-tech-specific
         brief: >
           The index of the database being accessed as used in the [`SELECT` command](https://redis.io/commands/select), provided as an integer.
@@ -352,7 +353,7 @@ groups:
     attributes:
       - id: collection
         type: string
-        requirement_level: required
+        required: always
         tag: call-level-tech-specific
         brief: >
           The collection being accessed within the database stated in `db.name`.
@@ -367,7 +368,8 @@ groups:
       - id: table
         tag: call-level-tech-specific
         type: string
-        requirement_level: recommended
+        required:
+          conditional: Recommended if available.
         brief: The name of the primary table that the operation is acting upon, including the database name (if applicable).
         note: >
           It is not recommended to attempt any client-side parsing of

specification/trace/semantic_conventions/messaging.md

@@ -215,7 +215,7 @@ For Apache Kafka, the following additional attributes are defined:
 
 **[1]:** 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.
 
-**[2]:** If value is `true`. When missing, the value is assumed to be `false``.
+**[2]:** If value is `true`. When missing, the value is assumed to be `false`.
 <!-- endsemconv -->
 
 For Apache Kafka producers, [`peer.service`](./span-general.md#general-remote-service-attributes) SHOULD be set to the name of the broker or service the message will be sent to.