Skip to content

Commit 76921c8

Browse files
author
Liudmila Molkova
committed
clean up migration
1 parent 0ea191d commit 76921c8

File tree

1 file changed

+14
-9
lines changed

1 file changed

+14
-9
lines changed

oteps/4333-recording-exceptions-on-logs.md

Lines changed: 14 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -221,19 +221,24 @@ For the scope of this document, let's use 'exception stack traces collection sev
221221
### Migrating from span events
222222

223223
> [!NOTE]
224-
> New instrumentations or existing ones that do not record exceptions on span events SHOULD
225-
> NOT start recording exceptions on span events.
224+
>
225+
> The migration begins once the specification for recording exceptions on logs is stabilized,
226+
> and once there is stable support for it in the relevant SDK.
227+
>
228+
> When this happens, new instrumentations (or existing ones that do not record exceptions on
229+
> span events) SHOULD NOT start recording exceptions on span events.
230+
>
231+
> Users will still be able to opt-in to sending their events to span events using
232+
> [log -> span events conversion](https://github.com/open-telemetry/opentelemetry-specification/issues/4393)
233+
> at any stage of the migration process.
226234
227-
We will define a configuration option to let users choose if they want instrumentations to record exceptions
228-
on span events or logs.
235+
We will define a configuration option to let users choose if they want **existing** instrumentations that already emit
236+
span events to record exceptions on span events or logs.
229237

230-
Existing instrumentations SHOULD default to recording exceptions on span events in their current major version
238+
Such instrumentations SHOULD default to recording exceptions on span events in their current major version
231239
and record them on logs only when the user opts-in.
232240

233-
In the next major version, this instrumentation SHOULD stop recording exceptions on span events.
234-
235-
Users who still want to receive exceptions as span events MAY achieve it with [logs -> span events
236-
conversion](https://github.com/open-telemetry/opentelemetry-specification/issues/4393).
241+
In the next major version, such instrumentations SHOULD stop recording exceptions on span events.
237242

238243
This is a simplified version of [stability opt-in migration](https://github.com/open-telemetry/semantic-conventions/blob/727700406f9e6cc3f4e4680a81c4c28f2eb71569/docs/http/README.md?plain=1#L13-L37) used in semantic conventions.
239244

0 commit comments

Comments
 (0)