deprecate event logger (#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

Author: brettmc

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
     {

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();

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;

Instrumentation/ContextKeys.php

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

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

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

Logs/NoopEventLogger.php

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

Logs/NoopEventLoggerProvider.php

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