deprecate event logger (open-telemetry#1466)

The event logger was a Development-status component of the logging signal. It has been
removed in favour of adding emitEvent to the logger interface,
see open-telemetry/opentelemetry-specification#4319

src/API/Globals.php

@@ -58,6 +58,10 @@ public static function loggerProvider(): LoggerProviderInterface
         return Context::getCurrent()->get(ContextKeys::loggerProvider()) ?? self::globals()->loggerProvider;
     }
 
+    /**
+     * @deprecated
+     * @phan-suppress PhanDeprecatedFunction
+     */
     public static function eventLoggerProvider(): EventLoggerProviderInterface
     {
         return Context::getCurrent()->get(ContextKeys::eventLoggerProvider()) ?? self::globals()->eventLoggerProvider;
@@ -76,7 +80,7 @@ public static function registerInitializer(Closure $initializer): void
     }
 
     /**
-     * @phan-suppress PhanTypeMismatchReturnNullable
+     * @phan-suppress PhanTypeMismatchReturnNullable,PhanDeprecatedFunction
      */
     private static function globals(): self
     {

src/API/Instrumentation/CachedInstrumentation.php

@@ -68,6 +68,11 @@ public function logger(): LoggerInterface
 
         return $this->loggers[$loggerProvider] ??= $loggerProvider->getLogger($this->name, $this->version, $this->schemaUrl, $this->attributes);
     }
+
+    /**
+     * @deprecated
+     * @phan-suppress PhanDeprecatedFunction
+     */
     public function eventLogger(): EventLoggerInterface
     {
         $eventLoggerProvider = Globals::eventLoggerProvider();

src/API/Instrumentation/Configurator.php

@@ -46,6 +46,7 @@ public static function create(): Configurator
 
     /**
      * Creates a configurator that uses noop instances for not configured values.
+     * @phan-suppress PhanDeprecatedFunction
      */
     public static function createNoop(): Configurator
     {
@@ -63,6 +64,9 @@ public function activate(): ScopeInterface
         return $this->storeInContext()->activate();
     }
 
+    /**
+     * @phan-suppress PhanDeprecatedFunction
+     */
     public function storeInContext(?ContextInterface $context = null): ContextInterface
     {
         $context ??= Context::getCurrent();
@@ -118,6 +122,9 @@ public function withLoggerProvider(?LoggerProviderInterface $loggerProvider): Co
         return $self;
     }
 
+    /**
+     * @deprecated
+     */
     public function withEventLoggerProvider(?EventLoggerProviderInterface $eventLoggerProvider): Configurator
     {
         $self = clone $this;

src/API/Instrumentation/ContextKeys.php

@@ -58,6 +58,7 @@ public static function loggerProvider(): ContextKeyInterface
     }
 
     /**
+     * @deprecated
      * @return ContextKeyInterface<EventLoggerProviderInterface>
      */
     public static function eventLoggerProvider(): ContextKeyInterface

src/API/Logs/EventLoggerInterface.php

@@ -7,6 +7,7 @@
 use OpenTelemetry\Context\ContextInterface;
 
 /**
+ * @deprecated
  * @see https://github.com/open-telemetry/opentelemetry-specification/blob/main/specification/logs/event-api.md#events-api-interface
  */
 interface EventLoggerInterface

src/API/Logs/EventLoggerProviderInterface.php

@@ -5,6 +5,7 @@
 namespace OpenTelemetry\API\Logs;
 
 /**
+ * @deprecated
  * @see https://github.com/open-telemetry/opentelemetry-specification/blob/v1.32.0/specification/logs/event-api.md#get-an-eventlogger
  */
 interface EventLoggerProviderInterface

src/API/Logs/NoopEventLogger.php

@@ -6,6 +6,9 @@
 
 use OpenTelemetry\Context\ContextInterface;
 
+/**
+ * @phan-suppress PhanDeprecatedInterface
+ */
 class NoopEventLogger implements EventLoggerInterface
 {
     public static function instance(): self

src/API/Logs/NoopEventLoggerProvider.php

@@ -4,6 +4,9 @@
 
 namespace OpenTelemetry\API\Logs;
 
+/**
+ * @phan-suppress PhanDeprecatedInterface
+ */
 class NoopEventLoggerProvider implements EventLoggerProviderInterface
 {
     public static function getInstance(): self

src/SDK/Logs/EventLogger.php

@@ -12,6 +12,10 @@
 use OpenTelemetry\Context\Context;
 use OpenTelemetry\Context\ContextInterface;
 
+/**
+ * @deprecated
+ * @phan-suppress PhanDeprecatedInterface
+ */
 class EventLogger implements EventLoggerInterface
 {
     /**

src/SDK/Logs/EventLoggerProvider.php

@@ -7,12 +7,18 @@
 use OpenTelemetry\API\Common\Time\Clock;
 use OpenTelemetry\API\Logs\EventLoggerInterface;
 
+/**
+ * @phan-suppress PhanDeprecatedInterface
+ */
 class EventLoggerProvider implements EventLoggerProviderInterface
 {
     public function __construct(private readonly LoggerProviderInterface $loggerProvider)
     {
     }
 
+    /**
+     * @phan-suppress PhanDeprecatedClass
+     */
     public function getEventLogger(string $name, ?string $version = null, ?string $schemaUrl = null, iterable $attributes = []): EventLoggerInterface
     {
         return new EventLogger(

src/SDK/Logs/EventLoggerProviderFactory.php

@@ -6,6 +6,9 @@
 
 use OpenTelemetry\SDK\Sdk;
 
+/**
+ * @deprecated
+ */
 class EventLoggerProviderFactory
 {
     public function create(LoggerProviderInterface $loggerProvider): EventLoggerProviderInterface

src/SDK/Logs/EventLoggerProviderInterface.php

@@ -6,6 +6,9 @@
 
 use OpenTelemetry\API\Logs as API;
 
+/**
+ * @phan-suppress PhanDeprecatedInterface
+ */
 interface EventLoggerProviderInterface extends API\EventLoggerProviderInterface
 {
     public function forceFlush(): bool;

src/SDK/Logs/NoopEventLoggerProvider.php

@@ -6,6 +6,9 @@
 
 use OpenTelemetry\API\Logs as API;
 
+/**
+ * @phan-suppress PhanDeprecatedInterface
+ */
 class NoopEventLoggerProvider extends API\NoopEventLoggerProvider implements EventLoggerProviderInterface
 {
     public static function getInstance(): self

src/SDK/Sdk.php

@@ -60,6 +60,9 @@ public function getLoggerProvider(): LoggerProviderInterface
         return $this->loggerProvider;
     }
 
+    /**
+     * @deprecated
+     */
     public function getEventLoggerProvider(): EventLoggerProviderInterface
     {
         return $this->eventLoggerProvider;

src/SDK/SdkAutoloader.php

@@ -74,6 +74,9 @@ public static function autoload(): bool
         return true;
     }
 
+    /**
+     * @phan-suppress PhanDeprecatedClass,PhanDeprecatedFunction
+     */
     private static function environmentBasedInitializer(Configurator $configurator): Configurator
     {
         $propagator = (new PropagatorFactory())->create();
@@ -110,7 +113,7 @@ private static function environmentBasedInitializer(Configurator $configurator):
     }
 
     /**
-     * @phan-suppress PhanPossiblyUndeclaredVariable
+     * @phan-suppress PhanPossiblyUndeclaredVariable,PhanDeprecatedFunction
      */
     private static function fileBasedInitializer(Configurator $configurator): Configurator
     {

src/SDK/SdkBuilder.php

@@ -59,6 +59,9 @@ public function setLoggerProvider(LoggerProviderInterface $loggerProvider): self
         return $this;
     }
 
+    /**
+     * @deprecated
+     */
     public function setEventLoggerProvider(EventLoggerProviderInterface $eventLoggerProvider): self
     {
         $this->eventLoggerProvider = $eventLoggerProvider;
@@ -95,6 +98,9 @@ public function build(): Sdk
         );
     }
 
+    /**
+     * @phan-suppress PhanDeprecatedFunction
+     */
     public function buildAndRegisterGlobal(): ScopeInterface
     {
         $sdk = $this->build();