feat(http): migrate HTTP conventions to Weaver schema v2 - Closes #3809

Author: Dipanshusinghh

model/http/common.yaml

@@ -1,7 +1,10 @@
-groups:
+file_format: definition/2
+
+attribute_groups:
   - id: attributes.http.common
-    type: attribute_group
-    brief: "Describes HTTP attributes."
+    visibility: public
+    stability: development
+    brief: 'Describes HTTP attributes.'
     attributes:
       - ref: http.request.method
         requirement_level: required
@@ -14,85 +17,50 @@ groups:
         examples: ['timeout', 'java.net.UnknownHostException', 'server_certificate_invalid', '500']
         note: |
           If the request fails with an error before response status code was sent or received,
-          `error.type` SHOULD be set to exception type (its fully-qualified class name, if applicable)
+          error.type SHOULD be set to exception type (its fully-qualified class name, if applicable)
           or a component-specific low cardinality error identifier.
 
           If response status code was sent or received and status indicates an error according to [HTTP span status definition](/docs/http/http-spans.md),
-          `error.type` SHOULD be set to the status code number (represented as a string), an exception type (if thrown) or a component-specific error identifier.
+          error.type SHOULD be set to the status code number (represented as a string), an exception type (if thrown) or a component-specific error identifier.
 
-          The `error.type` value SHOULD be predictable and SHOULD have low cardinality.
+          The error.type value SHOULD be predictable and SHOULD have low cardinality.
           Instrumentations SHOULD document the list of errors they report.
 
-          The cardinality of `error.type` within one instrumentation library SHOULD be low, but
-          telemetry consumers that aggregate data from multiple instrumentation libraries and applications
-          should be prepared for `error.type` to have high cardinality at query time, when no
-          additional filters are applied.
-
-          If the request has completed successfully, instrumentations SHOULD NOT set `error.type`.
+          If the request has completed successfully, instrumentations SHOULD NOT set error.type.
       - ref: network.protocol.name
         examples: ['http', 'spdy']
         requirement_level:
-          conditionally_required: If not `http` and `network.protocol.version` is set.
+          conditionally_required: If not http and network.protocol.version is set.
       - ref: network.protocol.version
         examples: ['1.0', '1.1', '2', '3']
-
   - id: attributes.http.client
-    type: attribute_group
+    visibility: public
+    stability: development
     brief: 'HTTP Client attributes'
-    extends: attributes.http.common
+    ref_group: attributes.http.common
     attributes:
       - ref: server.address
         requirement_level: required
