From 0ceff17dfa9784f7639c77cbd507a66b6af7e836 Mon Sep 17 00:00:00 2001 From: Anuraag Agrawal Date: Thu, 15 Oct 2020 01:29:27 +0900 Subject: [PATCH] Remove since tags until 1.0.0 (#1796) * Remove since tags until 1.0.0 * Spotless --- .../java/io/opentelemetry/OpenTelemetry.java | 9 --- .../io/opentelemetry/baggage/Baggage.java | 14 +---- .../opentelemetry/baggage/BaggageManager.java | 5 -- .../opentelemetry/baggage/BaggageUtils.java | 11 +--- .../baggage/DefaultBaggageManager.java | 6 +- .../opentelemetry/baggage/EmptyBaggage.java | 1 - .../java/io/opentelemetry/baggage/Entry.java | 11 +--- .../opentelemetry/baggage/EntryMetadata.java | 4 -- .../baggage/spi/BaggageManagerFactory.java | 1 - .../common/AttributeConsumer.java | 6 +- .../opentelemetry/common/AttributeType.java | 2 - .../opentelemetry/common/LabelConsumer.java | 2 - .../io/opentelemetry/internal/Obfuscated.java | 3 - .../metrics/AsynchronousInstrument.java | 8 +-- .../opentelemetry/metrics/BatchRecorder.java | 8 --- .../opentelemetry/metrics/DefaultMeter.java | 7 +-- .../opentelemetry/metrics/DoubleCounter.java | 11 +--- .../metrics/DoubleSumObserver.java | 2 - .../metrics/DoubleUpDownCounter.java | 11 +--- .../metrics/DoubleUpDownSumObserver.java | 2 - .../metrics/DoubleValueObserver.java | 2 - .../metrics/DoubleValueRecorder.java | 11 +--- .../io/opentelemetry/metrics/Instrument.java | 6 +- .../io/opentelemetry/metrics/LongCounter.java | 11 +--- .../metrics/LongSumObserver.java | 2 - .../metrics/LongUpDownCounter.java | 11 +--- .../metrics/LongUpDownSumObserver.java | 2 - .../metrics/LongValueObserver.java | 2 - .../metrics/LongValueRecorder.java | 11 +--- .../java/io/opentelemetry/metrics/Meter.java | 13 ----- .../opentelemetry/metrics/MeterProvider.java | 3 - .../metrics/SynchronousInstrument.java | 4 -- .../metrics/spi/MeterProviderFactory.java | 1 - .../io/opentelemetry/trace/DefaultSpan.java | 4 -- .../io/opentelemetry/trace/DefaultTracer.java | 7 +-- .../opentelemetry/trace/EndSpanOptions.java | 18 +----- .../java/io/opentelemetry/trace/Span.java | 56 +------------------ .../io/opentelemetry/trace/SpanContext.java | 13 ----- .../java/io/opentelemetry/trace/SpanId.java | 12 +--- .../trace/StatusCanonicalCode.java | 3 - .../io/opentelemetry/trace/TraceFlags.java | 9 +-- .../java/io/opentelemetry/trace/TraceId.java | 15 +---- .../io/opentelemetry/trace/TraceState.java | 25 +-------- .../java/io/opentelemetry/trace/Tracer.java | 5 -- .../opentelemetry/trace/TracerProvider.java | 3 - .../trace/TracingContextUtils.java | 11 +--- .../trace/spi/TracerProviderFactory.java | 1 - .../propagation/ContextPropagators.java | 3 - .../DefaultContextPropagators.java | 7 --- .../propagation/TextMapPropagator.java | 9 --- .../exporters/inmemory/InMemoryTracing.java | 11 +--- .../jaeger/JaegerGrpcSpanExporter.java | 2 - .../otlp/OtlpGrpcMetricExporter.java | 1 - .../exporters/otlp/OtlpGrpcSpanExporter.java | 1 - .../exporters/zipkin/ZipkinSpanExporter.java | 5 -- .../propagation/TraceMultiPropagator.java | 10 ---- .../extensions/trace/MessageEvent.java | 21 +------ .../opentracingshim/TraceShim.java | 2 - .../sdk/resources/ResourcesConfig.java | 1 - .../metrics/export/IntervalMetricReader.java | 1 - .../sdk/trace/data/ImmutableStatus.java | 1 - .../sdk/trace/data/SpanData.java | 4 -- .../sdk/logging/data/AnyValue.java | 2 - .../incubator/trace/data/SpanDataBuilder.java | 6 +- .../opentelemetry/sdk/trace/TestSpanData.java | 25 +-------- 65 files changed, 31 insertions(+), 466 deletions(-) diff --git a/api/src/main/java/io/opentelemetry/OpenTelemetry.java b/api/src/main/java/io/opentelemetry/OpenTelemetry.java index 971b0db0ef..224e6b3a51 100644 --- a/api/src/main/java/io/opentelemetry/OpenTelemetry.java +++ b/api/src/main/java/io/opentelemetry/OpenTelemetry.java @@ -53,7 +53,6 @@ public final class OpenTelemetry { * @return registered TracerProvider or default via {@link DefaultTracerProvider#getInstance()}. * @throws IllegalStateException if a specified TracerProvider (via system properties) could not * be found. - * @since 0.1.0 */ public static TracerProvider getTracerProvider() { return getInstance().tracerProvider; @@ -67,7 +66,6 @@ public final class OpenTelemetry { * @param instrumentationName The name of the instrumentation library, not the name of the * instrument*ed* library (e.g., "io.opentelemetry.contrib.mongodb"). Must not be null. * @return a tracer instance. - * @since 0.5.0 */ public static Tracer getTracer(String instrumentationName) { return getTracerProvider().get(instrumentationName); @@ -84,7 +82,6 @@ public final class OpenTelemetry { * @param instrumentationVersion The version of the instrumentation library (e.g., * "semver:1.0.0"). * @return a tracer instance. - * @since 0.5.0 */ public static Tracer getTracer(String instrumentationName, String instrumentationVersion) { return getTracerProvider().get(instrumentationName, instrumentationVersion); @@ -96,7 +93,6 @@ public final class OpenTelemetry { * @return registered MeterProvider or default via {@link DefaultMeterProvider#getInstance()}. * @throws IllegalStateException if a specified MeterProvider (via system properties) could not be * found. - * @since 0.1.0 */ public static MeterProvider getMeterProvider() { return getInstance().meterProvider; @@ -110,7 +106,6 @@ public final class OpenTelemetry { * @param instrumentationName The name of the instrumentation library, not the name of the * instrument*ed* library. * @return a tracer instance. - * @since 0.5.0 */ public static Meter getMeter(String instrumentationName) { return getMeterProvider().get(instrumentationName); @@ -126,7 +121,6 @@ public final class OpenTelemetry { * instrument*ed* library. * @param instrumentationVersion The version of the instrumentation library. * @return a tracer instance. - * @since 0.5.0 */ public static Meter getMeter(String instrumentationName, String instrumentationVersion) { return getMeterProvider().get(instrumentationName, instrumentationVersion); @@ -138,7 +132,6 @@ public final class OpenTelemetry { * @return registered manager or default via {@link DefaultBaggageManager#getInstance()}. * @throws IllegalStateException if a specified manager (via system properties) could not be * found. - * @since 0.1.0 */ public static BaggageManager getBaggageManager() { return getInstance().contextManager; @@ -152,7 +145,6 @@ public final class OpenTelemetry { * with {@link HttpTraceContext} registered. * @throws IllegalStateException if a specified manager (via system properties) could not be * found. - * @since 0.3.0 */ public static ContextPropagators getPropagators() { return getInstance().propagators; @@ -166,7 +158,6 @@ public final class OpenTelemetry { * @throws IllegalStateException if a specified manager (via system properties) could not be * found. * @throws NullPointerException if {@code propagators} is {@code null}. - * @since 0.3.0 */ public static void setPropagators(ContextPropagators propagators) { Objects.requireNonNull(propagators, "propagators"); diff --git a/api/src/main/java/io/opentelemetry/baggage/Baggage.java b/api/src/main/java/io/opentelemetry/baggage/Baggage.java index 6c8df6473b..a010d3074e 100644 --- a/api/src/main/java/io/opentelemetry/baggage/Baggage.java +++ b/api/src/main/java/io/opentelemetry/baggage/Baggage.java @@ -16,8 +16,6 @@ import javax.annotation.concurrent.Immutable; * *

For example, {@code Baggage}s can be used to label stats, log messages, or debugging * information. - * - * @since 0.9.0 */ @Immutable public interface Baggage { @@ -26,7 +24,6 @@ public interface Baggage { * guaranteed. * * @return an immutable collection of the entries in this {@code Baggage}. - * @since 0.9.0 */ Collection getEntries(); @@ -40,11 +37,7 @@ public interface Baggage { @Nullable String getEntryValue(String entryKey); - /** - * Builder for the {@link Baggage} class. - * - * @since 0.9.0 - */ + /** Builder for the {@link Baggage} class. */ interface Builder { /** * Sets the parent {@link Baggage} to use from the specified {@code Context}. If no parent @@ -63,7 +56,6 @@ public interface Baggage { * @return this. * @throws NullPointerException if {@code context} is {@code null}. * @see #setNoParent() - * @since 0.9.0 */ Builder setParent(Context context); @@ -73,7 +65,6 @@ public interface Baggage { * BaggageManager#getCurrentBaggage()} at {@link #build()} time will be used as parent. * * @return this. - * @since 0.9.0 */ Builder setNoParent(); @@ -84,7 +75,6 @@ public interface Baggage { * @param value the {@code String} value to set for the given key. * @param entryMetadata the {@code EntryMetadata} associated with this {@link Entry}. * @return this - * @since 0.9.0 */ Builder put(String key, String value, EntryMetadata entryMetadata); @@ -93,7 +83,6 @@ public interface Baggage { * * @param key the {@code String} key which will be removed. * @return this - * @since 0.9.0 */ Builder remove(String key); @@ -101,7 +90,6 @@ public interface Baggage { * Creates a {@code Baggage} from this builder. * * @return a {@code Baggage} with the same entries as this builder. - * @since 0.9.0 */ Baggage build(); } diff --git a/api/src/main/java/io/opentelemetry/baggage/BaggageManager.java b/api/src/main/java/io/opentelemetry/baggage/BaggageManager.java index cda183b8c5..fab407f153 100644 --- a/api/src/main/java/io/opentelemetry/baggage/BaggageManager.java +++ b/api/src/main/java/io/opentelemetry/baggage/BaggageManager.java @@ -17,8 +17,6 @@ import javax.annotation.concurrent.ThreadSafe; *

Implementations may have different constraints and are free to convert entry contexts to their * own subtypes. This means callers cannot assume the {@link #getCurrentBaggage() current context} * is the same instance as the one {@linkplain #withBaggage(Baggage) placed into scope}. - * - * @since 0.9.0 */ @ThreadSafe public interface BaggageManager { @@ -27,7 +25,6 @@ public interface BaggageManager { * Returns the current {@code Baggage}. * * @return the current {@code Baggage}. - * @since 0.9.0 */ Baggage getCurrentBaggage(); @@ -35,7 +32,6 @@ public interface BaggageManager { * Returns a new {@link Baggage.Builder}. * * @return a new {@code Baggage.Builder}. - * @since 0.9.0 */ Baggage.Builder baggageBuilder(); @@ -47,7 +43,6 @@ public interface BaggageManager { * @param baggage the {@code Baggage} to be set as the current context. * @return an object that defines a scope where the given {@code Baggage} is set as the current * context. - * @since 0.9.0 */ Scope withBaggage(Baggage baggage); } diff --git a/api/src/main/java/io/opentelemetry/baggage/BaggageUtils.java b/api/src/main/java/io/opentelemetry/baggage/BaggageUtils.java index 58fa752ed0..abe173ca9f 100644 --- a/api/src/main/java/io/opentelemetry/baggage/BaggageUtils.java +++ b/api/src/main/java/io/opentelemetry/baggage/BaggageUtils.java @@ -11,11 +11,7 @@ import io.opentelemetry.context.Scope; import javax.annotation.Nullable; import javax.annotation.concurrent.Immutable; -/** - * Utility methods for accessing the {@link Baggage} contained in the {@link Context}. - * - * @since 0.9.0 - */ +/** Utility methods for accessing the {@link Baggage} contained in the {@link Context}. */ @Immutable public final class BaggageUtils { private static final ContextKey CORR_CONTEXT_KEY = @@ -27,7 +23,6 @@ public final class BaggageUtils { * @param baggage the value to be set. * @param context the parent {@code Context}. * @return a new context with the given value set. - * @since 0.9.0 */ public static Context withBaggage(Baggage baggage, Context context) { return context.withValues(CORR_CONTEXT_KEY, baggage); @@ -38,7 +33,6 @@ public final class BaggageUtils { * to an empty {@link Baggage}. * * @return the {@link Baggage} from the {@linkplain Context#current current context}. - * @since 0.9.0 */ public static Baggage getCurrentBaggage() { return getBaggage(Context.current()); @@ -50,7 +44,6 @@ public final class BaggageUtils { * * @param context the specified {@code Context}. * @return the {@link Baggage} from the specified {@code Context}. - * @since 0.9.0 */ public static Baggage getBaggage(Context context) { Baggage baggage = context.getValue(CORR_CONTEXT_KEY); @@ -63,7 +56,6 @@ public final class BaggageUtils { * * @param context the specified {@code Context}. * @return the {@link Baggage} from the specified {@code Context}. - * @since 0.9.0 */ @Nullable public static Baggage getBaggageWithoutDefault(Context context) { @@ -76,7 +68,6 @@ public final class BaggageUtils { * * @param baggage the {@link Baggage} to be added to the current {@code Context}. * @return the {@link Scope} for the updated {@code Context}. - * @since 0.9.0 */ public static Scope currentContextWith(Baggage baggage) { Context context = withBaggage(baggage, Context.current()); diff --git a/api/src/main/java/io/opentelemetry/baggage/DefaultBaggageManager.java b/api/src/main/java/io/opentelemetry/baggage/DefaultBaggageManager.java index 8f56b04386..92cda3899e 100644 --- a/api/src/main/java/io/opentelemetry/baggage/DefaultBaggageManager.java +++ b/api/src/main/java/io/opentelemetry/baggage/DefaultBaggageManager.java @@ -11,11 +11,7 @@ import java.util.Objects; import javax.annotation.concurrent.Immutable; import javax.annotation.concurrent.ThreadSafe; -/** - * No-op implementations of {@link BaggageManager}. - * - * @since 0.9.0 - */ +/** No-op implementations of {@link BaggageManager}. */ @ThreadSafe public final class DefaultBaggageManager implements BaggageManager { private static final DefaultBaggageManager INSTANCE = new DefaultBaggageManager(); diff --git a/api/src/main/java/io/opentelemetry/baggage/EmptyBaggage.java b/api/src/main/java/io/opentelemetry/baggage/EmptyBaggage.java index cf539ff65b..bab7b0230d 100644 --- a/api/src/main/java/io/opentelemetry/baggage/EmptyBaggage.java +++ b/api/src/main/java/io/opentelemetry/baggage/EmptyBaggage.java @@ -17,7 +17,6 @@ public class EmptyBaggage implements Baggage { * Returns the single instance of the {@link EmptyBaggage} class. * * @return the single instance of the {@code EmptyBaggage} class. - * @since 0.9.0 */ public static Baggage getInstance() { return INSTANCE; diff --git a/api/src/main/java/io/opentelemetry/baggage/Entry.java b/api/src/main/java/io/opentelemetry/baggage/Entry.java index 794e49a749..80f07fb502 100644 --- a/api/src/main/java/io/opentelemetry/baggage/Entry.java +++ b/api/src/main/java/io/opentelemetry/baggage/Entry.java @@ -10,11 +10,7 @@ import io.opentelemetry.internal.StringUtils; import io.opentelemetry.internal.Utils; import javax.annotation.concurrent.Immutable; -/** - * String-String key-value pair, along with {@link EntryMetadata}. - * - * @since 0.9.0 - */ +/** String-String key-value pair, along with {@link EntryMetadata}. */ @Immutable @AutoValue public abstract class Entry { @@ -28,7 +24,6 @@ public abstract class Entry { * @param value the entry value. * @param entryMetadata the entry metadata. * @return a {@code Entry}. - * @since 0.9.0 */ public static Entry create(String key, String value, EntryMetadata entryMetadata) { Utils.checkArgument(keyIsValid(key), "Invalid entry key name: %s", key); @@ -42,7 +37,6 @@ public abstract class Entry { * @param key the entry key. * @param value the entry value. * @return a {@code Entry}. - * @since 0.9.0 */ public static Entry create(String key, String value) { return create(key, value, EntryMetadata.EMPTY); @@ -52,7 +46,6 @@ public abstract class Entry { * Returns the entry's key. * * @return the entry's key. - * @since 0.9.0 */ public abstract String getKey(); @@ -60,7 +53,6 @@ public abstract class Entry { * Returns the entry's value. * * @return the entry's value. - * @since 0.9.0 */ public abstract String getValue(); @@ -68,7 +60,6 @@ public abstract class Entry { * Returns the (optional) {@link EntryMetadata} associated with this {@link Entry}. * * @return the {@code EntryMetadata}. - * @since 0.9.0 */ public abstract EntryMetadata getEntryMetadata(); diff --git a/api/src/main/java/io/opentelemetry/baggage/EntryMetadata.java b/api/src/main/java/io/opentelemetry/baggage/EntryMetadata.java index 2ec3c9bbfc..d49a136fa0 100644 --- a/api/src/main/java/io/opentelemetry/baggage/EntryMetadata.java +++ b/api/src/main/java/io/opentelemetry/baggage/EntryMetadata.java @@ -11,8 +11,6 @@ import javax.annotation.concurrent.Immutable; /** * {@link EntryMetadata} contains properties associated with an {@link Entry}. This is an opaque * wrapper for a String metadata value. - * - * @since 0.9.0 */ @Immutable @AutoValue @@ -26,7 +24,6 @@ public abstract class EntryMetadata { * * @param metadata TTL of an {@code Entry}. * @return an {@code EntryMetadata}. - * @since 0.9.0 */ public static EntryMetadata create(String metadata) { return new AutoValue_EntryMetadata(metadata); @@ -36,7 +33,6 @@ public abstract class EntryMetadata { * Returns the String value of this {@link EntryMetadata}. * * @return the raw metadata value. - * @since 0.9.0 */ public abstract String getValue(); } diff --git a/api/src/main/java/io/opentelemetry/baggage/spi/BaggageManagerFactory.java b/api/src/main/java/io/opentelemetry/baggage/spi/BaggageManagerFactory.java index 42dcef536b..cf5b10d1ad 100644 --- a/api/src/main/java/io/opentelemetry/baggage/spi/BaggageManagerFactory.java +++ b/api/src/main/java/io/opentelemetry/baggage/spi/BaggageManagerFactory.java @@ -25,7 +25,6 @@ public interface BaggageManagerFactory { * Creates a new {@code BaggageManager} instance. * * @return a {@code BaggageManager} instance. - * @since 0.9.0 */ BaggageManager create(); } diff --git a/api/src/main/java/io/opentelemetry/common/AttributeConsumer.java b/api/src/main/java/io/opentelemetry/common/AttributeConsumer.java index 588cbec728..8c5041a6b7 100644 --- a/api/src/main/java/io/opentelemetry/common/AttributeConsumer.java +++ b/api/src/main/java/io/opentelemetry/common/AttributeConsumer.java @@ -5,11 +5,7 @@ package io.opentelemetry.common; -/** - * Used for iterating over all the key/value pairs in an {@link Attributes} instance. - * - * @since 0.9.0 - */ +/** Used for iterating over all the key/value pairs in an {@link Attributes} instance. */ public interface AttributeConsumer { void consume(AttributeKey key, T value); } diff --git a/api/src/main/java/io/opentelemetry/common/AttributeType.java b/api/src/main/java/io/opentelemetry/common/AttributeType.java index f1a18ff752..5688b849e8 100644 --- a/api/src/main/java/io/opentelemetry/common/AttributeType.java +++ b/api/src/main/java/io/opentelemetry/common/AttributeType.java @@ -8,8 +8,6 @@ package io.opentelemetry.common; /** * An enum that represents all the possible value types for an {@code AttributeKey} and hence the * types of values that are allowed for {@link Attributes}. - * - * @since 0.1.0 */ public enum AttributeType { STRING, diff --git a/api/src/main/java/io/opentelemetry/common/LabelConsumer.java b/api/src/main/java/io/opentelemetry/common/LabelConsumer.java index 0e78905846..2e43fe3aed 100644 --- a/api/src/main/java/io/opentelemetry/common/LabelConsumer.java +++ b/api/src/main/java/io/opentelemetry/common/LabelConsumer.java @@ -10,8 +10,6 @@ package io.opentelemetry.common; * *

This interface should be considered to be a FunctionalInterface in the java 8+ meaning of that * term. - * - * @since 0.9.0 */ public interface LabelConsumer { void consume(String key, String value); diff --git a/api/src/main/java/io/opentelemetry/internal/Obfuscated.java b/api/src/main/java/io/opentelemetry/internal/Obfuscated.java index e28adbdbaa..ead5cfaf0a 100644 --- a/api/src/main/java/io/opentelemetry/internal/Obfuscated.java +++ b/api/src/main/java/io/opentelemetry/internal/Obfuscated.java @@ -17,8 +17,6 @@ import javax.annotation.concurrent.ThreadSafe; * that are returned from the API, and cast them to their SDK specific implementations, then those * casts will fail under auto-instrumentation, because auto-instrumentation takes over the static * global providers returned by the API and points them to it's embedded SDK. - * - * @since 0.4.0 */ @ThreadSafe public interface Obfuscated { @@ -27,7 +25,6 @@ public interface Obfuscated { * Returns the unobfuscated provider. * * @return the unobfuscated provider. - * @since 0.4.0 */ T unobfuscate(); } diff --git a/api/src/main/java/io/opentelemetry/metrics/AsynchronousInstrument.java b/api/src/main/java/io/opentelemetry/metrics/AsynchronousInstrument.java index 3b7abdb2e2..4fb9a66fd4 100644 --- a/api/src/main/java/io/opentelemetry/metrics/AsynchronousInstrument.java +++ b/api/src/main/java/io/opentelemetry/metrics/AsynchronousInstrument.java @@ -19,15 +19,10 @@ import javax.annotation.concurrent.ThreadSafe; * kept. * * @param the callback Result type. - * @since 0.1.0 */ @ThreadSafe public interface AsynchronousInstrument extends Instrument { - /** - * A {@code Callback} for a {@code AsynchronousInstrument}. - * - * @since 0.1.0 - */ + /** A {@code Callback} for a {@code AsynchronousInstrument}. */ interface Callback { void update(R result); } @@ -39,7 +34,6 @@ public interface AsynchronousInstrument extends Instrument { * exported then it will never be called. * * @param callback the callback to be executed before export. - * @since 0.1.0 */ void setCallback(Callback callback); diff --git a/api/src/main/java/io/opentelemetry/metrics/BatchRecorder.java b/api/src/main/java/io/opentelemetry/metrics/BatchRecorder.java index 5972c3e871..c2fa340d5a 100644 --- a/api/src/main/java/io/opentelemetry/metrics/BatchRecorder.java +++ b/api/src/main/java/io/opentelemetry/metrics/BatchRecorder.java @@ -22,7 +22,6 @@ public interface BatchRecorder { * @param valueRecorder the {@link LongValueRecorder}. * @param value the value to be associated with {@code valueRecorder}. * @return this. - * @since 0.1.0 */ BatchRecorder put(LongValueRecorder valueRecorder, long value); @@ -33,7 +32,6 @@ public interface BatchRecorder { * @param valueRecorder the {@link DoubleValueRecorder}. * @param value the value to be associated with {@code valueRecorder}. * @return this. - * @since 0.1.0 */ BatchRecorder put(DoubleValueRecorder valueRecorder, double value); @@ -44,7 +42,6 @@ public interface BatchRecorder { * @param counter the {@link LongCounter}. * @param value the value to be associated with {@code counter}. * @return this. - * @since 0.3.0 */ BatchRecorder put(LongCounter counter, long value); @@ -55,7 +52,6 @@ public interface BatchRecorder { * @param counter the {@link DoubleCounter}. * @param value the value to be associated with {@code counter}. * @return this. - * @since 0.3.0 */ BatchRecorder put(DoubleCounter counter, double value); @@ -66,7 +62,6 @@ public interface BatchRecorder { * @param upDownCounter the {@link LongCounter}. * @param value the value to be associated with {@code counter}. * @return this. - * @since 0.5.0 */ BatchRecorder put(LongUpDownCounter upDownCounter, long value); @@ -77,7 +72,6 @@ public interface BatchRecorder { * @param upDownCounter the {@link DoubleCounter}. * @param value the value to be associated with {@code counter}. * @return this. - * @since 0.5.0 */ BatchRecorder put(DoubleUpDownCounter upDownCounter, double value); @@ -86,8 +80,6 @@ public interface BatchRecorder { * *

This method records all measurements every time it is called, so make sure it is not called * twice if not needed. - * - * @since 0.1.0 */ void record(); } diff --git a/api/src/main/java/io/opentelemetry/metrics/DefaultMeter.java b/api/src/main/java/io/opentelemetry/metrics/DefaultMeter.java index d642a37393..65779691c2 100644 --- a/api/src/main/java/io/opentelemetry/metrics/DefaultMeter.java +++ b/api/src/main/java/io/opentelemetry/metrics/DefaultMeter.java @@ -12,11 +12,7 @@ import java.util.Objects; import javax.annotation.concurrent.Immutable; import javax.annotation.concurrent.ThreadSafe; -/** - * No-op implementations of {@link Meter}. - * - * @since 0.1.0 - */ +/** No-op implementations of {@link Meter}. */ @ThreadSafe public final class DefaultMeter implements Meter { @@ -32,7 +28,6 @@ public final class DefaultMeter implements Meter { * Returns a {@code Meter} singleton that is the default implementations for {@link Meter}. * * @return a {@code Meter} singleton that is the default implementations for {@link Meter}. - * @since 0.1.0 */ public static Meter getInstance() { return INSTANCE; diff --git a/api/src/main/java/io/opentelemetry/metrics/DoubleCounter.java b/api/src/main/java/io/opentelemetry/metrics/DoubleCounter.java index f7d85993e0..482701b707 100644 --- a/api/src/main/java/io/opentelemetry/metrics/DoubleCounter.java +++ b/api/src/main/java/io/opentelemetry/metrics/DoubleCounter.java @@ -36,8 +36,6 @@ import javax.annotation.concurrent.ThreadSafe; * } * } * } - * - * @since 0.1.0 */ @ThreadSafe public interface DoubleCounter extends SynchronousInstrument { @@ -49,7 +47,6 @@ public interface DoubleCounter extends SynchronousInstrument * * @param increment the value to add. * @param labels the labels to be associated to this recording. - * @since 0.1.0 */ void add(double increment, Labels labels); @@ -59,18 +56,13 @@ public interface DoubleCounter extends SynchronousInstrument *

The value added is associated with the current {@code Context} and with empty labels. * * @param increment the value to add. - * @since 0.8.0 */ void add(double increment); @Override BoundDoubleCounter bind(Labels labels); - /** - * A {@code Bound Instrument} for a {@link DoubleCounter}. - * - * @since 0.1.0 - */ + /** A {@code Bound Instrument} for a {@link DoubleCounter}. */ @ThreadSafe interface BoundDoubleCounter extends SynchronousInstrument.BoundInstrument { /** @@ -79,7 +71,6 @@ public interface DoubleCounter extends SynchronousInstrument *

The value added is associated with the current {@code Context}. * * @param increment the value to add. - * @since 0.1.0 */ void add(double increment); diff --git a/api/src/main/java/io/opentelemetry/metrics/DoubleSumObserver.java b/api/src/main/java/io/opentelemetry/metrics/DoubleSumObserver.java index ea66f79608..081e623250 100644 --- a/api/src/main/java/io/opentelemetry/metrics/DoubleSumObserver.java +++ b/api/src/main/java/io/opentelemetry/metrics/DoubleSumObserver.java @@ -45,8 +45,6 @@ import javax.annotation.concurrent.ThreadSafe; * } * } * } - * - * @since 0.1.0 */ @ThreadSafe public interface DoubleSumObserver extends AsynchronousInstrument { diff --git a/api/src/main/java/io/opentelemetry/metrics/DoubleUpDownCounter.java b/api/src/main/java/io/opentelemetry/metrics/DoubleUpDownCounter.java index b447a90c94..3e1d2cb784 100644 --- a/api/src/main/java/io/opentelemetry/metrics/DoubleUpDownCounter.java +++ b/api/src/main/java/io/opentelemetry/metrics/DoubleUpDownCounter.java @@ -39,8 +39,6 @@ import javax.annotation.concurrent.ThreadSafe; * } * } * } - * - * @since 0.1.0 */ @ThreadSafe public interface DoubleUpDownCounter extends SynchronousInstrument { @@ -52,7 +50,6 @@ public interface DoubleUpDownCounter extends SynchronousInstrumentThe value added is associated with the current {@code Context} and empty labels. * * @param increment the value to add. - * @since 0.8.0 */ void add(double increment); @Override BoundDoubleUpDownCounter bind(Labels labels); - /** - * A {@code Bound Instrument} for a {@link DoubleUpDownCounter}. - * - * @since 0.1.0 - */ + /** A {@code Bound Instrument} for a {@link DoubleUpDownCounter}. */ @ThreadSafe interface BoundDoubleUpDownCounter extends BoundInstrument { /** @@ -82,7 +74,6 @@ public interface DoubleUpDownCounter extends SynchronousInstrumentThe value added is associated with the current {@code Context}. * * @param increment the value to add. - * @since 0.1.0 */ void add(double increment); diff --git a/api/src/main/java/io/opentelemetry/metrics/DoubleUpDownSumObserver.java b/api/src/main/java/io/opentelemetry/metrics/DoubleUpDownSumObserver.java index a7c782f7cb..1a057f37b2 100644 --- a/api/src/main/java/io/opentelemetry/metrics/DoubleUpDownSumObserver.java +++ b/api/src/main/java/io/opentelemetry/metrics/DoubleUpDownSumObserver.java @@ -45,8 +45,6 @@ import javax.annotation.concurrent.ThreadSafe; * } * } * } - * - * @since 0.1.0 */ @ThreadSafe public interface DoubleUpDownSumObserver extends AsynchronousInstrument { diff --git a/api/src/main/java/io/opentelemetry/metrics/DoubleValueObserver.java b/api/src/main/java/io/opentelemetry/metrics/DoubleValueObserver.java index b07a647e51..ad7f13cbc7 100644 --- a/api/src/main/java/io/opentelemetry/metrics/DoubleValueObserver.java +++ b/api/src/main/java/io/opentelemetry/metrics/DoubleValueObserver.java @@ -41,8 +41,6 @@ import javax.annotation.concurrent.ThreadSafe; * } * } * } - * - * @since 0.5.0 */ @ThreadSafe public interface DoubleValueObserver extends AsynchronousInstrument { diff --git a/api/src/main/java/io/opentelemetry/metrics/DoubleValueRecorder.java b/api/src/main/java/io/opentelemetry/metrics/DoubleValueRecorder.java index 9dcefe1c44..b2239564f8 100644 --- a/api/src/main/java/io/opentelemetry/metrics/DoubleValueRecorder.java +++ b/api/src/main/java/io/opentelemetry/metrics/DoubleValueRecorder.java @@ -48,8 +48,6 @@ import javax.annotation.concurrent.ThreadSafe; * } * } * } - * - * @since 0.1.0 */ @ThreadSafe public interface DoubleValueRecorder extends SynchronousInstrument { @@ -61,7 +59,6 @@ public interface DoubleValueRecorder extends SynchronousInstrument - * - * @since 0.1.0 */ @ThreadSafe public interface LongCounter extends SynchronousInstrument { @@ -49,7 +47,6 @@ public interface LongCounter extends SynchronousInstrument { * * @param increment the value to add. * @param labels the set of labels to be associated to this recording. - * @since 0.1.0 */ void add(long increment, Labels labels); @@ -59,18 +56,13 @@ public interface LongCounter extends SynchronousInstrument { *

The value added is associated with the current {@code Context} and empty labels. * * @param increment the value to add. - * @since 0.8.0 */ void add(long increment); @Override BoundLongCounter bind(Labels labels); - /** - * A {@code Bound Instrument} for a {@link LongCounter}. - * - * @since 0.1.0 - */ + /** A {@code Bound Instrument} for a {@link LongCounter}. */ @ThreadSafe interface BoundLongCounter extends SynchronousInstrument.BoundInstrument { @@ -80,7 +72,6 @@ public interface LongCounter extends SynchronousInstrument { *

The value added is associated with the current {@code Context}. * * @param increment the value to add. - * @since 0.1.0 */ void add(long increment); diff --git a/api/src/main/java/io/opentelemetry/metrics/LongSumObserver.java b/api/src/main/java/io/opentelemetry/metrics/LongSumObserver.java index 65cd2638ad..828e6e0219 100644 --- a/api/src/main/java/io/opentelemetry/metrics/LongSumObserver.java +++ b/api/src/main/java/io/opentelemetry/metrics/LongSumObserver.java @@ -45,8 +45,6 @@ import javax.annotation.concurrent.ThreadSafe; * } * } * } - * - * @since 0.1.0 */ @ThreadSafe public interface LongSumObserver extends AsynchronousInstrument { diff --git a/api/src/main/java/io/opentelemetry/metrics/LongUpDownCounter.java b/api/src/main/java/io/opentelemetry/metrics/LongUpDownCounter.java index 603f320fbc..21483bd65e 100644 --- a/api/src/main/java/io/opentelemetry/metrics/LongUpDownCounter.java +++ b/api/src/main/java/io/opentelemetry/metrics/LongUpDownCounter.java @@ -39,8 +39,6 @@ import javax.annotation.concurrent.ThreadSafe; * } * } * } - * - * @since 0.1.0 */ @ThreadSafe public interface LongUpDownCounter extends SynchronousInstrument { @@ -52,7 +50,6 @@ public interface LongUpDownCounter extends SynchronousInstrumentThe value added is associated with the current {@code Context} and empty labels. * * @param increment the value to add. - * @since 0.8.0 */ void add(long increment); @Override BoundLongUpDownCounter bind(Labels labels); - /** - * A {@code Bound Instrument} for a {@link LongUpDownCounter}. - * - * @since 0.1.0 - */ + /** A {@code Bound Instrument} for a {@link LongUpDownCounter}. */ @ThreadSafe interface BoundLongUpDownCounter extends BoundInstrument { @@ -83,7 +75,6 @@ public interface LongUpDownCounter extends SynchronousInstrumentThe value added is associated with the current {@code Context}. * * @param increment the value to add. - * @since 0.1.0 */ void add(long increment); diff --git a/api/src/main/java/io/opentelemetry/metrics/LongUpDownSumObserver.java b/api/src/main/java/io/opentelemetry/metrics/LongUpDownSumObserver.java index 5f58d13ab2..657d3a8fcf 100644 --- a/api/src/main/java/io/opentelemetry/metrics/LongUpDownSumObserver.java +++ b/api/src/main/java/io/opentelemetry/metrics/LongUpDownSumObserver.java @@ -45,8 +45,6 @@ import javax.annotation.concurrent.ThreadSafe; * } * } * } - * - * @since 0.1.0 */ @ThreadSafe public interface LongUpDownSumObserver extends AsynchronousInstrument { diff --git a/api/src/main/java/io/opentelemetry/metrics/LongValueObserver.java b/api/src/main/java/io/opentelemetry/metrics/LongValueObserver.java index b53927055e..8bb5ce3c79 100644 --- a/api/src/main/java/io/opentelemetry/metrics/LongValueObserver.java +++ b/api/src/main/java/io/opentelemetry/metrics/LongValueObserver.java @@ -41,8 +41,6 @@ import javax.annotation.concurrent.ThreadSafe; * } * } * } - * - * @since 0.5.0 */ @ThreadSafe public interface LongValueObserver extends AsynchronousInstrument { diff --git a/api/src/main/java/io/opentelemetry/metrics/LongValueRecorder.java b/api/src/main/java/io/opentelemetry/metrics/LongValueRecorder.java index 8adc354073..4c34538069 100644 --- a/api/src/main/java/io/opentelemetry/metrics/LongValueRecorder.java +++ b/api/src/main/java/io/opentelemetry/metrics/LongValueRecorder.java @@ -48,8 +48,6 @@ import javax.annotation.concurrent.ThreadSafe; * } * } * } - * - * @since 0.1.0 */ @ThreadSafe public interface LongValueRecorder extends SynchronousInstrument { @@ -61,7 +59,6 @@ public interface LongValueRecorder extends SynchronousInstrument the specific type of Bound Instrument this instrument can provide. - * @since 0.3.0 */ @ThreadSafe public interface SynchronousInstrument extends Instrument { @@ -31,7 +30,6 @@ public interface SynchronousInstrument extends Instru * @param labels the set of labels, as key-value pairs. * @return a {@code Bound Instrument} * @throws NullPointerException if {@code labelValues} is null. - * @since 0.1.0 */ B bind(Labels labels); @@ -41,8 +39,6 @@ public interface SynchronousInstrument extends Instru * *

After this method returns the current instance {@code Bound} is considered invalid (not * being managed by the instrument). - * - * @since 0.3.0 */ void unbind(); } diff --git a/api/src/main/java/io/opentelemetry/metrics/spi/MeterProviderFactory.java b/api/src/main/java/io/opentelemetry/metrics/spi/MeterProviderFactory.java index 9cf21c0861..5ce75865df 100644 --- a/api/src/main/java/io/opentelemetry/metrics/spi/MeterProviderFactory.java +++ b/api/src/main/java/io/opentelemetry/metrics/spi/MeterProviderFactory.java @@ -25,7 +25,6 @@ public interface MeterProviderFactory { * Creates a new meter registry instance. * * @return a meter factory instance. - * @since 0.1.0 */ MeterProvider create(); } diff --git a/api/src/main/java/io/opentelemetry/trace/DefaultSpan.java b/api/src/main/java/io/opentelemetry/trace/DefaultSpan.java index 7a4baae77d..64308ee563 100644 --- a/api/src/main/java/io/opentelemetry/trace/DefaultSpan.java +++ b/api/src/main/java/io/opentelemetry/trace/DefaultSpan.java @@ -14,8 +14,6 @@ import javax.annotation.concurrent.Immutable; * implementation is available. All operations are no-op except context propagation. * *

Used also to stop tracing, see {@link Tracer#withSpan}. - * - * @since 0.1.0 */ @Immutable public final class DefaultSpan implements Span { @@ -26,7 +24,6 @@ public final class DefaultSpan implements Span { * Returns a {@link DefaultSpan} with an invalid {@link SpanContext}. * * @return a {@code DefaultSpan} with an invalid {@code SpanContext}. - * @since 0.1.0 */ public static Span getInvalid() { return INVALID; @@ -37,7 +34,6 @@ public final class DefaultSpan implements Span { * * @param spanContext the {@code SpanContext}. * @return a {@link DefaultSpan}. - * @since 0.1.0 */ public static Span create(SpanContext spanContext) { return new DefaultSpan(spanContext); diff --git a/api/src/main/java/io/opentelemetry/trace/DefaultTracer.java b/api/src/main/java/io/opentelemetry/trace/DefaultTracer.java index 84e8f44dd6..ae44195853 100644 --- a/api/src/main/java/io/opentelemetry/trace/DefaultTracer.java +++ b/api/src/main/java/io/opentelemetry/trace/DefaultTracer.java @@ -14,11 +14,7 @@ import java.util.Objects; import javax.annotation.Nullable; import javax.annotation.concurrent.ThreadSafe; -/** - * No-op implementations of {@link Tracer}. - * - * @since 0.1.0 - */ +/** No-op implementations of {@link Tracer}. */ @ThreadSafe public final class DefaultTracer implements Tracer { private static final DefaultTracer INSTANCE = new DefaultTracer(); @@ -27,7 +23,6 @@ public final class DefaultTracer implements Tracer { * Returns a {@code Tracer} singleton that is the default implementations for {@link Tracer}. * * @return a {@code Tracer} singleton that is the default implementations for {@link Tracer}. - * @since 0.1.0 */ public static Tracer getInstance() { return INSTANCE; diff --git a/api/src/main/java/io/opentelemetry/trace/EndSpanOptions.java b/api/src/main/java/io/opentelemetry/trace/EndSpanOptions.java index bcb21cefef..6b4531b2fc 100644 --- a/api/src/main/java/io/opentelemetry/trace/EndSpanOptions.java +++ b/api/src/main/java/io/opentelemetry/trace/EndSpanOptions.java @@ -11,19 +11,13 @@ import javax.annotation.concurrent.Immutable; /** * A class that enables overriding the default values used when ending a {@link Span}. Allows * overriding the endTimestamp. - * - * @since 0.1 */ @Immutable @AutoValue public abstract class EndSpanOptions { private static final EndSpanOptions DEFAULT = builder().build(); - /** - * The default {@code EndSpanOptions}. - * - * @since 0.1 - */ + /** The default {@code EndSpanOptions}. */ static EndSpanOptions getDefault() { return DEFAULT; } @@ -32,7 +26,6 @@ public abstract class EndSpanOptions { * Returns a new {@link Builder} with default options. * * @return a new {@code Builder} with default options. - * @since 0.1 */ public static Builder builder() { return new AutoValue_EndSpanOptions.Builder().setEndTimestamp(0); @@ -44,15 +37,10 @@ public abstract class EndSpanOptions { *

Important this is NOT equivalent with System.nanoTime(). * * @return the end timestamp. - * @since 0.1 */ public abstract long getEndTimestamp(); - /** - * Builder class for {@link EndSpanOptions}. - * - * @since 0.1 - */ + /** Builder class for {@link EndSpanOptions}. */ @AutoValue.Builder public abstract static class Builder { /** @@ -62,7 +50,6 @@ public abstract class EndSpanOptions { * * @param endTimestamp the end timestamp in nanos since epoch. * @return this. - * @since 0.1 */ public abstract Builder setEndTimestamp(long endTimestamp); @@ -70,7 +57,6 @@ public abstract class EndSpanOptions { * Builds and returns a {@code EndSpanOptions} with the desired settings. * * @return a {@code EndSpanOptions} with the desired settings. - * @since 0.1 */ public abstract EndSpanOptions build(); diff --git a/api/src/main/java/io/opentelemetry/trace/Span.java b/api/src/main/java/io/opentelemetry/trace/Span.java index 18ad8b0913..e8cccfaedb 100644 --- a/api/src/main/java/io/opentelemetry/trace/Span.java +++ b/api/src/main/java/io/opentelemetry/trace/Span.java @@ -17,8 +17,6 @@ import javax.annotation.concurrent.ThreadSafe; *

Spans are created by the {@link Builder#startSpan} method. * *

{@code Span} must be ended by calling {@link #end()}. - * - * @since 0.1.0 */ @ThreadSafe public interface Span { @@ -26,28 +24,16 @@ public interface Span { /** * Type of span. Can be used to specify additional relationships between spans in addition to a * parent/child relationship. - * - * @since 0.1.0 */ enum Kind { - /** - * Default value. Indicates that the span is used internally. - * - * @since 0.1.0 - */ + /** Default value. Indicates that the span is used internally. */ INTERNAL, - /** - * Indicates that the span covers server-side handling of an RPC or other remote request. - * - * @since 0.1.0 - */ + /** Indicates that the span covers server-side handling of an RPC or other remote request. */ SERVER, /** * Indicates that the span covers the client-side wrapper around an RPC or other remote request. - * - * @since 0.1.0 */ CLIENT, @@ -55,8 +41,6 @@ public interface Span { * Indicates that the span describes producer sending a message to a broker. Unlike client and * server, there is no direct critical path latency relationship between producer and consumer * spans. - * - * @since 0.1.0 */ PRODUCER, @@ -64,8 +48,6 @@ public interface Span { * Indicates that the span describes consumer receiving a message from a broker. Unlike client * and server, there is no direct critical path latency relationship between producer and * consumer spans. - * - * @since 0.1.0 */ CONSUMER } @@ -82,7 +64,6 @@ public interface Span { * * @param key the key for this attribute. * @param value the value for this attribute. - * @since 0.1.0 */ void setAttribute(String key, @Nonnull String value); @@ -95,7 +76,6 @@ public interface Span { * * @param key the key for this attribute. * @param value the value for this attribute. - * @since 0.1.0 */ void setAttribute(String key, long value); @@ -108,7 +88,6 @@ public interface Span { * * @param key the key for this attribute. * @param value the value for this attribute. - * @since 0.1.0 */ void setAttribute(String key, double value); @@ -121,7 +100,6 @@ public interface Span { * * @param key the key for this attribute. * @param value the value for this attribute. - * @since 0.1.0 */ void setAttribute(String key, boolean value); @@ -133,7 +111,6 @@ public interface Span { * * @param key the key for this attribute. * @param value the value for this attribute. - * @since 0.1.0 */ void setAttribute(AttributeKey key, @Nonnull T value); @@ -143,7 +120,6 @@ public interface Span { * * @param key the key for this attribute. * @param value the value for this attribute. - * @since 0.1.0 */ default void setAttribute(AttributeKey key, int value) { setAttribute(key, (long) value); @@ -153,7 +129,6 @@ public interface Span { * Adds an event to the {@link Span}. The timestamp of the event will be the current time. * * @param name the name of the event. - * @since 0.1.0 */ void addEvent(String name); @@ -168,7 +143,6 @@ public interface Span { * * @param name the name of the event. * @param timestamp the explicit event timestamp in nanos since epoch. - * @since 0.1.0 */ void addEvent(String name, long timestamp); @@ -179,7 +153,6 @@ public interface Span { * @param name the name of the event. * @param attributes the attributes that will be added; these are associated with this event, not * the {@code Span} as for {@code setAttribute()}. - * @since 0.1.0 */ void addEvent(String name, Attributes attributes); @@ -196,7 +169,6 @@ public interface Span { * @param attributes the attributes that will be added; these are associated with this event, not * the {@code Span} as for {@code setAttribute()}. * @param timestamp the explicit event timestamp in nanos since epoch. - * @since 0.1.0 */ void addEvent(String name, Attributes attributes, long timestamp); @@ -210,7 +182,6 @@ public interface Span { * previous calls. * * @param canonicalCode the {@link StatusCanonicalCode} to set. - * @since 0.9.0 */ void setStatus(StatusCanonicalCode canonicalCode); @@ -225,7 +196,6 @@ public interface Span { * * @param canonicalCode the {@link StatusCanonicalCode} to set. * @param description the description of the {@code Status}. - * @since 0.9.0 */ void setStatus(StatusCanonicalCode canonicalCode, String description); @@ -237,7 +207,6 @@ public interface Span { * #recordException(Throwable, Attributes)} if you know that an exception is escaping. * * @param exception the {@link Throwable} to record. - * @since 0.7.0 */ void recordException(Throwable exception); @@ -246,7 +215,6 @@ public interface Span { * * @param exception the {@link Throwable} to record. * @param additionalAttributes the additional {@link Attributes} to record. - * @since 0.8.0 */ void recordException(Throwable exception, Attributes additionalAttributes); @@ -259,7 +227,6 @@ public interface Span { * implementation. * * @param name the {@code Span} name. - * @since 0.1 */ void updateName(String name); @@ -268,8 +235,6 @@ public interface Span { * *

Only the timing of the first end call for a given {@code Span} will be recorded, and * implementations are free to ignore all further calls. - * - * @since 0.1.0 */ void end(); @@ -283,7 +248,6 @@ public interface Span { * explicit values are required, use {@link #end()}. * * @param endOptions the explicit {@link EndSpanOptions} for this {@code Span}. - * @since 0.1.0 */ void end(EndSpanOptions endOptions); @@ -291,7 +255,6 @@ public interface Span { * Returns the {@code SpanContext} associated with this {@code Span}. * * @return the {@code SpanContext} associated with this {@code Span}. - * @since 0.1.0 */ SpanContext getContext(); @@ -300,7 +263,6 @@ public interface Span { * #addEvent(String)}, {@link #setAttribute(String, long)}). * * @return {@code true} if this {@code Span} records tracing events. - * @since 0.1.0 */ boolean isRecording(); @@ -390,8 +352,6 @@ public interface Span { * *

If your Java version is less than Java SE 7, see {@link Builder#startSpan} for usage * examples. - * - * @since 0.1.0 */ interface Builder { @@ -408,7 +368,6 @@ public interface Span { * @param context the {@code Context}. * @return this. * @throws NullPointerException if {@code context} is {@code null}. - * @since 0.7.0 */ Builder setParent(Context context); @@ -419,7 +378,6 @@ public interface Span { *

Observe that any previously set parent will be discarded. * * @return this. - * @since 0.1.0 */ Builder setNoParent(); @@ -433,7 +391,6 @@ public interface Span { * @param spanContext the context of the linked {@code Span}. * @return this. * @throws NullPointerException if {@code spanContext} is {@code null}. - * @since 0.1.0 */ Builder addLink(SpanContext spanContext); @@ -449,7 +406,6 @@ public interface Span { * @return this. * @throws NullPointerException if {@code spanContext} is {@code null}. * @throws NullPointerException if {@code attributes} is {@code null}. - * @since 0.1.0 */ Builder addLink(SpanContext spanContext, Attributes attributes); @@ -467,7 +423,6 @@ public interface Span { * @param value the value for this attribute. * @return this. * @throws NullPointerException if {@code key} is {@code null}. - * @since 0.3.0 */ Builder setAttribute(String key, @Nonnull String value); @@ -482,7 +437,6 @@ public interface Span { * @param value the value for this attribute. * @return this. * @throws NullPointerException if {@code key} is {@code null}. - * @since 0.3.0 */ Builder setAttribute(String key, long value); @@ -497,7 +451,6 @@ public interface Span { * @param value the value for this attribute. * @return this. * @throws NullPointerException if {@code key} is {@code null}. - * @since 0.3.0 */ Builder setAttribute(String key, double value); @@ -512,7 +465,6 @@ public interface Span { * @param value the value for this attribute. * @return this. * @throws NullPointerException if {@code key} is {@code null}. - * @since 0.3.0 */ Builder setAttribute(String key, boolean value); @@ -527,7 +479,6 @@ public interface Span { * @return this. * @throws NullPointerException if {@code key} is {@code null}. * @throws NullPointerException if {@code value} is {@code null}. - * @since 0.3.0 */ Builder setAttribute(AttributeKey key, @Nonnull T value); @@ -537,7 +488,6 @@ public interface Span { * * @param spanKind the kind of the newly created {@code Span}. * @return this. - * @since 0.1.0 */ Builder setSpanKind(Span.Kind spanKind); @@ -552,7 +502,6 @@ public interface Span { * @param startTimestamp the explicit start timestamp of the newly created {@code Span} in nanos * since epoch. * @return this. - * @since 0.1.0 */ Builder setStartTimestamp(long startTimestamp); @@ -587,7 +536,6 @@ public interface Span { * } * * @return the newly created {@code Span}. - * @since 0.1.0 */ Span startSpan(); } diff --git a/api/src/main/java/io/opentelemetry/trace/SpanContext.java b/api/src/main/java/io/opentelemetry/trace/SpanContext.java index be45757c91..9b79833408 100644 --- a/api/src/main/java/io/opentelemetry/trace/SpanContext.java +++ b/api/src/main/java/io/opentelemetry/trace/SpanContext.java @@ -15,8 +15,6 @@ import javax.annotation.concurrent.Immutable; * trace_id} and {@link SpanId span_id}) associated with the {@link Span} and a set of options * (currently only whether the context is sampled or not), as well as the {@link TraceState * traceState} and the {@link boolean remote} flag. - * - * @since 0.1.0 */ @Immutable @AutoValue @@ -46,7 +44,6 @@ public abstract class SpanContext { * @param traceFlags the byte representation of the {@link TraceFlags} * @param traceState the trace state for the span context. * @return a new {@code SpanContext} with the given identifiers and options. - * @since 0.1.0 */ public static SpanContext create( String traceIdHex, String spanIdHex, byte traceFlags, TraceState traceState) { @@ -68,7 +65,6 @@ public abstract class SpanContext { * @param traceFlags the byte representation of the {@link TraceFlags} * @param traceState the trace state for the span context. * @return a new {@code SpanContext} with the given identifiers and options. - * @since 0.1.0 */ public static SpanContext createFromRemoteParent( String traceIdHex, String spanIdHex, byte traceFlags, TraceState traceState) { @@ -83,7 +79,6 @@ public abstract class SpanContext { * Returns the trace identifier associated with this {@code SpanContext}. * * @return the trace identifier associated with this {@code SpanContext}. - * @since 0.1.0 */ public String getTraceIdAsHexString() { return getTraceIdHex(); @@ -92,8 +87,6 @@ public abstract class SpanContext { /** * Returns the byte[] representation of the trace identifier associated with this {@link * SpanContext}. - * - * @since 0.8.0 */ @Memoized public byte[] getTraceIdBytes() { @@ -104,7 +97,6 @@ public abstract class SpanContext { * Returns the span identifier associated with this {@code SpanContext}. * * @return the span identifier associated with this {@code SpanContext}. - * @since 0.1.0 */ public String getSpanIdAsHexString() { return getSpanIdHex(); @@ -113,8 +105,6 @@ public abstract class SpanContext { /** * Returns the byte[] representation of the span identifier associated with this {@link * SpanContext}. - * - * @since 0.8.0 */ @Memoized public byte[] getSpanIdBytes() { @@ -138,7 +128,6 @@ public abstract class SpanContext { * Returns the {@code TraceState} associated with this {@code SpanContext}. * * @return the {@code TraceState} associated with this {@code SpanContext}. - * @since 0.1.0 */ public abstract TraceState getTraceState(); @@ -146,7 +135,6 @@ public abstract class SpanContext { * Returns {@code true} if this {@code SpanContext} is valid. * * @return {@code true} if this {@code SpanContext} is valid. - * @since 0.1.0 */ @Memoized public boolean isValid() { @@ -157,7 +145,6 @@ public abstract class SpanContext { * Returns {@code true} if the {@code SpanContext} was propagated from a remote parent. * * @return {@code true} if the {@code SpanContext} was propagated from a remote parent. - * @since 0.1.0 */ public abstract boolean isRemote(); } diff --git a/api/src/main/java/io/opentelemetry/trace/SpanId.java b/api/src/main/java/io/opentelemetry/trace/SpanId.java index b98f5031a7..5b516a1c73 100644 --- a/api/src/main/java/io/opentelemetry/trace/SpanId.java +++ b/api/src/main/java/io/opentelemetry/trace/SpanId.java @@ -11,8 +11,6 @@ import javax.annotation.concurrent.Immutable; * Helper methods for dealing with a span identifier. A valid span identifier is an 8-byte array * with at least one non-zero byte. In base-16 representation, a 16 character hex String, where at * least one of the characters is not a '0'. - * - * @since 0.1.0 */ @Immutable public final class SpanId { @@ -29,17 +27,12 @@ public final class SpanId { * Returns the size in bytes of the {@code SpanId}. * * @return the size in bytes of the {@code SpanId}. - * @since 0.1.0 */ public static int getSize() { return SIZE; } - /** - * Returns the length of the base16 (hex) representation of the {@code SpanId}. - * - * @since 0.8.0 - */ + /** Returns the length of the base16 (hex) representation of the {@code SpanId}. */ public static int getHexLength() { return HEX_SIZE; } @@ -48,7 +41,6 @@ public final class SpanId { * Returns the invalid {@code SpanId}. All bytes are 0. * * @return the invalid {@code SpanId}. - * @since 0.1.0 */ public static String getInvalid() { return INVALID; @@ -80,7 +72,6 @@ public final class SpanId { * @throws NullPointerException if {@code src} is null. * @throws IllegalArgumentException if not enough characters in the {@code src} from the {@code * srcOffset}. - * @since 0.1.0 */ public static byte[] bytesFromHex(String src, int srcOffset) { return BigendianEncoding.bytesFromBase16(src, srcOffset, HEX_SIZE); @@ -91,7 +82,6 @@ public final class SpanId { * at least one non-zero byte. * * @return {@code true} if the span identifier is valid. - * @since 0.1.0 */ public static boolean isValid(String spanId) { return (spanId.length() == HEX_SIZE) diff --git a/api/src/main/java/io/opentelemetry/trace/StatusCanonicalCode.java b/api/src/main/java/io/opentelemetry/trace/StatusCanonicalCode.java index b92b34ae03..6ced736d9b 100644 --- a/api/src/main/java/io/opentelemetry/trace/StatusCanonicalCode.java +++ b/api/src/main/java/io/opentelemetry/trace/StatusCanonicalCode.java @@ -8,8 +8,6 @@ package io.opentelemetry.trace; /** * The set of canonical status codes. If new codes are added over time they must choose a numerical * value that does not collide with any previously used value. - * - * @since 0.1.0 */ public enum StatusCanonicalCode { @@ -35,7 +33,6 @@ public enum StatusCanonicalCode { * Returns the numerical value of the code. * * @return the numerical value of the code. - * @since 0.1.0 */ public int value() { return value; diff --git a/api/src/main/java/io/opentelemetry/trace/TraceFlags.java b/api/src/main/java/io/opentelemetry/trace/TraceFlags.java index 3b21d7d10c..87d2f526b3 100644 --- a/api/src/main/java/io/opentelemetry/trace/TraceFlags.java +++ b/api/src/main/java/io/opentelemetry/trace/TraceFlags.java @@ -11,8 +11,6 @@ import javax.annotation.concurrent.Immutable; * Helper methods for dealing with trace flags options. These options are propagated to all child * {@link Span spans}. These determine features such as whether a {@code Span} should be traced. It * is implemented as a bitmask. - * - * @since 0.1.0 */ @Immutable public final class TraceFlags { @@ -26,11 +24,7 @@ public final class TraceFlags { private static final int SIZE = 1; private static final int BASE16_SIZE = 2 * SIZE; - /** - * Returns the size in Hex of trace flags. - * - * @since 0.9.0 - */ + /** Returns the size in Hex of trace flags. */ public static int getHexLength() { return BASE16_SIZE; } @@ -39,7 +33,6 @@ public final class TraceFlags { * Returns the default {@code TraceFlags}. * * @return the default {@code TraceFlags}. - * @since 0.1.0 */ public static byte getDefault() { return DEFAULT; diff --git a/api/src/main/java/io/opentelemetry/trace/TraceId.java b/api/src/main/java/io/opentelemetry/trace/TraceId.java index 5eb5cc94e5..a017669b2d 100644 --- a/api/src/main/java/io/opentelemetry/trace/TraceId.java +++ b/api/src/main/java/io/opentelemetry/trace/TraceId.java @@ -12,8 +12,6 @@ import javax.annotation.concurrent.Immutable; * Helper methods for dealing with a trace identifier. A valid trace identifier is a 16-byte array * with at least one non-zero byte. In base-16 representation, a 32 character hex String, where at * least one of the characters is not a '0'. - * - * @since 0.1.0 */ @Immutable public final class TraceId { @@ -29,17 +27,12 @@ public final class TraceId { * Returns the size in bytes of the {@code TraceId}. * * @return the size in bytes of the {@code TraceId}. - * @since 0.1.0 */ public static int getSize() { return SIZE_IN_BYTES; } - /** - * Returns the length of the base16 (hex) representation of the {@code TraceId}. - * - * @since 0.8.0 - */ + /** Returns the length of the base16 (hex) representation of the {@code TraceId}. */ public static int getHexLength() { return HEX_SIZE; } @@ -48,7 +41,6 @@ public final class TraceId { * Returns the invalid {@code TraceId}. All bytes are '\0'. * * @return the invalid {@code TraceId}. - * @since 0.1.0 */ public static String getInvalid() { return INVALID; @@ -67,7 +59,6 @@ public final class TraceId { * * @param idHi the higher part of the {@code TraceId}. * @param idLo the lower part of the {@code TraceId}. - * @since 0.1.0 */ public static String fromLongs(long idHi, long idLo) { char[] chars = getTemporaryBuffer(); @@ -95,7 +86,6 @@ public final class TraceId { * @throws NullPointerException if {@code src} is null. * @throws IllegalArgumentException if not enough characters in the {@code src} from the {@code * srcOffset}. - * @since 0.1.0 */ public static byte[] bytesFromHex(String src, int srcOffset) { Objects.requireNonNull(src, "src"); @@ -110,7 +100,6 @@ public final class TraceId { * @param destOffset the starting offset in the destination buffer. * @throws IndexOutOfBoundsException if {@code destOffset + 2 * TraceId.getSize()} is greater than * {@code dest.length}. - * @since 0.1.0 */ public static void copyHexInto(byte[] traceId, char[] dest, int destOffset) { BigendianEncoding.longToBase16String( @@ -124,7 +113,6 @@ public final class TraceId { * at least one non-zero byte. * * @return {@code true} if the {@code TraceId} is valid. - * @since 0.1.0 */ public static boolean isValid(CharSequence traceId) { return (traceId.length() == HEX_SIZE) @@ -136,7 +124,6 @@ public final class TraceId { * Returns the lowercase base16 encoding of this {@code TraceId}. * * @return the lowercase base16 encoding of this {@code TraceId}. - * @since 0.1.0 */ public static String bytesToHex(byte[] traceId) { char[] chars = new char[HEX_SIZE]; diff --git a/api/src/main/java/io/opentelemetry/trace/TraceState.java b/api/src/main/java/io/opentelemetry/trace/TraceState.java index d19ddc1082..229443b20a 100644 --- a/api/src/main/java/io/opentelemetry/trace/TraceState.java +++ b/api/src/main/java/io/opentelemetry/trace/TraceState.java @@ -26,8 +26,6 @@ import javax.annotation.concurrent.Immutable; * *

Value is opaque string up to 256 characters printable ASCII RFC0020 characters (i.e., the * range 0x20 to 0x7E) except comma , and =. - * - * @since 0.1.0 */ @Immutable @AutoValue @@ -43,7 +41,6 @@ public abstract class TraceState { * Returns the default {@code TraceState} with no entries. * * @return the default {@code TraceState}. - * @since 0.1.0 */ public static TraceState getDefault() { return DEFAULT; @@ -56,7 +53,6 @@ public abstract class TraceState { * @param key with which the specified value is to be associated * @return the value to which the specified key is mapped, or null if this map contains no mapping * for the key. - * @since 0.1.0 */ @Nullable public String get(String key) { @@ -72,7 +68,6 @@ public abstract class TraceState { * Returns a {@link List} view of the mappings contained in this {@code TraceState}. * * @return a {@link List} view of the mappings contained in this {@code TraceState}. - * @since 0.1.0 */ public abstract List getEntries(); @@ -80,7 +75,6 @@ public abstract class TraceState { * Returns a {@code Builder} based on an empty {@code TraceState}. * * @return a {@code Builder} based on an empty {@code TraceState}. - * @since 0.1.0 */ public static Builder builder() { return new Builder(Builder.EMPTY); @@ -90,17 +84,12 @@ public abstract class TraceState { * Returns a {@code Builder} based on this {@code TraceState}. * * @return a {@code Builder} based on this {@code TraceState}. - * @since 0.1.0 */ public Builder toBuilder() { return new Builder(this); } - /** - * Builder class for {@link TraceState}. - * - * @since 0.1.0 - */ + /** Builder class for {@link TraceState}. */ public static final class Builder { private final TraceState parent; @Nullable private ArrayList entries; @@ -122,7 +111,6 @@ public abstract class TraceState { * @param key the key for the {@code Entry} to be added. * @param value the value for the {@code Entry} to be added. * @return this. - * @since 0.1.0 */ public Builder set(String key, String value) { // Initially create the Entry to validate input. @@ -148,7 +136,6 @@ public abstract class TraceState { * * @param key the key for the {@code Entry} to be removed. * @return this. - * @since 0.1.0 */ public Builder remove(String key) { Objects.requireNonNull(key, "key"); @@ -171,7 +158,6 @@ public abstract class TraceState { * and removing duplicate entries. * * @return a TraceState with the new entries. - * @since 0.1.0 */ public TraceState build() { if (entries == null) { @@ -181,11 +167,7 @@ public abstract class TraceState { } } - /** - * Immutable key-value pair for {@code TraceState}. - * - * @since 0.1.0 - */ + /** Immutable key-value pair for {@code TraceState}. */ @Immutable @AutoValue public abstract static class Entry { @@ -195,7 +177,6 @@ public abstract class TraceState { * @param key the Entry's key. * @param value the Entry's value. * @return the new {@code Entry}. - * @since 0.1.0 */ public static Entry create(String key, String value) { Objects.requireNonNull(key, "key"); @@ -209,7 +190,6 @@ public abstract class TraceState { * Returns the key {@code String}. * * @return the key {@code String}. - * @since 0.1.0 */ public abstract String getKey(); @@ -217,7 +197,6 @@ public abstract class TraceState { * Returns the value {@code String}. * * @return the value {@code String}. - * @since 0.1.0 */ public abstract String getValue(); diff --git a/api/src/main/java/io/opentelemetry/trace/Tracer.java b/api/src/main/java/io/opentelemetry/trace/Tracer.java index bbdc088a8d..83e1a4c4ec 100644 --- a/api/src/main/java/io/opentelemetry/trace/Tracer.java +++ b/api/src/main/java/io/opentelemetry/trace/Tracer.java @@ -56,8 +56,6 @@ import javax.annotation.concurrent.ThreadSafe; * } * } * } - * - * @since 0.1.0 */ @ThreadSafe public interface Tracer { @@ -71,7 +69,6 @@ public interface Tracer { * @return a default {@code Span} that does nothing and has an invalid {@link SpanContext} if no * {@code Span} is associated with the current Context, otherwise the current {@code Span} * from the Context. - * @since 0.1.0 */ Span getCurrentSpan(); @@ -123,7 +120,6 @@ public interface Tracer { * @return an object that defines a scope where the given {@link Span} will be set to the current * Context. * @throws NullPointerException if {@code span} is {@code null}. - * @since 0.1.0 */ @MustBeClosed Scope withSpan(Span span); @@ -136,7 +132,6 @@ public interface Tracer { * @param spanName The name of the returned Span. * @return a {@code Span.Builder} to create and start a new {@code Span}. * @throws NullPointerException if {@code spanName} is {@code null}. - * @since 0.1.0 */ Span.Builder spanBuilder(String spanName); } diff --git a/api/src/main/java/io/opentelemetry/trace/TracerProvider.java b/api/src/main/java/io/opentelemetry/trace/TracerProvider.java index 1119c0041f..ceb067a12a 100644 --- a/api/src/main/java/io/opentelemetry/trace/TracerProvider.java +++ b/api/src/main/java/io/opentelemetry/trace/TracerProvider.java @@ -14,7 +14,6 @@ import javax.annotation.concurrent.ThreadSafe; * * @see io.opentelemetry.OpenTelemetry * @see io.opentelemetry.trace.Tracer - * @since 0.1.0 */ @ThreadSafe public interface TracerProvider { @@ -25,7 +24,6 @@ public interface TracerProvider { * @param instrumentationName The name of the instrumentation library, not the name of the * instrument*ed* library (e.g., "io.opentelemetry.contrib.mongodb"). Must not be null. * @return a tracer instance. - * @since 0.1.0 */ Tracer get(String instrumentationName); @@ -37,7 +35,6 @@ public interface TracerProvider { * @param instrumentationVersion The version of the instrumentation library (e.g., * "semver:1.0.0"). * @return a tracer instance. - * @since 0.1.0 */ Tracer get(String instrumentationName, String instrumentationVersion); } diff --git a/api/src/main/java/io/opentelemetry/trace/TracingContextUtils.java b/api/src/main/java/io/opentelemetry/trace/TracingContextUtils.java index e197dd3915..6bb7d27efe 100644 --- a/api/src/main/java/io/opentelemetry/trace/TracingContextUtils.java +++ b/api/src/main/java/io/opentelemetry/trace/TracingContextUtils.java @@ -11,11 +11,7 @@ import io.opentelemetry.context.Scope; import javax.annotation.Nullable; import javax.annotation.concurrent.Immutable; -/** - * Util methods/functionality to interact with the {@link Context}. - * - * @since 0.1.0 - */ +/** Util methods/functionality to interact with the {@link Context}. */ @Immutable public final class TracingContextUtils { private static final ContextKey CONTEXT_SPAN_KEY = @@ -27,7 +23,6 @@ public final class TracingContextUtils { * @param span the value to be set. * @param context the parent {@code Context}. * @return a new context with the given value set. - * @since 0.1.0 */ public static Context withSpan(Span span, Context context) { return context.withValues(CONTEXT_SPAN_KEY, span); @@ -38,7 +33,6 @@ public final class TracingContextUtils { * {@link Span}. * * @return the {@link Span} from the current {@code Context}. - * @since 0.3.0 */ public static Span getCurrentSpan() { return getSpan(io.opentelemetry.context.Context.current()); @@ -50,7 +44,6 @@ public final class TracingContextUtils { * * @param context the specified {@code Context}. * @return the {@link Span} from the specified {@code Context}. - * @since 0.3.0 */ public static Span getSpan(Context context) { Span span = context.getValue(CONTEXT_SPAN_KEY); @@ -63,7 +56,6 @@ public final class TracingContextUtils { * * @param context the specified {@code Context}. * @return the {@link Span} from the specified {@code Context}. - * @since 0.1.0 */ @Nullable public static Span getSpanWithoutDefault(Context context) { @@ -76,7 +68,6 @@ public final class TracingContextUtils { * * @param span the {@link Span} to be added to the current {@code Context}. * @return the {@link Scope} for the updated {@code Context}. - * @since 0.1.0 */ public static Scope currentContextWith(Span span) { return withSpan(span, io.opentelemetry.context.Context.current()).makeCurrent(); diff --git a/api/src/main/java/io/opentelemetry/trace/spi/TracerProviderFactory.java b/api/src/main/java/io/opentelemetry/trace/spi/TracerProviderFactory.java index 824886b380..3b68f5c8f2 100644 --- a/api/src/main/java/io/opentelemetry/trace/spi/TracerProviderFactory.java +++ b/api/src/main/java/io/opentelemetry/trace/spi/TracerProviderFactory.java @@ -25,7 +25,6 @@ public interface TracerProviderFactory { * Creates a new TracerProvider. * * @return a new TracerProvider. - * @since 0.1.0 */ TracerProvider create(); } diff --git a/context_prop/src/main/java/io/opentelemetry/context/propagation/ContextPropagators.java b/context_prop/src/main/java/io/opentelemetry/context/propagation/ContextPropagators.java index 33a85851e1..5d21a704dc 100644 --- a/context_prop/src/main/java/io/opentelemetry/context/propagation/ContextPropagators.java +++ b/context_prop/src/main/java/io/opentelemetry/context/propagation/ContextPropagators.java @@ -66,8 +66,6 @@ import javax.annotation.concurrent.ThreadSafe; * } * } * } - * - * @since 0.3.0 */ @ThreadSafe public interface ContextPropagators { @@ -80,7 +78,6 @@ public interface ContextPropagators { * instance. * * @return the {@link TextMapPropagator} propagator to inject and extract data. - * @since 0.3.0 */ TextMapPropagator getTextMapPropagator(); } diff --git a/context_prop/src/main/java/io/opentelemetry/context/propagation/DefaultContextPropagators.java b/context_prop/src/main/java/io/opentelemetry/context/propagation/DefaultContextPropagators.java index 1e32a129d3..bb1044257c 100644 --- a/context_prop/src/main/java/io/opentelemetry/context/propagation/DefaultContextPropagators.java +++ b/context_prop/src/main/java/io/opentelemetry/context/propagation/DefaultContextPropagators.java @@ -20,8 +20,6 @@ import java.util.Set; * synchronically upon injection and extraction. * *

The propagation fields retrieved from all registered propagators are de-duplicated. - * - * @since 0.3.0 */ public final class DefaultContextPropagators implements ContextPropagators { private final TextMapPropagator textMapPropagator; @@ -36,7 +34,6 @@ public final class DefaultContextPropagators implements ContextPropagators { * object. * * @return a {@link DefaultContextPropagators.Builder}. - * @since 0.3.0 */ public static Builder builder() { return new Builder(); @@ -59,8 +56,6 @@ public final class DefaultContextPropagators implements ContextPropagators { * .addTextMapPropagator(new MyCustomContextPropagator()) * .build(); * } - * - * @since 0.3.0 */ public static final class Builder { List textPropagators = new ArrayList<>(); @@ -74,7 +69,6 @@ public final class DefaultContextPropagators implements ContextPropagators { * @param textMapPropagator the propagator to be added. * @return this. * @throws NullPointerException if {@code textMapPropagator} is {@code null}. - * @since 0.3.0 */ public Builder addTextMapPropagator(TextMapPropagator textMapPropagator) { if (textMapPropagator == null) { @@ -89,7 +83,6 @@ public final class DefaultContextPropagators implements ContextPropagators { * Builds a new {@code ContextPropagators} with the specified propagators. * * @return the newly created {@code ContextPropagators} instance. - * @since 0.3.0 */ public ContextPropagators build() { if (textPropagators.isEmpty()) { diff --git a/context_prop/src/main/java/io/opentelemetry/context/propagation/TextMapPropagator.java b/context_prop/src/main/java/io/opentelemetry/context/propagation/TextMapPropagator.java index e1711fdced..d940691fd4 100644 --- a/context_prop/src/main/java/io/opentelemetry/context/propagation/TextMapPropagator.java +++ b/context_prop/src/main/java/io/opentelemetry/context/propagation/TextMapPropagator.java @@ -36,8 +36,6 @@ import javax.annotation.concurrent.ThreadSafe; * } * } * } - * - * @since 0.1.0 */ @ThreadSafe public interface TextMapPropagator { @@ -50,7 +48,6 @@ public interface TextMapPropagator { * successive calls should clear these fields first. * * @return list of fields that will be used by this formatter. - * @since 0.1.0 */ // The use cases of this are: // * allow pre-allocation of fields, especially in systems like gRPC Metadata @@ -66,7 +63,6 @@ public interface TextMapPropagator { * @param carrier holds propagation fields. For example, an outgoing message or http request. * @param setter invoked for each propagation key to add or remove. * @param carrier of propagation fields, such as an http request - * @since 0.1.0 */ void inject(Context context, @Nullable C carrier, Setter setter); @@ -77,7 +73,6 @@ public interface TextMapPropagator { * allocations. * * @param carrier of propagation fields, such as an http request - * @since 0.1.0 */ interface Setter { @@ -91,7 +86,6 @@ public interface TextMapPropagator { * facilitate implementations as java lambdas, this parameter may be null. * @param key the key of the field. * @param value the value of the field. - * @since 0.1.0 */ void set(@Nullable C carrier, String key, String value); } @@ -108,7 +102,6 @@ public interface TextMapPropagator { * @param getter invoked for each propagation key to get. * @param carrier of propagation fields, such as an http request. * @return the {@code Context} containing the extracted value. - * @since 0.1.0 */ Context extract(Context context, C carrier, Getter getter); @@ -119,7 +112,6 @@ public interface TextMapPropagator { * allocations. * * @param carrier of propagation fields, such as an http request. - * @since 0.1.0 */ interface Getter { @@ -129,7 +121,6 @@ public interface TextMapPropagator { * @param carrier carrier of propagation fields, such as an http request. * @param key the key of the field. * @return the first value of the given propagation {@code key} or returns {@code null}. - * @since 0.1.0 */ @Nullable String get(C carrier, String key); diff --git a/exporters/inmemory/src/main/java/io/opentelemetry/exporters/inmemory/InMemoryTracing.java b/exporters/inmemory/src/main/java/io/opentelemetry/exporters/inmemory/InMemoryTracing.java index 3a9e98270b..37dcbc13ea 100644 --- a/exporters/inmemory/src/main/java/io/opentelemetry/exporters/inmemory/InMemoryTracing.java +++ b/exporters/inmemory/src/main/java/io/opentelemetry/exporters/inmemory/InMemoryTracing.java @@ -34,8 +34,6 @@ import javax.annotation.concurrent.Immutable; * assertThat(spans.get(0).getName()).isEqualTo("span"); * } * - * - * @since 0.1.0 */ @AutoValue @Immutable @@ -44,7 +42,6 @@ public abstract class InMemoryTracing { * Returns the {@code TracerSdkManagement} passed during construction. * * @return the {@code TracerSdkManagement} passed during construction. - * @since 0.1.0 */ abstract TracerSdkManagement getTracerSdkManagement(); @@ -52,7 +49,6 @@ public abstract class InMemoryTracing { * Returns the installed {@link InMemorySpanExporter}. * * @return the installed {@link InMemorySpanExporter}. - * @since 0.1.0 */ public abstract InMemorySpanExporter getSpanExporter(); @@ -65,11 +61,7 @@ public abstract class InMemoryTracing { return new AutoValue_InMemoryTracing.Builder(); } - /** - * Builder for {@link InMemoryTracing}. - * - * @since 0.3.0 - */ + /** Builder for {@link InMemoryTracing}. */ @AutoValue.Builder public abstract static class Builder { public abstract Builder setTracerSdkManagement(TracerSdkManagement tracerSdkManagement); @@ -84,7 +76,6 @@ public abstract class InMemoryTracing { * Builds a new {@link InMemoryTracing} with current settings. * * @return a {@code InMemoryTracing}. - * @since 0.3.0 */ public final InMemoryTracing build() { // install the HttpTraceContext propagator into the API for testing with. diff --git a/exporters/jaeger/src/main/java/io/opentelemetry/exporters/jaeger/JaegerGrpcSpanExporter.java b/exporters/jaeger/src/main/java/io/opentelemetry/exporters/jaeger/JaegerGrpcSpanExporter.java index 1296f2ce9b..41ed0d7513 100644 --- a/exporters/jaeger/src/main/java/io/opentelemetry/exporters/jaeger/JaegerGrpcSpanExporter.java +++ b/exporters/jaeger/src/main/java/io/opentelemetry/exporters/jaeger/JaegerGrpcSpanExporter.java @@ -213,7 +213,6 @@ public final class JaegerGrpcSpanExporter implements SpanExporter { * * @param endpoint The Jaeger endpoint URL, ex. "jaegerhost:14250". * @return this. - * @since 0.7.0 */ public Builder setEndpoint(String endpoint) { this.endpoint = endpoint; @@ -236,7 +235,6 @@ public final class JaegerGrpcSpanExporter implements SpanExporter { * * @param configMap {@link Map} holding the configuration values. * @return this. - * @since 0.7.0 */ @Override protected Builder fromConfigMap( diff --git a/exporters/otlp/src/main/java/io/opentelemetry/exporters/otlp/OtlpGrpcMetricExporter.java b/exporters/otlp/src/main/java/io/opentelemetry/exporters/otlp/OtlpGrpcMetricExporter.java index 55cb52a0eb..5dcdce0960 100644 --- a/exporters/otlp/src/main/java/io/opentelemetry/exporters/otlp/OtlpGrpcMetricExporter.java +++ b/exporters/otlp/src/main/java/io/opentelemetry/exporters/otlp/OtlpGrpcMetricExporter.java @@ -152,7 +152,6 @@ public final class OtlpGrpcMetricExporter implements MetricExporter { * environment. If a configuration value is missing, it uses the default value. * * @return a new {@link OtlpGrpcMetricExporter} instance. - * @since 0.5.0 */ public static OtlpGrpcMetricExporter getDefault() { return builder().readEnvironmentVariables().readSystemProperties().build(); diff --git a/exporters/otlp/src/main/java/io/opentelemetry/exporters/otlp/OtlpGrpcSpanExporter.java b/exporters/otlp/src/main/java/io/opentelemetry/exporters/otlp/OtlpGrpcSpanExporter.java index 3ddf9a6d0c..d620554195 100644 --- a/exporters/otlp/src/main/java/io/opentelemetry/exporters/otlp/OtlpGrpcSpanExporter.java +++ b/exporters/otlp/src/main/java/io/opentelemetry/exporters/otlp/OtlpGrpcSpanExporter.java @@ -154,7 +154,6 @@ public final class OtlpGrpcSpanExporter implements SpanExporter { * environment. If a configuration value is missing, it uses the default value. * * @return a new {@link OtlpGrpcSpanExporter} instance. - * @since 0.5.0 */ public static OtlpGrpcSpanExporter getDefault() { return builder().readEnvironmentVariables().readSystemProperties().build(); diff --git a/exporters/zipkin/src/main/java/io/opentelemetry/exporters/zipkin/ZipkinSpanExporter.java b/exporters/zipkin/src/main/java/io/opentelemetry/exporters/zipkin/ZipkinSpanExporter.java index f62174a07f..c79568b356 100644 --- a/exporters/zipkin/src/main/java/io/opentelemetry/exporters/zipkin/ZipkinSpanExporter.java +++ b/exporters/zipkin/src/main/java/io/opentelemetry/exporters/zipkin/ZipkinSpanExporter.java @@ -314,7 +314,6 @@ public final class ZipkinSpanExporter implements SpanExporter { * @return this. * @see io.opentelemetry.sdk.resources.Resource * @see io.opentelemetry.sdk.resources.ResourceAttributes - * @since 0.4.0 */ public Builder setServiceName(String serviceName) { this.serviceName = serviceName; @@ -329,7 +328,6 @@ public final class ZipkinSpanExporter implements SpanExporter { * * @param sender the Zipkin sender implementation. * @return this. - * @since 0.4.0 */ public Builder setSender(Sender sender) { this.sender = sender; @@ -343,7 +341,6 @@ public final class ZipkinSpanExporter implements SpanExporter { * @param encoder the {@code BytesEncoder} to use. * @return this. * @see SpanBytesEncoder - * @since 0.4.0 */ public Builder setEncoder(BytesEncoder encoder) { this.encoder = encoder; @@ -357,7 +354,6 @@ public final class ZipkinSpanExporter implements SpanExporter { * @param endpoint The Zipkin endpoint URL, ex. "http://zipkinhost:9411/api/v2/spans". * @return this. * @see OkHttpSender - * @since 0.4.0 */ public Builder setEndpoint(String endpoint) { this.endpoint = endpoint; @@ -389,7 +385,6 @@ public final class ZipkinSpanExporter implements SpanExporter { * Builds a {@link ZipkinSpanExporter}. * * @return a {@code ZipkinSpanExporter}. - * @since 0.4.0 */ public ZipkinSpanExporter build() { if (sender == null) { diff --git a/extensions/trace_propagators/src/main/java/io/opentelemetry/extensions/trace/propagation/TraceMultiPropagator.java b/extensions/trace_propagators/src/main/java/io/opentelemetry/extensions/trace/propagation/TraceMultiPropagator.java index 1db352779a..419b8c96d0 100644 --- a/extensions/trace_propagators/src/main/java/io/opentelemetry/extensions/trace/propagation/TraceMultiPropagator.java +++ b/extensions/trace_propagators/src/main/java/io/opentelemetry/extensions/trace/propagation/TraceMultiPropagator.java @@ -47,8 +47,6 @@ import javax.annotation.concurrent.Immutable; * Context context = OpenTelemetry.getPropagators().getTextMapPropagator() * .extract(context, carrier, carrierGetter); * } - * - * @since 0.6.0 */ @Immutable public class TraceMultiPropagator implements TextMapPropagator { @@ -71,7 +69,6 @@ public class TraceMultiPropagator implements TextMapPropagator { * object. * * @return a {@link TraceMultiPropagator.Builder}. - * @since 0.6.0 */ public static Builder builder() { return new Builder(); @@ -82,7 +79,6 @@ public class TraceMultiPropagator implements TextMapPropagator { * read-only. * * @return list of fields defined in all the registered propagators. - * @since 0.6.0 */ @Override public List fields() { @@ -97,7 +93,6 @@ public class TraceMultiPropagator implements TextMapPropagator { * @param carrier holds propagation fields. For example, an outgoing message or http request. * @param setter invoked for each propagation key to add or remove. * @param carrier of propagation fields, such as an http request - * @since 0.6.0 */ @Override public void inject(Context context, C carrier, Setter setter) { @@ -116,7 +111,6 @@ public class TraceMultiPropagator implements TextMapPropagator { * @param getter invoked for each propagation key to get. * @param carrier of propagation fields, such as an http request. * @return the {@code Context} containing the extracted value. - * @since 0.6.0 */ @Override public Context extract(Context context, C carrier, Getter getter) { @@ -137,8 +131,6 @@ public class TraceMultiPropagator implements TextMapPropagator { /** * {@link Builder} is used to construct a new {@code TraceMultiPropagator} object with the * specified propagators. - * - * @since 0.6.0 */ public static class Builder { private final List propagators; @@ -156,7 +148,6 @@ public class TraceMultiPropagator implements TextMapPropagator { * @param propagator the propagator to be added. * @return this. * @throws NullPointerException if {@code propagator} is {@code null}. - * @since 0.6.0 */ public Builder addPropagator(TextMapPropagator propagator) { Objects.requireNonNull(propagator, "propagator"); @@ -169,7 +160,6 @@ public class TraceMultiPropagator implements TextMapPropagator { * Builds a new {@code TraceMultiPropagator} with the specified propagators. * * @return the newly created {@code TraceMultiPropagator} instance. - * @since 0.6.0 */ public TraceMultiPropagator build() { return new TraceMultiPropagator(propagators); diff --git a/extensions/trace_utils/src/main/java/io/opentelemetry/extensions/trace/MessageEvent.java b/extensions/trace_utils/src/main/java/io/opentelemetry/extensions/trace/MessageEvent.java index d068aef1ca..e97bc18fbd 100644 --- a/extensions/trace_utils/src/main/java/io/opentelemetry/extensions/trace/MessageEvent.java +++ b/extensions/trace_utils/src/main/java/io/opentelemetry/extensions/trace/MessageEvent.java @@ -20,8 +20,6 @@ import javax.annotation.concurrent.Immutable; * *

It requires a {@link Type type} and a message id that serves to uniquely identify each * message. It can optionally have information about the message size. - * - * @since 0.1.0 */ @Immutable public final class MessageEvent { @@ -32,23 +30,11 @@ public final class MessageEvent { private static final AttributeKey COMPRESSED_SIZE = longKey("message.compressed_size"); private static final AttributeKey UNCOMPRESSED_SIZE = longKey("message.uncompressed_size"); - /** - * Available types for a {@code MessageEvent}. - * - * @since 0.1.0 - */ + /** Available types for a {@code MessageEvent}. */ public enum Type { - /** - * When the message was sent. - * - * @since 0.1.0 - */ + /** When the message was sent. */ SENT, - /** - * When the message was received. - * - * @since 0.1.0 - */ + /** When the message was received. */ RECEIVED, } @@ -62,7 +48,6 @@ public final class MessageEvent { * available use 0. * @param compressedSize represents the compressed size in bytes of this message. If not available * use 0. - * @since 0.1.0 */ public static void record( Span span, Type type, long messageId, long uncompressedSize, long compressedSize) { diff --git a/opentracing_shim/src/main/java/io/opentelemetry/opentracingshim/TraceShim.java b/opentracing_shim/src/main/java/io/opentelemetry/opentracingshim/TraceShim.java index afcc8769df..b2be02a4cd 100644 --- a/opentracing_shim/src/main/java/io/opentelemetry/opentracingshim/TraceShim.java +++ b/opentracing_shim/src/main/java/io/opentelemetry/opentracingshim/TraceShim.java @@ -19,7 +19,6 @@ public final class TraceShim { * {@code OpenTelemetry.getBaggageManager()}. * * @return a {@code io.opentracing.Tracer}. - * @since 0.1.0 */ public static io.opentracing.Tracer createTracerShim() { return new TracerShim( @@ -36,7 +35,6 @@ public final class TraceShim { * @param tracerProvider the {@code TracerProvider} used by this shim. * @param contextManager the {@code BaggageManager} used by this shim. * @return a {@code io.opentracing.Tracer}. - * @since 0.1.0 */ public static io.opentracing.Tracer createTracerShim( TracerProvider tracerProvider, BaggageManager contextManager) { diff --git a/sdk/common/src/main/java/io/opentelemetry/sdk/resources/ResourcesConfig.java b/sdk/common/src/main/java/io/opentelemetry/sdk/resources/ResourcesConfig.java index 5032341e8b..5c4b8e41c8 100644 --- a/sdk/common/src/main/java/io/opentelemetry/sdk/resources/ResourcesConfig.java +++ b/sdk/common/src/main/java/io/opentelemetry/sdk/resources/ResourcesConfig.java @@ -47,7 +47,6 @@ public abstract class ResourcesConfig { * Returns the default {@code ResourcesConfig}. * * @return the default {@code ResourcesConfig}. - * @since 0.9.0 */ public static ResourcesConfig getDefault() { return DEFAULT; diff --git a/sdk/metrics/src/main/java/io/opentelemetry/sdk/metrics/export/IntervalMetricReader.java b/sdk/metrics/src/main/java/io/opentelemetry/sdk/metrics/export/IntervalMetricReader.java index b2d5be8e3b..b32ea3acf6 100644 --- a/sdk/metrics/src/main/java/io/opentelemetry/sdk/metrics/export/IntervalMetricReader.java +++ b/sdk/metrics/src/main/java/io/opentelemetry/sdk/metrics/export/IntervalMetricReader.java @@ -82,7 +82,6 @@ public final class IntervalMetricReader { * the environment. If a configuration value is missing, it uses the default value. * * @return a new {@link Builder} for {@link IntervalMetricReader}. - * @since 0.4.0 */ public static Builder builderFromDefaultSources() { return builder().readEnvironmentVariables().readSystemProperties(); diff --git a/sdk/tracing/src/main/java/io/opentelemetry/sdk/trace/data/ImmutableStatus.java b/sdk/tracing/src/main/java/io/opentelemetry/sdk/trace/data/ImmutableStatus.java index 33788c049f..4fc8f88e5b 100644 --- a/sdk/tracing/src/main/java/io/opentelemetry/sdk/trace/data/ImmutableStatus.java +++ b/sdk/tracing/src/main/java/io/opentelemetry/sdk/trace/data/ImmutableStatus.java @@ -60,7 +60,6 @@ abstract class ImmutableStatus implements SpanData.Status { * * @param description the new description of the {@code Status}. * @return The newly created {@code Status} with the given description. - * @since 0.1.0 */ public static SpanData.Status create( StatusCanonicalCode canonicalCode, @Nullable String description) { diff --git a/sdk/tracing/src/main/java/io/opentelemetry/sdk/trace/data/SpanData.java b/sdk/tracing/src/main/java/io/opentelemetry/sdk/trace/data/SpanData.java index 6e83383c58..3d69a4e067 100644 --- a/sdk/tracing/src/main/java/io/opentelemetry/sdk/trace/data/SpanData.java +++ b/sdk/tracing/src/main/java/io/opentelemetry/sdk/trace/data/SpanData.java @@ -217,7 +217,6 @@ public interface SpanData { * Returns the {@code SpanContext}. * * @return the {@code SpanContext}. - * @since 0.1.0 */ SpanContext getContext(); @@ -225,7 +224,6 @@ public interface SpanData { * Returns the set of attributes. * * @return the set of attributes. - * @since 0.1.0 */ Attributes getAttributes(); @@ -272,7 +270,6 @@ public interface SpanData { * Return the name of the {@code Event}. * * @return the name of the {@code Event}. - * @since 0.1.0 */ String getName(); @@ -280,7 +277,6 @@ public interface SpanData { * Return the attributes of the {@code Event}. * * @return the attributes of the {@code Event}. - * @since 0.1.0 */ Attributes getAttributes(); diff --git a/sdk_extensions/logging/src/main/java/io/opentelemetry/sdk/logging/data/AnyValue.java b/sdk_extensions/logging/src/main/java/io/opentelemetry/sdk/logging/data/AnyValue.java index db53c60ff9..55c8bc4e81 100644 --- a/sdk_extensions/logging/src/main/java/io/opentelemetry/sdk/logging/data/AnyValue.java +++ b/sdk_extensions/logging/src/main/java/io/opentelemetry/sdk/logging/data/AnyValue.java @@ -16,8 +16,6 @@ import javax.annotation.concurrent.Immutable; * types of values: {@code String}, {@code boolean}, {@code int}, {@code double}, {@code array}, or * {@code kvlist}. represented through {@code AnyValue.Type}. A {@code array} or a {@code kvlist} * can in turn hold other {@code AnyValue} instances, allowing for mapping to JSON-like structures. - * - * @since 0.9.0 */ @Immutable public abstract class AnyValue { diff --git a/sdk_extensions/tracing_incubator/src/main/java/io/opentelemetry/sdk/extensions/incubator/trace/data/SpanDataBuilder.java b/sdk_extensions/tracing_incubator/src/main/java/io/opentelemetry/sdk/extensions/incubator/trace/data/SpanDataBuilder.java index 3fa779a06c..9b7710b176 100644 --- a/sdk_extensions/tracing_incubator/src/main/java/io/opentelemetry/sdk/extensions/incubator/trace/data/SpanDataBuilder.java +++ b/sdk_extensions/tracing_incubator/src/main/java/io/opentelemetry/sdk/extensions/incubator/trace/data/SpanDataBuilder.java @@ -107,11 +107,7 @@ public abstract class SpanDataBuilder implements SpanData { return false; } - /** - * A {@code Builder} class for {@link SpanDataBuilder}. - * - * @since 0.1.0 - */ + /** A {@code Builder} class for {@link SpanDataBuilder}. */ @AutoValue.Builder abstract static class Builder { diff --git a/testing_internal/src/main/java/io/opentelemetry/sdk/trace/TestSpanData.java b/testing_internal/src/main/java/io/opentelemetry/sdk/trace/TestSpanData.java index 25e37284f0..78f5cfa5e1 100644 --- a/testing_internal/src/main/java/io/opentelemetry/sdk/trace/TestSpanData.java +++ b/testing_internal/src/main/java/io/opentelemetry/sdk/trace/TestSpanData.java @@ -21,8 +21,6 @@ import javax.annotation.concurrent.Immutable; /** * Immutable representation of all data collected by the {@link io.opentelemetry.trace.Span} class. - * - * @since 0.1.0 */ @Immutable @AutoValue @@ -32,7 +30,6 @@ public abstract class TestSpanData implements SpanData { * Creates a new Builder for creating an SpanData instance. * * @return a new Builder. - * @since 0.1.0 */ public static Builder builder() { return new AutoValue_TestSpanData.Builder() @@ -50,11 +47,7 @@ public abstract class TestSpanData implements SpanData { .setTotalAttributeCount(0); } - /** - * A {@code Builder} class for {@link TestSpanData}. - * - * @since 0.1.0 - */ + /** A {@code Builder} class for {@link TestSpanData}. */ @AutoValue.Builder public abstract static class Builder { @@ -68,7 +61,6 @@ public abstract class TestSpanData implements SpanData { * Create a new SpanData instance from the data in this. * * @return a new SpanData instance - * @since 0.1.0 */ public TestSpanData build() { // make unmodifiable copies of any collections @@ -108,7 +100,6 @@ public abstract class TestSpanData implements SpanData { * * @param parentSpanId the SpanId of the parent * @return this. - * @since 0.1.0 */ public abstract Builder setParentSpanId(String parentSpanId); @@ -117,7 +108,6 @@ public abstract class TestSpanData implements SpanData { * * @param resource the Resource that generated this span. * @return this - * @since 0.1.0 */ public abstract Builder setResource(Resource resource); @@ -127,7 +117,6 @@ public abstract class TestSpanData implements SpanData { * @param instrumentationLibraryInfo the instrumentation library of the tracer which created * this span. * @return this - * @since 0.2.0 */ public abstract Builder setInstrumentationLibraryInfo( InstrumentationLibraryInfo instrumentationLibraryInfo); @@ -137,7 +126,6 @@ public abstract class TestSpanData implements SpanData { * * @param name the name. * @return this - * @since 0.1.0 */ public abstract Builder setName(String name); @@ -146,7 +134,6 @@ public abstract class TestSpanData implements SpanData { * * @param epochNanos the start epoch timestamp in nanos. * @return this - * @since 0.1.0 */ public abstract Builder setStartEpochNanos(long epochNanos); @@ -155,7 +142,6 @@ public abstract class TestSpanData implements SpanData { * * @param epochNanos the end epoch timestamp in nanos. * @return this - * @since 0.1.0 */ public abstract Builder setEndEpochNanos(long epochNanos); @@ -166,7 +152,6 @@ public abstract class TestSpanData implements SpanData { * @param attributes {@link ReadableAttributes} for this span. * @return this * @see ReadableAttributes - * @since 0.1.0 */ public abstract Builder setAttributes(ReadableAttributes attributes); @@ -176,7 +161,6 @@ public abstract class TestSpanData implements SpanData { * @param events A List<Event> of events associated with this span. * @return this * @see Event - * @since 0.1.0 */ public abstract Builder setEvents(List events); @@ -185,7 +169,6 @@ public abstract class TestSpanData implements SpanData { * * @param status The Status of this span. * @return this - * @since 0.1.0 */ public abstract Builder setStatus(Status status); @@ -194,7 +177,6 @@ public abstract class TestSpanData implements SpanData { * * @param kind The Kind of span. * @return this - * @since 0.1.0 */ public abstract Builder setKind(Kind kind); @@ -203,7 +185,6 @@ public abstract class TestSpanData implements SpanData { * * @param links A List<Link> * @return this - * @since 0.1.0 */ public abstract Builder setLinks(List links); @@ -212,7 +193,6 @@ public abstract class TestSpanData implements SpanData { * * @param hasRemoteParent A boolean indicating if the span has a remote parent. * @return this - * @since 0.3.0 */ public abstract Builder setHasRemoteParent(boolean hasRemoteParent); @@ -221,7 +201,6 @@ public abstract class TestSpanData implements SpanData { * * @param hasEnded A boolean indicating if the span has been ended. * @return this - * @since 0.4.0 */ public abstract Builder setHasEnded(boolean hasEnded); @@ -230,7 +209,6 @@ public abstract class TestSpanData implements SpanData { * * @param totalRecordedEvents The total number of events recorded. * @return this - * @since 0.4.0 */ public abstract Builder setTotalRecordedEvents(int totalRecordedEvents); @@ -239,7 +217,6 @@ public abstract class TestSpanData implements SpanData { * * @param totalRecordedLinks The total number of links recorded. * @return this - * @since 0.4.0 */ public abstract Builder setTotalRecordedLinks(int totalRecordedLinks);