diff --git a/CHANGELOG.md b/CHANGELOG.md index d5aa8bbab53..880e7067547 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -23,6 +23,8 @@ release. - Clarify STDOUT exporter format is unspecified. ([#4418](https://github.com/open-telemetry/opentelemetry-specification/pull/4418)) +- Clarify that it is allowed to directly use Logs API. + ([#4438](https://github.com/open-telemetry/opentelemetry-specification/pull/4438)) ### Baggage diff --git a/specification/logs/README.md b/specification/logs/README.md index 0f2cf8d8df3..5ea4bd94a92 100644 --- a/specification/logs/README.md +++ b/specification/logs/README.md @@ -144,13 +144,14 @@ Given the above state of the logging space we took the following approach: translate them to OpenTelemetry log data model. - OpenTelemetry defines a Logs API - for [emitting LogRecords](./api.md#emit-a-logrecord). Application developers are - NOT encouraged to call this API directly. It is provided for library authors - to build [log appender](../glossary.md#log-appender--bridge), which use - the API to bridge between existing logging libraries and the OpenTelemetry log - data model. Existing logging libraries generally provide a much richer set of - features than what is defined in OpenTelemetry. It is NOT a goal of - OpenTelemetry to ship a feature-rich logging library. + for [emitting LogRecords](./api.md#emit-a-logrecord). It is provided for + library authors to build [log appender](../glossary.md#log-appender--bridge), + which use the API to bridge between existing logging libraries and the + OpenTelemetry log data model. Existing logging libraries generally provide + a much richer set of features than what is defined in OpenTelemetry. + It is NOT a goal of OpenTelemetry to ship a feature-rich logging library. + Yet, the Logs API can also be used directly if one prefers to couple the code + to it instead of using a bridged logging library. - OpenTelemetry defines an [SDK](./sdk.md) implementation of the [API](./api.md), which enables configuration of [processing](./sdk.md#logrecordprocessor)