Skip to content

Commit 72cc859

Browse files
authored
Clarify that it is allowed to directly use Logs API (#4438)
1 parent 0c853fe commit 72cc859

File tree

2 files changed

+10
-7
lines changed

2 files changed

+10
-7
lines changed

CHANGELOG.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -23,6 +23,8 @@ release.
2323

2424
- Clarify STDOUT exporter format is unspecified.
2525
([#4418](https://github.com/open-telemetry/opentelemetry-specification/pull/4418))
26+
- Clarify that it is allowed to directly use Logs API.
27+
([#4438](https://github.com/open-telemetry/opentelemetry-specification/pull/4438))
2628

2729
### Baggage
2830

specification/logs/README.md

Lines changed: 8 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -144,13 +144,14 @@ Given the above state of the logging space we took the following approach:
144144
translate them to OpenTelemetry log data model.
145145

146146
- OpenTelemetry defines a Logs API
147-
for [emitting LogRecords](./api.md#emit-a-logrecord). Application developers are
148-
NOT encouraged to call this API directly. It is provided for library authors
149-
to build [log appender](../glossary.md#log-appender--bridge), which use
150-
the API to bridge between existing logging libraries and the OpenTelemetry log
151-
data model. Existing logging libraries generally provide a much richer set of
152-
features than what is defined in OpenTelemetry. It is NOT a goal of
153-
OpenTelemetry to ship a feature-rich logging library.
147+
for [emitting LogRecords](./api.md#emit-a-logrecord). It is provided for
148+
library authors to build [log appender](../glossary.md#log-appender--bridge),
149+
which use the API to bridge between existing logging libraries and the
150+
OpenTelemetry log data model. Existing logging libraries generally provide
151+
a much richer set of features than what is defined in OpenTelemetry.
152+
It is NOT a goal of OpenTelemetry to ship a feature-rich logging library.
153+
Yet, the Logs API can also be used directly if one prefers to couple the code
154+
to it instead of using a bridged logging library.
154155

155156
- OpenTelemetry defines an [SDK](./sdk.md) implementation of the [API](./api.md),
156157
which enables configuration of [processing](./sdk.md#logrecordprocessor)

0 commit comments

Comments
 (0)