Prepare release 1.19.0 (#4821)

* wip

* Add changelog entry for 1.19.0

* Add new since annotations

* Add late additions to changelog

* PR feedback

* Fix 1.18.0 ref

CHANGELOG.md

@@ -2,10 +2,99 @@
 
 ## Unreleased
 
-* Autoconfigure now supports an option to disable the SDK.
-  If `otel.sdk.disabled=true`, `AutoConfiguredOpenTelemetrySdk#getOpenTelemetrySdk()`
-  returns a minimal (but not noop) `OpenTelemetrySdk` with noop tracing, metric and logging providers. The same minimal instance is set
-  to `GlobalOpenTelemetry`. The now deprecated property `otel.experimental.sdk.enabled` will continue to work in the same way during a transition period.
+This release contains a large number of changes to the log signal following a series of significant
+changes to
+the [log specification](https://github.com/open-telemetry/opentelemetry-specification/tree/main/specification/logs).
+The changes include renaming key classes like `LogExporter` to `LogRecordExporter`,
+and `LogProcessor` to `LogRecordProcessor`, and `LogEmitter` to `Logger`, and more. Additionally, a
+log API component has been added for emitting events and for writing log appenders. Note, the log
+API is not a substitute for traditional log frameworks like Log4j, JUL, SLF4J, or Logback. While the
+event portion of the API is intended for instrumentation authors and end users, the API for emitting
+LogRecords is not.
+See [LoggerProvider](./api/logs/src/main/java/io/opentelemetry/api/logs/LoggerProvider.java)
+and [Logger](./api/logs/src/main/java/io/opentelemetry/api/logs/Logger.java) javadoc for more
+details.
+
+### General
+
+* Add `opentelemetry-bom` as a dependency to `opentelemetry-bom-alpha`, ensuring synchronization
+  between alpha and stable artifact versions.
+
+### API
+
+#### API Extensions
+
+* WARNING: `opentelemetry-extension-annotations` has been removed following its relocation
+  to [opentelemetry-java-instrumentation/instrumentation-annotations](https://github.com/open-telemetry/opentelemetry-java-instrumentation/tree/main/instrumentation-annotations),
+  which is published under
+  coordinates `io.opentelemetry.instrumentation:opentelemetry-instrumentation-annotations:{version}`.
+  We will push security patches to `1.18.x` as needed. The latest `opentelemetry-bom` will point
+  to the latest published version, currently `1.18.0`.
+
+#### Logs
+
+* Introduce log API for emitting events and writing log appenders. The artifact is available at
+  coordinates `io.opentelemetry:opentelemetry-api-logs:1.19.0-alpha`.
+
+### SDK
+
+#### Metrics
+
+* Change exponential histogram bucket boundaries to be lower exclusive / upper inclusive, instead of
+  lower inclusive / upper exclusive.
+
+#### Logs
+
+* BREAKING: Rename `SdkLogEmitterProvider` to `SdkLoggerProvider`.
+  `OpenTelemetrySdkBuilder#setLogEmitterProvider` has changed
+  to `OpenTelemetrySdkBuilder#setLoggerProvider`. `OpenTelemetrySdk#getSdkLogEmitterProvider` has
+  changed to `OpenTelemetrySdk#getSdkLoggerProvider`.
+  `AutoConfigurationCustomizer#addLogEmitterProviderCustomizer` has changed
+  to `AutoConfigurationCustomizer#addLoggerProviderCustomizer`.
+* BREAKING: Rename `LogEmitter` to `Logger`.
+* BREAKING: Rename `LogExporter` to `LogRecordExporter`. `SystemOutLogExporter` has changed
+  to `SystemOutLogRecordExporter`. `OtlpJsonLoggingLogExporter` has changed
+  to `OtlpJsonLoggingLogRecordExporter`. `OtlpHttpLogExporter` has changed
+  to `OtlpHttpLogRecordExporter`. `OtlpGrpcLogExporter` has changed to `OtlpGrpcLogRecordExporter`.
+  `InMemoryLogExporter` has changed to `InMemoryLogRecordExporter`.
+  ConfigurableLogExporterProvider` has changed to `ConfigurableLogRecordExporterProvider`.
+* BREAKING: Rename `LogData` to `LogRecordData`. `TestLogData` has changed to `TestLogRecordData`.
+* BREAKING: Rename `LogProcessor` to `LogRecordProcessor`. `BatchLogProcessor` has changed
+  to `BatchLogRecordProcessor`. `SimpleLogProcessor` has changed to `SimpleLogRecordProcessor`.
+
+#### Exporter
+
+* OTLP log record exporters now
+  include [dropped_attributes_count](https://github.com/open-telemetry/opentelemetry-proto/blob/main/opentelemetry/proto/logs/v1/logs.proto#L157).
+
+#### SDK Extensions
+
+* Autoconfigure now supports an option to disable the SDK. If `otel.sdk.disabled=true`,
+  `AutoConfiguredOpenTelemetrySdk#getOpenTelemetrySdk()` returns a minimal (but not
+  noop) `OpenTelemetrySdk` with noop tracing, metric and logging providers. The same minimal
+  instance is set to `GlobalOpenTelemetry`. The now deprecated
+  property `otel.experimental.sdk.enabled` will continue to work in the same way during a transition
+  period.
+* Fix `ProcessResource` directory separator to use `/` or `\` instead of `:` or `;`.
+* DEPRECATION: the `opentelemetry-sdk-extension-resource` module containing
+  various `ResourceProvider` implementations has been deprecated for removal in next major version.
+  A copy of the code will instead be maintained
+  in [opentelemetry-java-instrumentation/instrumentation/resources/library](https://github.com/open-telemetry/opentelemetry-java-instrumentation/tree/main/instrumentation/resources/library)
+  and published under
+  coordinates `io.opentelemetry.instrumentation:opentelemetry-resources:{version}`.
+* DEPRECATION: the `opentelemetry-sdk-extension-aws` module containing AWS `ResourceProvider`
+  implementations has been deprecated for removal in next major version. A copy of the code will
+  instead be maintained
+  in [opentelemetry-java-contrib/aws-resources](https://github.com/open-telemetry/opentelemetry-java-contrib/tree/main/aws-resources)
+  and published under coordinates `io.opentelemetry.contrib:opentelemetry-aws-resources:{version}`.
+
+### OpenTracing Shim
+
+* Fully support Baggage-only propagation.
+
+### Semantic conventions
+
+* The semantic conventions have been updated to 1.13.0.
 
 ## Version 1.18.0 (2022-09-09)
 

exporters/logging-otlp/src/main/java/io/opentelemetry/exporter/logging/otlp/OtlpJsonLoggingLogRecordExporter.java

@@ -21,6 +21,8 @@ import java.util.logging.Logger;
 /**
  * A {@link LogRecordExporter} which writes {@linkplain LogRecordData logs} to a {@link Logger} in
  * OTLP JSON format. Each log line will include a single {@code ResourceLogs}.
+ *
+ * @since 1.19.0
  */
 public final class OtlpJsonLoggingLogRecordExporter implements LogRecordExporter {
 

exporters/logging/src/main/java/io/opentelemetry/exporter/logging/SystemOutLogRecordExporter.java

@@ -22,6 +22,8 @@ import java.util.Collection;
  *
  * <p>Note: this doesn't use a {@code java.util.logging Logger}, as that could result in
  * logging-loops if an OTel appender is configured for {@code java.util.logging}.
+ *
+ * @since 1.19.0
  */
 @SuppressWarnings("SystemOut")
 public class SystemOutLogRecordExporter implements LogRecordExporter {

sdk-extensions/autoconfigure-spi/src/main/java/io/opentelemetry/sdk/autoconfigure/spi/AutoConfigurationCustomizer.java

@@ -141,6 +141,8 @@ public interface AutoConfigurationCustomizer {
    * customization. The return value of the {@link BiFunction} will replace the passed-in argument.
    *
    * <p>Multiple calls will execute the customizers in order.
+   *
+   * @since 1.19.0
    */
   default AutoConfigurationCustomizer addLoggerProviderCustomizer(
       BiFunction<SdkLoggerProviderBuilder, ConfigProperties, SdkLoggerProviderBuilder>
@@ -154,6 +156,8 @@ public interface AutoConfigurationCustomizer {
    * argument.
    *
    * <p>Multiple calls will execute the customizers in order.
+   *
+   * @since 1.19.0
    */
   default AutoConfigurationCustomizer addLogRecordExporterCustomizer(
       BiFunction<? super LogRecordExporter, ConfigProperties, ? extends LogRecordExporter>

sdk-extensions/autoconfigure-spi/src/main/java/io/opentelemetry/sdk/autoconfigure/spi/logs/ConfigurableLogRecordExporterProvider.java

@@ -14,7 +14,7 @@ import io.opentelemetry.sdk.logs.export.LogRecordExporter;
  * returned by {@link #getName()}, the exporter returned by {@link
  * #createExporter(ConfigProperties)} will be enabled and added to the SDK.
  *
- * @since 1.17.0
+ * @since 1.19.0
  */
 public interface ConfigurableLogRecordExporterProvider {
 

sdk/all/src/main/java/io/opentelemetry/sdk/OpenTelemetrySdk.java

@@ -64,7 +64,11 @@ public final class OpenTelemetrySdk implements OpenTelemetry {
     return meterProvider.unobfuscate();
   }
 
-  /** Returns the {@link SdkLoggerProvider} for this {@link OpenTelemetrySdk}. */
+  /**
+   * Returns the {@link SdkLoggerProvider} for this {@link OpenTelemetrySdk}.
+   *
+   * @since 1.19.0
+   */
   public SdkLoggerProvider getSdkLoggerProvider() {
     return loggerProvider;
   }

sdk/all/src/main/java/io/opentelemetry/sdk/OpenTelemetrySdkBuilder.java

@@ -57,6 +57,7 @@ public final class OpenTelemetrySdkBuilder {
    * returning the instance created by a {@link SdkLoggerProviderBuilder}.
    *
    * @see SdkLoggerProvider#builder()
+   * @since 1.19.0
    */
   public OpenTelemetrySdkBuilder setLoggerProvider(SdkLoggerProvider loggerProvider) {
     this.loggerProvider = loggerProvider;