[DO NOT MERGE] [Trace] Deprecate Record Exception API in favor of using Events

[pellared]

Blocked by open-telemetry/semantic-conventions#3256

Blocked by #4824

Towards OTEP: Span Event API deprecation plan

Changes

• Deprecate the trace/exception document in favor of a document in semantic conventions
• Deprecate Record Exception API as new semantics favor using Logs instead (see: Update exception recording guidelines to not use span events semantic-conventions#3256)

[Copilot]

Pull request overview

This PR deprecates the Record Exception API in the trace specification, aligning with the OTEP for Span Event API deprecation and the new semantic conventions that favor using Logs for recording exceptions.

• Marks the trace/exceptions.md document as deprecated with a reference to new semantic conventions
• Deprecates the RecordException API method in the trace API specification
• Adds a CHANGELOG entry documenting the deprecation

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 2 comments.

File	Description
specification/trace/exceptions.md	Changes status from Stable to Deprecated and directs users to the new semantic conventions for recording exceptions
specification/trace/api.md	Adds deprecation status to the Record Exception API section
CHANGELOG.md	Documents the deprecation of Record Exception API in the Traces section

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[github-actions]

This PR was marked stale. It will be closed in 14 days without additional activity.