diff --git a/CHANGELOG.md b/CHANGELOG.md index 0bc0648f16a..eb56428e41f 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -15,6 +15,9 @@ release. ### Logs +- Stabilize optional `Exception` parameter to Logger Emit. + ([#4858](https://github.com/open-telemetry/opentelemetry-specification/pull/4858)) + ### Baggage ### Profiles diff --git a/specification/logs/api.md b/specification/logs/api.md index aeaa2c632b0..f4e2e9237dd 100644 --- a/specification/logs/api.md +++ b/specification/logs/api.md @@ -126,7 +126,7 @@ The API MUST accept the following parameters: - [Attributes](./data-model.md#field-attributes) (optional) - [Event Name](./data-model.md#field-eventname) (optional) -**Status**: [Development](../document-status.md) - The API MAY accept the following parameter: +The API MAY accept the following parameter: - Exception (optional): An exception (or error) associated with the log record. diff --git a/specification/logs/sdk.md b/specification/logs/sdk.md index 3c33110c084..1f6fc498d3a 100644 --- a/specification/logs/sdk.md +++ b/specification/logs/sdk.md @@ -225,8 +225,7 @@ However, the changes MUST be eventually visible. If [Observed Timestamp](./data-model.md#field-observedtimestamp) is unspecified, the implementation SHOULD set it equal to the current time. -**Status**: [Development](../document-status.md) - If an -[Exception](api.md#emit-a-logrecord) is provided, the SDK MUST by default set attributes +If an [Exception](api.md#emit-a-logrecord) is provided, the SDK MUST by default set attributes from the exception on the `LogRecord` with the conventions outlined in the [exception semantic conventions](https://github.com/open-telemetry/semantic-conventions/blob/main/docs/exceptions/exceptions-logs.md). User-provided attributes MUST take precedence and MUST NOT be overwritten by