[WIP] Add example of instrumentation-specific conventions

distro-conventions/model/jmx-activemq-conventions/jmx-activemq-metrics.yaml

@@ -0,0 +1,27 @@
+file_format: definition/2.0.0
+attributes:
+  - key: activemq.broker.name
+    type: string
+    brief: The name of the ActiveMQ broker.
+    stability: development
+    examples: ["broker-1", "broker-xyz"]
+  - key: activemq.destination.type
+    type: string
+    brief: The type of the ActiveMQ destination.
+    stability: development
+    examples: ["queue", "topic"]
+metrics:
+  # based on https://github.com/open-telemetry/opentelemetry-java-instrumentation/blob/main/instrumentation/jmx-metrics/library/activemq.md
+  - name: activemq.producer.count
+    instrument: updowncounter
+    stability: development
+    brief: The number of producers attached to this destination
+    unit: "{producer}"
+    attributes:
+      - ref: messaging.destination.name
+      - ref: activemq.destination.type
+      - ref: activemq.broker.name
+imports:
+  metrics:
+    # this is not realistic, just an example of how to import existing metric
+    - messaging.client.operation.duration

distro-conventions/model/registry_manifest.yaml

@@ -0,0 +1,9 @@
+name: opentelemetry-java-instrumentation
+description: This registry contains semantic conventions for OpenTelemetry Java agent
+version: 1.0.0-dev
+repository_url: https://github.com/open-telemetry/opentelemetry-java-instrumentation
+stability: development
+dependencies:
+  - name: otel
+    registry_path: https://github.com/open-telemetry/semantic-conventions/archive/refs/tags/v1.38.0.zip[model]
+

distro-conventions/model/spring-conventions/spring-spans.yaml

@@ -0,0 +1,23 @@
+file_format: definition/2.0.0
+attributes:
+  - key: spring-webmvc.view.type
+    type: string
+    brief: The type of the Spring Web MVC view.
+    stability: development
+    examples: ["com.app.MyView"]
+spans:
+  # based on https://github.com/open-telemetry/opentelemetry-java-instrumentation/tree/main/instrumentation/spring/spring-webmvc/spring-webmvc-6.0
+  - type: spring.webmvc.controller.span
+    stability: development
+    kind: internal
+    brief: Spring Web MVC controller span
+    name:
+      note: "render {spring-webmvc.view.type}"
+    attributes:
+      - ref: spring-webmvc.view.type
+      - ref: error.type
+imports:
+  metrics:
+    - http.server.*
+  # spans - not supported yet
+  # - http.server