-        note: |
-          In HTTP/1.1, when the [request target](https://www.rfc-editor.org/rfc/rfc9112.html#name-request-target)
-          is passed in its [absolute-form](https://www.rfc-editor.org/rfc/rfc9112.html#section-3.2.2),
-          the `server.address` SHOULD match the host component of the request target.
-
-          In all other cases, `server.address` SHOULD match the host component of the
-          `Host` header in HTTP/1.1 or the `:authority` pseudo-header in HTTP/2 and HTTP/3.
       - ref: server.port
         requirement_level: required
-        note: |
-          In the case of HTTP/1.1, when the [request target](https://www.rfc-editor.org/rfc/rfc9112.html#name-request-target)
-          is passed in its [absolute-form](https://www.rfc-editor.org/rfc/rfc9112.html#section-3.2.2),
-          the `server.port` SHOULD match the port component of the request target.
-
-          In all other cases, `server.port` SHOULD match the port component of the
-          `Host` header in HTTP/1.1 or the `:authority` pseudo-header in HTTP/2 and HTTP/3.
       - ref: url.scheme
         requirement_level: opt_in
-        examples: ["http", "https"]
+        examples: ['http', 'https']
       - ref: url.template
         requirement_level: opt_in
-        note: >
-          The `url.template` MUST have low cardinality. It is not usually available on HTTP clients, but may be known by the application or specialized HTTP instrumentation.
-
   - id: attributes.http.server
-    type: attribute_group
+    visibility: public
+    stability: development
     brief: 'HTTP Server attributes'
-    extends: attributes.http.common
+    ref_group: attributes.http.common
     attributes:
       - ref: http.route
         requirement_level:
           conditionally_required: If and only if it's available
       - ref: server.address
-        brief: >
-          Name of the local HTTP server that received the request.
-        note: >
-          See [Setting `server.address` and `server.port` attributes](/docs/http/http-spans.md#setting-serveraddress-and-serverport-attributes).
       - ref: server.port
-        brief: >
-          Port of the local HTTP server that received the request.
-        note: >
-          See [Setting `server.address` and `server.port` attributes](/docs/http/http-spans.md#setting-serveraddress-and-serverport-attributes).
         requirement_level:
-          conditionally_required: If available and `server.address` is set.
+          conditionally_required: If available and server.address is set.
       - ref: url.scheme
         requirement_level: required
-        examples: ["http", "https"]
-        note: >
-          The scheme of the original client request, if known
-          (e.g. from [Forwarded#proto](https://developer.mozilla.org/docs/Web/HTTP/Headers/Forwarded#proto),
-          [X-Forwarded-Proto](https://developer.mozilla.org/docs/Web/HTTP/Headers/X-Forwarded-Proto),
-          or a similar header).
-          Otherwise, the scheme of the immediate peer request.
+        examples: ['http', 'https']

model/http/deprecated/registry-deprecated.yaml

@@ -1,144 +1,139 @@
-groups:
-  - id: registry.http.deprecated
-    type: attribute_group
-    display_name: Deprecated HTTP Attributes
-    brief: "Describes deprecated HTTP attributes."
-    attributes:
-      - id: http.method
-        type: string
-        brief: 'Deprecated, use `http.request.method` instead.'
-        stability: development
-        deprecated:
-          reason: renamed
-          renamed_to: http.request.method
-        examples: ["GET", "POST", "HEAD"]
-      - id: http.status_code
-        type: int
-        brief: 'Deprecated, use `http.response.status_code` instead.'
-        stability: development
-        deprecated:
-          reason: renamed
-          renamed_to: http.response.status_code
-        examples: [200]
-      - id: http.scheme
-        type: string
-        brief: 'Deprecated, use `url.scheme` instead.'
-        stability: development
-        deprecated:
-          reason: renamed
-          renamed_to: url.scheme
-        examples: ['http', 'https']
-      - id: http.url
-        type: string
-        brief: 'Deprecated, use `url.full` instead.'
-        stability: development
-        deprecated:
-          reason: renamed
-          renamed_to: url.full
-        examples: ['https://www.foo.bar/search?q=OpenTelemetry#SemConv']
-      - id: http.target
-        type: string
-        brief: 'Deprecated, use `url.path` and `url.query` instead.'
-        stability: development
-        deprecated:
-          reason: obsoleted
-          note: Split to `url.path` and `url.query`.
-        examples: ['/search?q=OpenTelemetry#SemConv']
-      - id: http.request_content_length
-        type: int
-        brief: 'Deprecated, use `http.request.header.content-length` instead.'
-        stability: development
-        deprecated:
-          reason: uncategorized
-          note: Replaced by `http.request.header.content-length`.
-        examples: 3495
-      - id: http.response_content_length
-        type: int
-        brief: 'Deprecated, use `http.response.header.content-length` instead.'
-        stability: development
-        deprecated:
-          reason: uncategorized
-          note: Replaced by `http.response.header.content-length`.
-        examples: 3495
-      - id: http.client_ip
-        type: string
-        stability: development
-        deprecated:
-          reason: renamed
-          renamed_to: client.address
-        brief: "Deprecated, use `client.address` instead."
-        examples: '83.164.160.102'
-      - id: http.host
-        type: string
-        stability: development
-        deprecated:
-          reason: uncategorized
-          note: >
-            Replaced by one of `server.address`, `client.address` or `http.request.header.host`, depending on the usage.
-        brief: "Deprecated, use one of `server.address`, `client.address` or `http.request.header.host` instead, depending on the usage."
-        examples: ['www.example.org']
-      - id: http.request_content_length_uncompressed
-        stability: development
-        deprecated:
-          reason: renamed
-          renamed_to: http.request.body.size
-        type: int
-        brief: "Deprecated, use `http.request.body.size` instead."
-        examples: 5493
-      - id: http.response_content_length_uncompressed
-        stability: development
-        deprecated:
-          reason: renamed
-          renamed_to: http.response.body.size
-        type: int
-        brief: "Deprecated, use `http.response.body.size` instead."
-        examples: 5493
-      - id: http.server_name
-        type: string
-        stability: development
-        deprecated:
-          reason: renamed
-          renamed_to: server.address
-        brief: "Deprecated, use `server.address` instead."
-        examples: ['example.com']
-      - id: http.flavor
-        type:
-          members:
-            - id: http_1_0
-              value: '1.0'
-              brief: 'HTTP/1.0'
-              stability: development
-            - id: http_1_1
-              value: '1.1'
-              brief: 'HTTP/1.1'
-              stability: development
-            - id: http_2_0
-              value: '2.0'
-              brief: 'HTTP/2'
-              stability: development
-            - id: http_3_0
-              value: '3.0'
-              brief: 'HTTP/3'
-              stability: development
-            - id: spdy
-              value: 'SPDY'
-              brief: 'SPDY protocol.'
-              stability: development
-            - id: quic
-              value: 'QUIC'
-              brief: 'QUIC protocol.'
-              stability: development
-        brief: 'Deprecated, use `network.protocol.name` and `network.protocol.version` instead.'
-        deprecated:
-          reason: uncategorized
-          note: "Split into `network.protocol.name` and `network.protocol.version`"
-        stability: development
-      - id: http.user_agent
-        type: string
-        brief: 'Deprecated, use `user_agent.original` instead.'
-        examples: ['CERN-LineMode/2.15 libwww/2.17b3',
-                   'Mozilla/5.0 (iPhone; CPU iPhone OS 14_7_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/14.1.2 Mobile/15E148 Safari/604.1']
-        deprecated:
-          reason: renamed
-          renamed_to: user_agent.original
-        stability: development
+file_format: definition/2
+
+attributes:
+  - key: http.method
+    type: string
+    brief: 'Deprecated, use http.request.method instead.'
+    stability: development
+    deprecated:
+      reason: renamed
+      renamed_to: http.request.method
+    examples: ['GET', 'POST', 'HEAD']
+  - key: http.status_code
+    type: int
+    brief: 'Deprecated, use http.response.status_code instead.'
+    stability: development
+    deprecated:
+      reason: renamed
+      renamed_to: http.response.status_code
+    examples: [200]
+  - key: http.scheme
+    type: string
+    brief: 'Deprecated, use url.scheme instead.'
+    stability: development
+    deprecated:
+      reason: renamed
+      renamed_to: url.scheme
+    examples: ['http', 'https']
+  - key: http.url
+    type: string
+    brief: 'Deprecated, use url.full instead.'
+    stability: development
+    deprecated:
+      reason: renamed
+      renamed_to: url.full
+    examples: ['https://www.foo.bar/search?q=OpenTelemetry#SemConv']
+  - key: http.target
+    type: string
+    brief: 'Deprecated, use url.path and url.query instead.'
+    stability: development
+    deprecated:
+      reason: obsoleted
+      note: Split to url.path and url.query.
+    examples: ['/search?q=OpenTelemetry#SemConv']
+  - key: http.request_content_length
+    type: int
+    brief: 'Deprecated, use http.request.header.content-length instead.'
+    stability: development
+    deprecated:
+      reason: uncategorized
+      note: Replaced by http.request.header.content-length.
+    examples: 3495
+  - key: http.response_content_length
+    type: int
+    brief: 'Deprecated, use http.response.header.content-length instead.'
+    stability: development
+    deprecated:
+      reason: uncategorized
+      note: Replaced by http.response.header.content-length.
+    examples: 3495
+  - key: http.client_ip
+    type: string
+    stability: development
+    deprecated:
+      reason: renamed
+      renamed_to: client.address
+    brief: 'Deprecated, use client.address instead.'
+    examples: '83.164.160.102'
+  - key: http.host
+    type: string
+    stability: development
+    deprecated:
+      reason: uncategorized
+      note: Replaced by one of server.address, client.address or http.request.header.host.
+    brief: 'Deprecated, use one of server.address, client.address or http.request.header.host instead.'
+    examples: ['www.example.org']
+  - key: http.request_content_length_uncompressed
+    stability: development
+    deprecated:
+      reason: renamed
+      renamed_to: http.request.body.size
+    type: int
+    brief: 'Deprecated, use http.request.body.size instead.'
+    examples: 5493
+  - key: http.response_content_length_uncompressed
+    stability: development
+    deprecated:
+      reason: renamed
+      renamed_to: http.response.body.size
+    type: int
+    brief: 'Deprecated, use http.response.body.size instead.'
+    examples: 5493
+  - key: http.server_name
+    type: string
+    stability: development
+    deprecated:
+      reason: renamed
+      renamed_to: server.address
+    brief: 'Deprecated, use server.address instead.'
+    examples: ['example.com']
+  - key: http.flavor
+    type:
+      members:
+        - id: http_1_0
+          value: '1.0'
+          brief: 'HTTP/1.0'
+          stability: development
+        - id: http_1_1
+          value: '1.1'
+          brief: 'HTTP/1.1'
+          stability: development
+        - id: http_2_0
+          value: '2.0'
+          brief: 'HTTP/2'
+          stability: development
+        - id: http_3_0
+          value: '3.0'
+          brief: 'HTTP/3'
+          stability: development
+        - id: spdy
+          value: 'SPDY'
+          brief: 'SPDY protocol.'
+          stability: development
+        - id: quic
+          value: 'QUIC'
+          brief: 'QUIC protocol.'
+          stability: development
+    brief: 'Deprecated, use network.protocol.name and network.protocol.version instead.'
+    deprecated:
+      reason: uncategorized
+      note: Split into network.protocol.name and network.protocol.version
+    stability: development
+  - key: http.user_agent
+    type: string
+    brief: 'Deprecated, use user_agent.original instead.'
+    examples: ['CERN-LineMode/2.15 libwww/2.17b3', 'Mozilla/5.0 (iPhone; CPU iPhone OS 14_7_1 like Mac OS X)']
+    deprecated:
+      reason: renamed
+      renamed_to: user_agent.original
+    stability: development