diff --git a/CHANGELOG.md b/CHANGELOG.md index 4a4e19d2ca..70cc8db1d1 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -18,6 +18,9 @@ release. ### Fixes +- Clarify that `service.*` attributes apply to all telemetry sources. + ([#630](https://github.com/open-telemetry/semantic-conventions/pull/630)) + ## v1.24.0 (2023-12-15) ### Breaking diff --git a/docs/resource/README.md b/docs/resource/README.md index a77cbd2f69..1c0b63718f 100644 --- a/docs/resource/README.md +++ b/docs/resource/README.md @@ -77,7 +77,7 @@ as specified in the [Resource SDK specification](https://github.com/open-telemet **type:** `service` -**Description:** A service instance. +**Description:** A telemetry source. OpenTelemetry has adopted a broad interpretation such that every telemetry source is a service. Examples include, but are not limited to: web services, hosts, mobile applications, browser application, edge computing devices, functions as a service, databases, message brokers, etc. Specific types of telemetry sources may have additional conventions defining domain specific information, but the `service` conventions are applicable to all telemetry sources. | Attribute | Type | Description | Examples | Requirement Level | @@ -94,7 +94,7 @@ as specified in the [Resource SDK specification](https://github.com/open-telemet **type:** `service` -**Description:** Additions to service instance. +**Description:** Experimental additions to service. | Attribute | Type | Description | Examples | Requirement Level | diff --git a/model/resource/service.yaml b/model/resource/service.yaml index 05b2e02698..fc3d3a6c52 100644 --- a/model/resource/service.yaml +++ b/model/resource/service.yaml @@ -3,7 +3,12 @@ groups: prefix: service type: resource brief: > - A service instance. + A telemetry source. OpenTelemetry has adopted a broad interpretation such that every + telemetry source is a service. Examples include, but are not limited to: web services, + hosts, mobile applications, browser application, edge computing devices, functions as + a service, databases, message brokers, etc. Specific types of telemetry sources may have + additional conventions defining domain specific information, but the `service` + conventions are applicable to all telemetry sources. attributes: - id: name type: string diff --git a/model/resource/service_experimental.yaml b/model/resource/service_experimental.yaml index 43c869ee35..9103ac7531 100644 --- a/model/resource/service_experimental.yaml +++ b/model/resource/service_experimental.yaml @@ -3,7 +3,7 @@ groups: prefix: service type: resource brief: > - A service instance. + Experimental additions to service. attributes: - id: namespace type: string