telemetry.distro.name and telemetry.distro.version (#178)

Co-authored-by: Reiley Yang <[email protected]>

CHANGELOG.md

@@ -129,6 +129,9 @@ release.
   ([#350](https://github.com/open-telemetry/semantic-conventions/pull/350))
 - Improve network attribute briefs.
   ([#352](https://github.com/open-telemetry/semantic-conventions/pull/352))
+- BREAKING: Rename `telemetry.auto.version` resource attribute to `telemetry.distro.version`
+  and add `telemetry.distro.name` resource attribute
+  ([#178](https://github.com/open-telemetry/semantic-conventions/pull/178))
 
 ## v1.21.0 (2023-07-13)
 

docs/resource/README.md

@@ -172,7 +172,11 @@ All custom identifiers SHOULD be stable across different versions of an implemen
 <!-- semconv telemetry_experimental -->
 | Attribute  | Type | Description  | Examples  | Requirement Level |
 |---|---|---|---|---|
-| `telemetry.auto.version` | string | The version string of the auto instrumentation agent, if used. | `1.2.3` | Recommended |
+| `telemetry.distro.name` | string | The name of the auto instrumentation agent or distribution, if used. [1] | `parts-unlimited-java` | Recommended |
+| `telemetry.distro.version` | string | The version string of the auto instrumentation agent or distribution, if used. | `1.2.3` | Recommended |
+
+**[1]:** Official auto instrumentation agents and distributions SHOULD set the `telemetry.distro.name` attribute to
+a string starting with `opentelemetry-`, e.g. `opentelemetry-java-instrumentation`.
 <!-- endsemconv -->
 
 ## Compute Unit

model/resource/telemetry_experimental.yaml

@@ -5,8 +5,16 @@ groups:
     brief: >
       The telemetry SDK used to capture data recorded by the instrumentation libraries.
     attributes:
-      - id: auto.version
+      - id: distro.name
         type: string
         brief: >
-          The version string of the auto instrumentation agent, if used.
+          The name of the auto instrumentation agent or distribution, if used.
+        note: |
+          Official auto instrumentation agents and distributions SHOULD set the `telemetry.distro.name` attribute to
+          a string starting with `opentelemetry-`, e.g. `opentelemetry-java-instrumentation`.
+        examples: ["parts-unlimited-java"]
+      - id: distro.version
+        type: string
+        brief: >
+          The version string of the auto instrumentation agent or distribution, if used.
         examples: ["1.2.3"]

schema-next.yaml

@@ -135,6 +135,12 @@ versions:
         - rename_metrics:
             http.server.request.size: http.server.request.body.size
             http.server.response.size: http.server.response.body.size
+    resources:
+      changes:
+        # https://github.com/open-telemetry/semantic-conventions/pull/178
+        - rename_attributes:
+            attribute_map:
+              telemetry.auto.version: telemetry.distro.version
   1.21.0:
     spans:
       changes: