Semantic Conventions - Multi-Registry Proposal

docs/specs/multi-registry/registries/acme-http-server-lib/metric.yaml

@@ -0,0 +1,12 @@
+groups:
+  - ref: otel:http.server.request.duration
+    attributes:
+      - ref: otel:http.request.method
+        requirement_level: required
+      - ref: otel:client.address
+        requirement_level: required
+      - ref: otel:client.port
+        requirement_level: required
+      - ref: otel:thread.id
+        requirement_level: required
+      - ref: route.name

docs/specs/multi-registry/registries/acme-http-server-lib/registry/attributes.yaml

@@ -0,0 +1,28 @@
+groups:
+  - id: registry.acme_http_server
+    type: attribute_group
+    display_name: Custom attributes for ACME HTTP Server
+    brief: 'A set of specific attributes for ACME HTTP Server.'
+    attributes:
+      # The ACME HTTP server author does not use the standard `http.route` for an unknown reason.
+      # Unfortunately, we cannot avoid this. In the future, we could enhance Weaver to detect these
+      # types of similarities and report them as advice messages.
+      - id: route.name
+        brief: 'The name of the route.'
+        stability: stable
+        requirement_level: required
+        type: string
+      - id: rate_limiter.type
+        brief: 'The type of rate limiter.'
+        stability: stable
+        requirement_level: required
+        type:
+          members:
+            - id: sliding
+              value: "SLIDING"
+              brief: 'SLIDING policy.'
+              stability: stable
+            - id: token
+              value: "TOKEN"
+              brief: 'TOKEN policy.'
+              stability: stable

docs/specs/multi-registry/registries/acme-http-server-lib/trace.yaml

@@ -0,0 +1,19 @@
+groups:
+  - ref: otel:trace.http.server
+    brief: 'Trace reported by ACME HTTP Server library.'
+    attributes:
+      # The `requirement_level` of the following attributes is promoted to `required`
+      # Note: These 3 attributes are already attached to `trace.http.server`
+      - ref: otel:http.request.method
+        requirement_level: required
+      - ref: otel:client.address
+        requirement_level: required
+      - ref: otel:client.port
+        requirement_level: required
+      # A standard OTEL attribute is attached to the `trace.http.server`
+      # This attribute is not part of the OTEL definition of a `trace.http.server`
+      - ref: otel:thread.id
+        requirement_level: required
+      # Two locally defined attributes (see the attribute registry)
+      - ref: route.name
+      - ref: rate_limiter.type

docs/specs/multi-registry/registries/acme-http-server-lib/weaver_registry.yaml

@@ -0,0 +1,12 @@
+name: acme_http_server_lib
+version: 1.0.0
+schema_url: https://acme_server.com/schemas/1.0.0
+owner:
+  name: ACME HTTP Server Library
+  contact: contact@acme.com
+maintainers:
+  - name: Sarah Connor
+dependencies:
+  - name: otel
+    version: 1.27.0
+    repository: https://opentelemetry.io/registries/

docs/specs/multi-registry/registries/app/app.yaml

@@ -0,0 +1,23 @@
+groups:
+  - id: endpoint.error
+    type: event
+    name: endpoint.error
+    brief: "An endpoint error event."
+    stability: stable
+    attributes:
+      - ref: otel:user.roles
+        requirement_level: required
+      - ref: otel:client.address
+        requirement_level: required
+      - ref: otel:client.port
+        requirement_level: required
+      - ref: otel:http.request.method
+        requirement_level: required
+      - ref: otel:error.type
+        requirement_level: required
+      - ref: otel:thread.id
+        requirement_level: required
+      - ref: acme:route.name
+      - ref: tenant.id
+
+

docs/specs/multi-registry/registries/app/registry/attributes.yaml

@@ -0,0 +1,11 @@
+groups:
+  - id: registry.app
+    type: attribute_group
+    display_name: Enterprise Application Attributes
+    brief: 'A set of enterprise application attributes.'
+    attributes:
+      - id: tenant.id
+        brief: 'The customer tenant id.'
+        stability: stable
+        requirement_level: required
+        type: string

docs/specs/multi-registry/registries/app/weaver_registry.yaml

@@ -0,0 +1,15 @@
+name: my_app
+version: 1.0.0
+schema_url: https://mycompany.com/schemas/my_app/1.0.0
+owner:
+  name: MyCompany
+  contact: registry@mycompany.com
+maintainers:
+  - name: John Doe
+dependencies:
+  - name: otel
+    version: 1.27.0
+    repository: https://opentelemetry.io/registries/
+  - name: acme
+    version: 0.7.1
+    repository: https://github.com/acme-http-server-lib/registries/

docs/specs/multi-registry/registries/waf-vendor/registry/waf_attributes.yaml

@@ -0,0 +1,30 @@
+groups:
+  - id: registry.waf
+    type: attribute_group
+    display_name: WAF Attributes
+    brief: 'A set of specific WAF attributes.'
+    attributes:
+      - id: waf.signature
+        brief: "The WAF signature"
+        type: string
+      - id: waf.action.type
+        brief: "The WAF action type."
+        stability: stable
+        type:
+          members:
+            - id: alarmed
+              value: "ALARMED"
+              brief: 'ALARMED action.'
+              stability: stable
+            - id: blocked
+              value: "BLOCKED"
+              brief: 'BLOCKED action.'
+              stability: stable
+            - id: legal
+              value: "LEGAL"
+              brief: 'LEGAL action.'
+              stability: stable
+            - id: dropped
+              value: "DROPPED"
+              brief: 'DROPPED action.'
+              stability: stable

docs/specs/multi-registry/registries/waf-vendor/trace.yaml

@@ -0,0 +1,11 @@
+groups:
+  - ref: otel:trace.http.server
+    attributes:
+      - ref: otel:http.request.method
+        requirement_level: required
+      - ref: otel:client.address
+        requirement_level: required
+      - ref: otel:client.port
+        requirement_level: required
+      - ref: waf.action.type
+        requirement_level: required

docs/specs/multi-registry/registries/waf-vendor/waf_action.yaml

@@ -0,0 +1,20 @@
+groups:
+  - id: metric.waf.action.hit.count
+    type: metric
+    metric_name: waf.action.hit.count
+    brief: "The number of times the action was hit."
+    instrument: counter
+    unit: "{count}"
+    stability: stable
+    extends: registry.waf
+    attributes:
+      - ref: my_otel:http.request.method
+        requirement_level: required
+      - ref: my_otel:client.address
+        requirement_level: required
+      - ref: my_otel:client.port
+        requirement_level: required
+      - ref: waf.signature
+        requirement_level: required
+      - ref: waf.action.type
+        requirement_level: required

docs/specs/multi-registry/registries/waf-vendor/weaver_registry.yaml

@@ -0,0 +1,12 @@
+name: waf_vendor
+version: 1.5.1
+schema_url: https://waf_vendor.com/schemas/1.5.1
+owner:
+  name: WAF Vendor
+  contact: contact@waf_vendor.com
+maintainers:
+  - name: Neo
+dependencies:
+  - name: otel
+    version: 1.27.0
+    repository: https://opentelemetry.io/registries/