Events API implementation

CHANGELOG.md

@@ -7,6 +7,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## Unreleased
 
+- Events API implementation
+  ([#4054](https://github.com/open-telemetry/opentelemetry-python/pull/4054))
 - optional scope attributes for logger creation
   ([#4035](https://github.com/open-telemetry/opentelemetry-python/pull/4035))
 - optional scope attribute for tracer creation

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

@@ -0,0 +1,58 @@
+from abc import ABC, abstractmethod
+from typing import Any, Optional
+
+from opentelemetry._logs import LogRecord
+from opentelemetry._logs.severity import SeverityNumber
+from opentelemetry.context.context import Context
+from opentelemetry.util.types import Attributes
+
+
+class Event(LogRecord):
+
+    def __init__(
+        self,
+        name: str,
+        payload: Optional[Any] = None,
+        attributes: Optional[Attributes] = None,
+    ):
+        super().__init__(
+            body=payload,  # type: ignore
+            attributes=attributes,
+        )
+        self.name = name
+
+
+class EventLogger(ABC):
+
+    def __init__(
+        self,
+        name: str,
+        body: Optional[Any] = None,
+        timestamp: Optional[int] = None,
+        context: Optional[Context] = None,
+        severity_number: Optional[SeverityNumber] = None,
+        attributes: Optional[Attributes] = None,
+    ):
+        self._name = name
+        self._body = body  # type: ignore
+        self._timestamp = timestamp
+        self._context = context
+        self._severity_number = severity_number
+        self._attributes = attributes
+
+    @abstractmethod
+    def emit(self, event: "Event") -> None:
+        """Emits a :class:`Event` representing an event."""
+
+
+class EventLoggerProvider(ABC):
+
+    @abstractmethod
+    def get_event_logger(
+        self,
+        name: str,
+        version: Optional[str] = None,
+        schema_url: Optional[str] = None,
+        attributes: Optional[Attributes] = None,
+    ) -> EventLogger:
+        """Returns an EventLoggerProvider for use."""