Implement span suppression strategies (#1599)

* Implement span suppression strategies

Noop: does not suppress anything
SpanKind: suppresses nested spans with the same span kind (except for internal)
SemConv: attempts to guess and suppress the semantic convention that is represented by the span

* Fix style

* Add `experimental`/`internal` annotation

* Move `SpanSuppressionStrategy` and related classes to SDK

* Update examples to avoid usage of internal classes

* Move `SpanSuppression` namespace to `API\Trace`

* Add override attributes

* Prefilter semantic conventions based on sampling relevant attributes

* Add basic span suppression test

* Only inspect sampling relevant attributes

* Inverse attribute masks

* Ignore extra attributes if otherwise no semconv is matched

* Return singletons where possible

* Bump API dependency

* Fix span kinds without semantic conventions

Author: Nevay

Trace/Span.php

@@ -58,7 +58,7 @@ final public function activate(): ScopeInterface
 
     /** @inheritDoc */
     #[\Override]
-    final public function storeInContext(ContextInterface $context): ContextInterface
+    public function storeInContext(ContextInterface $context): ContextInterface
     {
         if (LocalRootSpan::isLocalRoot($context)) {
             $context = LocalRootSpan::store($context, $this);

Trace/SpanSuppression/SemanticConvention.php

@@ -0,0 +1,22 @@
+<?php
+
+declare(strict_types=1);
+
+namespace OpenTelemetry\API\Trace\SpanSuppression;
+
+/**
+ * @experimental
+ */
+final class SemanticConvention
+{
+    /**
+     * @param list<string> $samplingAttributes
+     */
+    public function __construct(
+        public readonly string $name,
+        public readonly int $spanKind,
+        public readonly array $samplingAttributes,
+        public readonly array $attributes,
+    ) {
+    }
+}

Trace/SpanSuppression/SemanticConventionResolver.php

@@ -0,0 +1,16 @@
+<?php
+
+declare(strict_types=1);
+
+namespace OpenTelemetry\API\Trace\SpanSuppression;
+
+/**
+ * @experimental
+ */
+interface SemanticConventionResolver
+{
+    /**
+     * @return list<SemanticConvention>
+     */
+    public function resolveSemanticConventions(string $name, ?string $version, ?string $schemaUrl): array;
+}

composer.json

@@ -35,7 +35,7 @@
     },
     "extra": {
         "branch-alias": {
-            "dev-main": "1.4.x-dev"
+            "dev-main": "1.7.x-dev"
         },
         "spi": {
             "OpenTelemetry\\API\\Instrumentation\\AutoInstrumentation\\HookManagerInterface": [