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

Logs/EventLogger.php

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

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(

Logs/EventLoggerProviderFactory.php

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

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;

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

Sdk.php

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

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
     {

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