From 974ccbfbfd523b637aaf06209611cc2f27034998 Mon Sep 17 00:00:00 2001 From: Robert Pajak Date: Mon, 7 Apr 2025 16:31:28 +0200 Subject: [PATCH 1/3] Stabilize EventName --- spec-compliance-matrix.md | 2 +- specification/logs/api.md | 2 +- specification/logs/data-model.md | 4 +--- specification/logs/sdk.md | 2 +- 4 files changed, 4 insertions(+), 6 deletions(-) diff --git a/spec-compliance-matrix.md b/spec-compliance-matrix.md index c83ebbe3c2c..c15f1b0c25e 100644 --- a/spec-compliance-matrix.md +++ b/spec-compliance-matrix.md @@ -199,7 +199,7 @@ Disclaimer: this list of features is still a work in progress, please refer to t | LoggerProvider.ForceFlush | | | + | | + | | | + | | + | - | | | Logger.Emit(LogRecord) | | | + | | + | | | + | | + | - | | | Reuse Standard Attributes | X | + | | | | | | | | | | | -| LogRecord.Set EventName | | | | | | | | | | | | | +| LogRecord.Set EventName | | + | | | | | | | + | + | | | | Logger.Enabled | X | + | | | | | | | + | + | | | | SimpleLogRecordProcessor | | | + | | + | | | + | | + | | | | BatchLogRecordProcessor | | | + | | + | | | + | | + | | | diff --git a/specification/logs/api.md b/specification/logs/api.md index db86694f698..78fe4e55469 100644 --- a/specification/logs/api.md +++ b/specification/logs/api.md @@ -122,7 +122,7 @@ The API MUST accept the following parameters: - [Severity Text](./data-model.md#field-severitytext) (optional) - [Body](./data-model.md#field-body) (optional) - [Attributes](./data-model.md#field-attributes) (optional) -- **Status**: [Development](../document-status.md) - [Event Name](./data-model.md#field-eventname) (optional) +- [Event Name](./data-model.md#field-eventname) (optional) **Status**: [Development](../document-status.md) diff --git a/specification/logs/data-model.md b/specification/logs/data-model.md index fc69240db17..0d5c888ba3c 100644 --- a/specification/logs/data-model.md +++ b/specification/logs/data-model.md @@ -209,7 +209,7 @@ Body |The body of the log record. Resource |Describes the source of the log. InstrumentationScope|Describes the scope that emitted the log. Attributes |Additional information about the event. -**Status**: [Development](../document-status.md) - EventName | Name that identifies the class / type of event. +EventName |Name that identifies the class / type of event. Below is the detailed description of each field. @@ -481,8 +481,6 @@ If included, they MUST follow the OpenTelemetry ### Field: `EventName` -**Status**: [Development](../document-status.md) - Type: string. Description: Name that identifies the class / type of the [Event](#events). diff --git a/specification/logs/sdk.md b/specification/logs/sdk.md index 0ee77311f96..506abfb7b0f 100644 --- a/specification/logs/sdk.md +++ b/specification/logs/sdk.md @@ -247,7 +247,7 @@ the following information added to the [LogRecord](data-model.md#log-and-event-r * [`TraceId`](./data-model.md#field-traceid) * [`SpanId`](./data-model.md#field-spanid) * [`TraceFlags`](./data-model.md#field-traceflags) -* **Status**: [Development](../document-status.md) - [`EventName`](./data-model.md#field-eventname) +* [`EventName`](./data-model.md#field-eventname) The SDK MAY provide an operation that makes a deep clone of a `ReadWriteLogRecord`. The operation can be used by asynchronous processors (e.g. [Batching processor](#batching-processor)) From 4b65dc0a7e32d1f6fdb0ee6d045b9071ee310df8 Mon Sep 17 00:00:00 2001 From: Robert Pajak Date: Mon, 7 Apr 2025 16:32:44 +0200 Subject: [PATCH 2/3] Add changelog entry --- CHANGELOG.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index 8ac749b83ec..d9855110016 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -26,6 +26,8 @@ release. ([#4439](https://github.com/open-telemetry/opentelemetry-specification/pull/4439)) - Stabilize `Logger.Enabled`. ([#4463](https://github.com/open-telemetry/opentelemetry-specification/pull/4463)) +- Stabilize `EventName`. + ([#4475](https://github.com/open-telemetry/opentelemetry-specification/pull/4475)) ### Baggage From 8413c72f3d1060f81c4af985d9d3fd95c3501859 Mon Sep 17 00:00:00 2001 From: Robert Pajak Date: Mon, 7 Apr 2025 16:52:44 +0200 Subject: [PATCH 3/3] Update data model --- specification/logs/data-model.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/specification/logs/data-model.md b/specification/logs/data-model.md index 0d5c888ba3c..f0db90e8c41 100644 --- a/specification/logs/data-model.md +++ b/specification/logs/data-model.md @@ -1,6 +1,6 @@ # Logs Data Model -**Status**: [Stable](../document-status.md), except where otherwise specified +**Status**: [Stable](../document-status.md)
Table of Contents @@ -101,8 +101,6 @@ The Data Model aims to successfully represent 3 sorts of logs and events: ### Events -**Status**: [Development](../document-status.md) - Events are OpenTelemetry's standardized format for LogRecords. All semantic conventions defined for logs SHOULD be formatted as Events. Requirements and details for the Event format can be found in the [semantic conventions](https://github.com/open-telemetry/semantic-conventions/blob/main/docs/general/events.md).