Define standard, vendor-agnostic, language-agnostic instrumentation identity attributes

.chloggen/instrumentation-identity-attributes.yaml

@@ -0,0 +1,4 @@
+change_type: 'enhancement'
+component: instrumentation
+note: Add semantic conventions for instrumentation library identification.
+issues: [1094, 1047]

model/registry/instrumentation.yaml

@@ -0,0 +1,37 @@
+groups:
+  - id: registry.instrumentation.source
+    prefix: instrumentation.source
+    brief: >
+      Attributes identifying the source code of the instrumentation.
+    attributes:
+      - id: repo
+        type: string
+        brief: Link to the source repository of the instrumentation library.
+        examples: [https://github.com/user_or_org/repo, https://gitlab.com/user_or_group/repo]
+        stability: experimental
+      - id: target
+        type: string
+        brief: Build target used to differentiate multiple variants within the repo.
+        examples: ['opt', 'dev', 'asan_enabled', '//variant:a', '//variant:b']
+        stability: experimental
+  - id: registry.instrumentation.distribution
+    prefix: instrumentation.distribution
+    brief: >
+      Attributes identifying the distribution channel of the instrumentation.
+    attributes:
+      - id: source
+        type: string
+        brief: Link to the mode of distribution.
+        examples: [https://mvnrepository.com/, https://pypi.org/, https://packages.ubuntu.com/noble]
+        stability: experimental
+      - id: package
+        type: string
+        brief: Source-specific name of the distribution bundle, project, etc.
+        examples: ['org.springframework.boot', 'tensorflow', 'python3-jwt']
+        stability: experimental
+      - id: artifact
+        type: string
+        brief: Library component inside the package if applicable.
+        examples: ['spring-boot-starter-web']
+        stability: experimental
+

model/trace/instrumentation/instrumentation.yaml

@@ -0,0 +1,29 @@
+groups:
+  - id: scope.instrumentation.source
+    prefix: instrumentation.source
+    type: scope
+    brief: >
+      Scope attributes identifying the source code of the instrumentation.
+    attributes:
+    - ref: instrumentation.source.repo
+      requirement_level: recommended
+    - ref: instrumentation.source.target
+      requirement_level:
+        recommended: >
+          If multiple equally valid options exist in
+          the same repo or if a non-standard/non-default option is used
+  - id: scope.instrumentation.distribution
+    prefix: instrumentation.distribution
+    type: scope
+    brief: >
+      Scope attributes identifying the instrumentation distribution channel.
+    attributes:
+    - ref: instrumentation.distribution.source
+      requirement_level:
+        recommended: If readily available
+    - ref: instrumentation.distribution.package
+      requirement_level:
+        recommended: If readily available
+    - ref: instrumentation.distribution.artifact
+      requirement_level:
+        recommended: If applicable and readily available