Mark events API/SDK as deprecated

[DylanRussell]

Description

Mark the Events API/SDK as deprecated. The Logs API/SDK should be used instead. An event is now a LogRecord with the event_name field set.

See open-telemetry/opentelemetry-specification#4319 and open-telemetry/opentelemetry-specification#4260 (comment)

Type of change

Please delete options that are not relevant.

• Bug fix (non-breaking change which fixes an issue)

How Has This Been Tested?

Just marking stuff as deprecated.

Does This PR Require a Contrib Repo Change?

• Yes. - Link to PR:
• No.

Checklist:

• Followed the style guidelines of this project
• Changelogs have been updated
• Unit tests have been added
• Documentation has been updated

[tammy-baylis-swi]

The changes here lgtm if we agree that this will be part of next release.

Thanks for linking those spec issues. Could we also have a dedicated Python issue to include on the Python Logging RC board?

[DylanRussell]

Sure created #4655 and added it to the board

[aabmass]

Can you also add deprecation to the module level public functions like

opentelemetry-python/opentelemetry-api/src/opentelemetry/_events/__init__.py

Line 174 in 2a0282c

def get_event_logger_provider() -> EventLoggerProvider:

[DylanRussell]

Ack I added the deprecation warnings to the module level public functions

[aabmass]

Does This PR Require a Contrib Repo Change?

• Yes. - Link to PR:
• No.

Should we go ahead and fix the contrib packages now? I don't remember if the independent versioned GenAI packages test against opentelemetry-api @ HEAD or not

[emdneto]

Does This PR Require a Contrib Repo Change?

• Yes. - Link to PR:
• No.

Should we go ahead and fix the contrib packages now? I don't remember if the independent versioned GenAI packages test against opentelemetry-api @ HEAD or not

Individual GenAI packages are being tested against the main and also against the lowest supported version of the API. I don't think it will be a problem in terms of testing because we are just deprecating things. Typechecker won't like this change though

[DylanRussell]

I will go ahead and update the Contrib repo implementations now.. Up to y'all if you want to block this PR until that is done. IMO we should just merge it

[lzchen]

I'm tagging this with the log-breaking-changes tag just for tracking purposes as it is part of the log sdk stabilization plan.