Add since tag to instrumentation-api javadocs (#9986)

instrumentation-api/src/main/java/io/opentelemetry/instrumentation/api/semconv/http/HttpClientAttributesExtractor.java

@@ -24,6 +24,8 @@
  * Extractor of <a
  * href="https://github.com/open-telemetry/semantic-conventions/blob/v1.23.0/docs/http/http-spans.md#http-client">HTTP
  * client attributes</a>.
+ *
+ * @since 2.0.0
  */
 public final class HttpClientAttributesExtractor<REQUEST, RESPONSE>
     extends HttpCommonAttributesExtractor<

instrumentation-api/src/main/java/io/opentelemetry/instrumentation/api/semconv/http/HttpClientAttributesExtractorBuilder.java

@@ -22,7 +22,11 @@
 import java.util.Set;
 import java.util.function.ToIntFunction;
 
-/** A builder of {@link HttpClientAttributesExtractor}. */
+/**
+ * A builder of {@link HttpClientAttributesExtractor}.
+ *
+ * @since 2.0.0
+ */
 public final class HttpClientAttributesExtractorBuilder<REQUEST, RESPONSE> {
 
   final HttpClientAttributesGetter<REQUEST, RESPONSE> httpAttributesGetter;

instrumentation-api/src/main/java/io/opentelemetry/instrumentation/api/semconv/http/HttpClientAttributesGetter.java

@@ -15,6 +15,8 @@
  * <p>Instrumentation authors will create implementations of this interface for their specific
  * library/framework. It will be used by the {@link HttpClientAttributesExtractor} to obtain the
  * various HTTP client attributes in a type-generic way.
+ *
+ * @since 2.0.0
  */
 public interface HttpClientAttributesGetter<REQUEST, RESPONSE>
     extends HttpCommonAttributesGetter<REQUEST, RESPONSE>,

instrumentation-api/src/main/java/io/opentelemetry/instrumentation/api/semconv/http/HttpClientMetrics.java

@@ -24,6 +24,8 @@
  * {@link OperationListener} which keeps track of <a
  * href="https://github.com/open-telemetry/semantic-conventions/blob/v1.23.0/docs/http/http-metrics.md#http-client">HTTP
  * client metrics</a>.
+ *
+ * @since 2.0.0
  */
 public final class HttpClientMetrics implements OperationListener {
 

instrumentation-api/src/main/java/io/opentelemetry/instrumentation/api/semconv/http/HttpClientRequestResendCount.java

@@ -10,7 +10,11 @@
 import io.opentelemetry.instrumentation.api.instrumenter.Instrumenter;
 import java.util.concurrent.atomic.AtomicIntegerFieldUpdater;
 
-/** A helper that keeps track of the count of the HTTP request resend attempts. */
+/**
+ * A helper that keeps track of the count of the HTTP request resend attempts.
+ *
+ * @since 2.0.0
+ */
 public final class HttpClientRequestResendCount {
 
   private static final ContextKey<HttpClientRequestResendCount> KEY =

instrumentation-api/src/main/java/io/opentelemetry/instrumentation/api/semconv/http/HttpCommonAttributesGetter.java

@@ -11,7 +11,11 @@
 import java.util.List;
 import javax.annotation.Nullable;
 
-/** An interface for getting HTTP attributes common to clients and servers. */
+/**
+ * An interface for getting HTTP attributes common to clients and servers.
+ *
+ * @since 2.0.0
+ */
 public interface HttpCommonAttributesGetter<REQUEST, RESPONSE> {
 
   /**

instrumentation-api/src/main/java/io/opentelemetry/instrumentation/api/semconv/http/HttpServerAttributesExtractor.java

@@ -25,6 +25,8 @@
  * Extractor of <a
  * href="https://github.com/open-telemetry/semantic-conventions/blob/v1.23.0/docs/http/http-spans.md#http-server">HTTP
  * server attributes</a>.
+ *
+ * @since 2.0.0
  */
 public final class HttpServerAttributesExtractor<REQUEST, RESPONSE>
     extends HttpCommonAttributesExtractor<

instrumentation-api/src/main/java/io/opentelemetry/instrumentation/api/semconv/http/HttpServerAttributesExtractorBuilder.java

@@ -24,7 +24,11 @@
 import java.util.Set;
 import java.util.function.Function;
 
-/** A builder of {@link HttpServerAttributesExtractor}. */
+/**
+ * A builder of {@link HttpServerAttributesExtractor}.
+ *
+ * @since 2.0.0
+ */
 public final class HttpServerAttributesExtractorBuilder<REQUEST, RESPONSE> {
 
   final HttpServerAttributesGetter<REQUEST, RESPONSE> httpAttributesGetter;

instrumentation-api/src/main/java/io/opentelemetry/instrumentation/api/semconv/http/HttpServerAttributesGetter.java

@@ -16,6 +16,8 @@
  * <p>Instrumentation authors will create implementations of this interface for their specific
  * library/framework. It will be used by the {@link HttpServerAttributesExtractor} to obtain the
  * various HTTP server attributes in a type-generic way.
+ *
+ * @since 2.0.0
  */
 public interface HttpServerAttributesGetter<REQUEST, RESPONSE>
     extends HttpCommonAttributesGetter<REQUEST, RESPONSE>,

instrumentation-api/src/main/java/io/opentelemetry/instrumentation/api/semconv/http/HttpServerMetrics.java

@@ -24,6 +24,8 @@
  * {@link OperationListener} which keeps track of <a
  * href="https://github.com/open-telemetry/semantic-conventions/blob/v1.23.0/docs/http/http-metrics.md#http-server">HTTP
  * server metrics</a>.
+ *
+ * @since 2.0.0
  */
 public final class HttpServerMetrics implements OperationListener {
 

instrumentation-api/src/main/java/io/opentelemetry/instrumentation/api/semconv/http/HttpServerRoute.java

@@ -22,6 +22,8 @@
  * later, after the instrumented operation starts. This class provides several static methods that
  * allow the instrumentation author to provide the matching HTTP route to the instrumentation when
  * it is discovered.
+ *
+ * @since 2.0.0
  */
 public final class HttpServerRoute {
 

instrumentation-api/src/main/java/io/opentelemetry/instrumentation/api/semconv/http/HttpServerRouteBiGetter.java

@@ -8,7 +8,11 @@
 import io.opentelemetry.context.Context;
 import javax.annotation.Nullable;
 
-/** An interface for getting the {@code http.route} attribute. */
+/**
+ * An interface for getting the {@code http.route} attribute.
+ *
+ * @since 2.0.0
+ */
 @FunctionalInterface
 public interface HttpServerRouteBiGetter<T, U> {
 

instrumentation-api/src/main/java/io/opentelemetry/instrumentation/api/semconv/http/HttpServerRouteBuilder.java

@@ -15,7 +15,11 @@
 import java.util.HashSet;
 import java.util.Set;
 
-/** A builder of {@link HttpServerRoute}. */
+/**
+ * A builder of {@link HttpServerRoute}.
+ *
+ * @since 2.0.0
+ */
 public final class HttpServerRouteBuilder<REQUEST> {
 
   final HttpServerAttributesGetter<REQUEST, ?> getter;

instrumentation-api/src/main/java/io/opentelemetry/instrumentation/api/semconv/http/HttpServerRouteGetter.java

@@ -8,7 +8,11 @@
 import io.opentelemetry.context.Context;
 import javax.annotation.Nullable;
 
-/** An interface for getting the {@code http.route} attribute. */
+/**
+ * An interface for getting the {@code http.route} attribute.
+ *
+ * @since 2.0.0
+ */
 @FunctionalInterface
 public interface HttpServerRouteGetter<T> {
 

instrumentation-api/src/main/java/io/opentelemetry/instrumentation/api/semconv/http/HttpServerRouteSource.java

@@ -5,7 +5,11 @@
 
 package io.opentelemetry.instrumentation.api.semconv.http;
 
-/** Represents the source that provided the {@code http.route} attribute. */
+/**
+ * Represents the source that provided the {@code http.route} attribute.
+ *
+ * @since 2.0.0
+ */
 public enum HttpServerRouteSource {
   /**
    * Represents a "filter" that may execute before the actual server handler. E.g. the Servlet API

instrumentation-api/src/main/java/io/opentelemetry/instrumentation/api/semconv/http/HttpSpanNameExtractor.java

@@ -14,6 +14,8 @@
  * Extractor of the <a
  * href="https://github.com/open-telemetry/semantic-conventions/blob/v1.23.0/docs/http/http-spans.md#name">HTTP
  * span name</a>.
+ *
+ * @since 2.0.0
  */
 public final class HttpSpanNameExtractor {
 

instrumentation-api/src/main/java/io/opentelemetry/instrumentation/api/semconv/http/HttpSpanNameExtractorBuilder.java

@@ -16,7 +16,11 @@
 import java.util.Set;
 import javax.annotation.Nullable;
 
-/** A builder of {@link HttpSpanNameExtractor}. */
+/**
+ * A builder of {@link HttpSpanNameExtractor}.
+ *
+ * @since 2.0.0
+ */
 public final class HttpSpanNameExtractorBuilder<REQUEST> {
 
   @Nullable final HttpClientAttributesGetter<REQUEST, ?> clientGetter;

instrumentation-api/src/main/java/io/opentelemetry/instrumentation/api/semconv/http/HttpSpanStatusExtractor.java

@@ -15,6 +15,8 @@
  * Extractor of the <a
  * href="https://github.com/open-telemetry/semantic-conventions/blob/v1.23.0/docs/http/http-spans.md#status">HTTP
  * span status</a>.
+ *
+ * @since 2.0.0
  */
 public final class HttpSpanStatusExtractor<REQUEST, RESPONSE>
     implements SpanStatusExtractor<REQUEST, RESPONSE> {

instrumentation-api/src/main/java/io/opentelemetry/instrumentation/api/semconv/network/ClientAttributesExtractor.java

@@ -18,6 +18,8 @@
  * Extractor of <a
  * href="https://github.com/open-telemetry/semantic-conventions/blob/v1.23.0/docs/general/attributes.md#client-attributes">client
  * attributes</a>.
+ *
+ * @since 2.0.0
  */
 public final class ClientAttributesExtractor<REQUEST, RESPONSE>
     implements AttributesExtractor<REQUEST, RESPONSE> {

instrumentation-api/src/main/java/io/opentelemetry/instrumentation/api/semconv/network/ClientAttributesGetter.java

@@ -13,6 +13,8 @@
  * <p>Instrumentation authors will create implementations of this interface for their specific
  * library/framework. It will be used by the {@link ClientAttributesExtractor} (or other convention
  * specific extractors) to obtain the various server attributes in a type-generic way.
+ *
+ * @since 2.0.0
  */
 public interface ClientAttributesGetter<REQUEST> {
 

instrumentation-api/src/main/java/io/opentelemetry/instrumentation/api/semconv/network/NetworkAttributesExtractor.java

@@ -16,6 +16,8 @@
  * Extractor of <a
  * href="https://github.com/open-telemetry/semantic-conventions/blob/v1.23.0/docs/general/attributes.md#other-network-attributes">network
  * attributes</a>.
+ *
+ * @since 2.0.0
  */
 public final class NetworkAttributesExtractor<REQUEST, RESPONSE>
     implements AttributesExtractor<REQUEST, RESPONSE> {

instrumentation-api/src/main/java/io/opentelemetry/instrumentation/api/semconv/network/NetworkAttributesGetter.java

@@ -15,6 +15,8 @@
  * <p>Instrumentation authors will create implementations of this interface for their specific
  * library/framework. It will be used by the {@link NetworkAttributesExtractor} (or other convention
  * specific extractors) to obtain the various network attributes in a type-generic way.
+ *
+ * @since 2.0.0
  */
 public interface NetworkAttributesGetter<REQUEST, RESPONSE> {
 

instrumentation-api/src/main/java/io/opentelemetry/instrumentation/api/semconv/network/ServerAttributesExtractor.java

@@ -18,6 +18,8 @@
  * Extractor of <a
  * href="https://github.com/open-telemetry/semantic-conventions/blob/v1.23.0/docs/general/attributes.md#server-attributes">server
  * attributes</a>.
+ *
+ * @since 2.0.0
  */
 public final class ServerAttributesExtractor<REQUEST, RESPONSE>
     implements AttributesExtractor<REQUEST, RESPONSE> {

instrumentation-api/src/main/java/io/opentelemetry/instrumentation/api/semconv/network/ServerAttributesGetter.java

@@ -13,6 +13,8 @@
  * <p>Instrumentation authors will create implementations of this interface for their specific
  * library/framework. It will be used by the {@link ServerAttributesExtractor} (or other convention
  * specific extractors) to obtain the various server attributes in a type-generic way.
+ *
+ * @since 2.0.0
  */
 public interface ServerAttributesGetter<REQUEST> {
 

instrumentation-api/src/main/java/io/opentelemetry/instrumentation/api/semconv/url/UrlAttributesExtractor.java

@@ -16,6 +16,8 @@
  * Extractor of <a
  * href="https://github.com/open-telemetry/semantic-conventions/blob/v1.23.0/docs/url/url.md">URL
  * attributes</a>.
+ *
+ * @since 2.0.0
  */
 public final class UrlAttributesExtractor<REQUEST, RESPONSE>
     implements AttributesExtractor<REQUEST, RESPONSE> {

instrumentation-api/src/main/java/io/opentelemetry/instrumentation/api/semconv/url/UrlAttributesGetter.java

@@ -13,6 +13,8 @@
  * <p>Instrumentation authors will create implementations of this interface for their specific
  * library/framework. It will be used by the {@link UrlAttributesExtractor} (or other convention
  * specific extractors) to obtain the various URL attributes in a type-generic way.
+ *
+ * @since 2.0.0
  */
 public interface UrlAttributesGetter<REQUEST> {