diff --git a/specification/resource/semantic_conventions/README.md b/specification/resource/semantic_conventions/README.md index 8a329775c..d4a1ed977 100644 --- a/specification/resource/semantic_conventions/README.md +++ b/specification/resource/semantic_conventions/README.md @@ -36,9 +36,20 @@ Attributes are grouped logically by the type of the concept that they described. Certain attribute groups in this document have a **Required** column. For these groups if any attribute from the particular group is present in the Resource then all attributes that are marked as Required MUST be also present in the Resource. However it is also valid if the entire attribute group is omitted (i.e. none of the attributes from the particular group are present even though some of them are marked as Required in this document). +## Attributes with Special Handling + +Given their significance some resource attributes are treated specifically as described below. + +### Semantic Attributes with Dedicated Environment Variable + +These are the attributes which MAY be configurable via a dedicated environment variable +as specified in [OpenTelemetry Environment Variable Specification](../../sdk-environment-variables.md): + +- [`service.name`](#service) + ## Semantic Attributes with SDK-provided Default Value -These are the the attributes which MUST be provided by the SDK +These are the attributes which MUST be provided by the SDK as specified in the [Resource SDK specification](../sdk.md#sdk-provided-resource-attributes): - [`service.name`](#service)