ZeroTierOne/ext/opentelemetry-cpp-1.21.0/CHANGELOG.md

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Guideline to update the version

Increment the:

• MAJOR version when you make incompatible API/ABI changes,
• MINOR version when you add functionality in a backwards compatible manner, and
• PATCH version when you make backwards compatible bug fixes.

[Unreleased]

[1.21 2025-05-28]

• [BUILD] Remove WITH_ABSEIL #3318

• [INSTALL] Add CMake components to the opentelemetry-cpp package #3320

• [CI] Harden GitHub Actions #3338

• [StepSecurity] Harden GibHub Actions, part 2 #3340

• Bump github/codeql-action from 3.28.12 to 3.28.13 #3341

• [DEVCONTAINER] expose cmake version setting as docker arg and environment variable #3347

• [CI] disable bzip2 in conan builds #3352

• [SEMANTIC CONVENTIONS] Upgrade semantic conventions to 1.32.0 #3351

• Bump github/codeql-action from 3.28.13 to 3.28.15 #3353

• [CMAKE] bump cmake minimum required version to 3.14 #3349

• Bump codecov/codecov-action from 5.4.0 to 5.4.2 #3362

• [DOC] Fix documentation tags in logger API #3371

• [CI] fix artifacts download/upload #3369

• [API] Add Enabled method to Tracer #3357

• [BUILD] Fixes warnings of ciso646 in C++17 #3360

• Bump github/codeql-action from 3.28.15 to 3.28.16 #3377

• Bump step-security/harden-runner from 2.11.1 to 2.12.0 #3373

• Bump docker/build-push-action from 6.15.0 to 6.16.0 #3382

• Bump actions/download-artifact from 4.2.1 to 4.3.0 #3381

• [CI] Harden Github actions - pinned-dependencies (part -1) #3380

• [StepSecurity] ci: Harden GitHub Actions #3378

• [SDK] Base2 exponential histogram aggregation #3346

• [StepSecurity] ci: Harden GitHub Actions #3379

• [BUILD] Fixes glibc++ 5 checking #3355

• [TEST] Add stress test for histogram metric for multiple threads validation #3388

• Bump github/codeql-action from 3.28.16 to 3.28.17 #3389

• [SDK] Optimize PeriodicExportingMetricReader Thread Usage #3383

• [Metrics SDK] Use nostd::function_ref in AttributesHashMap #3393

• [SDK] support aggregation of identical instruments #3358

• [BUILD] Fixes unused var #3397

• [INSTALL] Unify cmake install functions and dynamically set component dependencies #3368

• [BUILD] Upgrade nlohmann_json to 3.12.0 #3406

• [BUILD] Upgrade opentelemetry-proto to 1.6.0 #3407

• [CMAKE] add generated protobuf headers to the opentelemetry_proto target #3400

• [MERGE] Fix accidental rollback of nlohmann-json submodule #3415

• Bump fossas/fossa-action from 1.6.0 to 1.7.0 #3414

• Bump docker/build-push-action from 6.16.0 to 6.17.0 #3420

• Bump codecov/codecov-action from 5.4.2 to 5.4.3 #3419

• [SEMANTIC CONVENTIONS] Upgrade semantic conventions to 1.33 #3416

• [DOCS] update the INSTALL guide on cmake components #3422

• Bump github/codeql-action from 3.28.17 to 3.28.18 #3423

• [CMAKE] update cmake files in examples directory #3421

• [SDK] Fix Base2ExponentialHistogramAggregation Merge with empty buckets #3425

• [SDK] Fix MetricProducer interface #3413

• [CMAKE] remove global include_directories usage and rely on target properties #3426

• [BUILD] remove unused WITH_CURL build flag #3429

• [SEMANTIC CONVENTIONS] Upgrade to semantic conventions 1.34.0 #3428

• [EXPORTER] ostream log exporter, fix memory ownership issues #3417

• [TEST] add all components to the cmake fetch content test #3433

• [BUILD] Error out when building DLL without MSVC #3438

• [BUILD] Add missing CMake keyword for target_link_libraries #3442

• [CMAKE] Remove third-party version mismatch warning #3432

• Bump docker/build-push-action from 6.17.0 to 6.18.0 #3446

• [SEMANTIC CONVENTIONS] Fix comment style to preserve markup. #3444

• [EXPORTER] support unix sockets in grpc client #3410

• [BUILD] Propagate INTERFACE_COMPILE_DEFINITIONS from API through common_foo_library #3440

New Features:

• [SDK] Base2 exponential histogram aggregation #3346

  • Add base2 exponential histogram aggregation. Includes a new aggregation type, ostream exporter, and otlp/grpc exporter. Updated histogram aggregation and benchmark tests.

Important changes:

• [EXPORTER] ostream log exporter, fixed memory ownership issues #3417

  • In the SDK, the following classes implementation has changed:

  • opentelemetry::sdk::logs::ReadableLogRecord

  • opentelemetry::sdk::logs::ReadWriteLogRecord

  • An application implementing a custom log record exporter, that reuses these classes from the opentelemetry-cpp SDK, will need code adjustments, in particular for methods:

  • GetBody()

  • GetAttributes()

  • Applications not using these SDK classes directly are not affected.

• [BUILD] Remove WITH_ABSEIL #3318

  • The build option WITH_ABSEIL is no longer used, and opentelemetry-cpp will no longer use any release of abseil provided externally, for its own use.

  • Instead, opentelemetry-cpp will only use an internal abseil version.

  • This change resolves long standing binary integrity issues, that occurred in the past when mixing several versions of abseil in the build.

[1.20 2025-04-01]

• [BUILD] Update opentelemetry-proto version #3254

• [BUILD] Build break with CURL 7.29.0 #3255

• [SEMANTIC CONVENTIONS] Upgrade to semantic conventions 1.30.0 #3258

• [SDK] Add tracer scope configurator #3137

• [DOC] Add document and example for sharing gRPC Client #3260

• [SDK] Fix BatchLogRecordProcessor to instrument shutdown #3262

• [SDK] Support OTEL_SDK_DISABLED environment variable #3245

• [CI] OTLP in Windows builds #3263

• [BUILD] Fixes compatibility of type_traits #3274

• [BUILD] Fix compilation with Regex being disabled #3276

• [EXPORTER] Support exporting event_name using OTLP Exporter #3277

• [CI] Add FOSSA scanning workflow #3279

• [BUILD] Adding typecast without whom c++latest build fails #3281

• [ADMIN] Add FOSSA badges #3280

• [BUILD] Fix compiling problems with abiv2 and MSVC #3284

• [BUILD] Enable old behavior of CMP0092 #3269

• [SDK] Add meter scope configurator #3268

• [DEVCONTAINER] Support customization and run as non-root user #3270

• [ETW] Add configuration to export 64-bit integer as timestamp #3286

• [API] Deprecate event logger #3285

• [BUILD] Add link directory to support curl 8.12 #3272

• [API] Change the param-pack unpacking order to start from left to right #3296

• [SDK] Implement spec: MetricFilter #3235

• [SEMANTIC CONVENTIONS] Upgrade semantic conventions to 1.31.0 #3297

• [SDK] Add logger scope configurator #3282

• [EXAMPLE] fix buffer overrun in the gRPC sample project #3304

• [CI] Bump fossas/fossa-action from 1.5.0 to 1.6.0 #3305

• [TEST] fix segfault in singleton test with cmake on macos-latest #3316

• [TEST] fix test failure with elasticsearch exporter on cxx20 #3308

• [TEST] otlp grpc exporter retry test fix #3311

• [SDK] Use OPENTELEMETRY_EXPORT and static local variables #3314

• [BUILD] Fix elasticsearch exporter json compatibility #3313

• [BUILD] Fix missing exported definition for OTLP file exporter and forceflush #3319

• [BUILD] Remove gRPC header including in OtlpGrpcClientFactory #3321

• [ADMIN] Add Pranav Sharma in cpp-approvers #3323

• [DEVCONTAINER] fix grpc install #3325

• [ADMIN] Add dbarker to approvers #3331

• [CI] Upgrade CI to ubuntu 22.04 #3330

• [CI] Add ossf-scorecard scanning workflow #3332

• [CI] pin cmake in ci and devcontainer #3336

• [METRICS SDK] Fix hash collision in MetricAttributes #3322

Important changes:

• [SDK] Support OTEL_SDK_DISABLED environment variable #3245

  • The SDK now exposes the following new methods:

  • opentelemetry::sdk::trace::Provider::SetTracerProvider()

  • opentelemetry::sdk::metrics::Provider::SetMeterProvider()

  • opentelemetry::sdk::logs::Provider::SetLoggerProvider()

  • These methods do support the OTEL_SDK_DISABLED environment variable, unlike the corresponding existing API Provider classes.

  • Applications are encouraged to migrate from the API to the SDK Provider classes, to benefit from this feature.

  • All the example code has been updated to reflect the new usage.

[1.19 2025-01-22]

• [PROMETHEUS_EXPORTER] Fix default for emitting otel_scope attributes #3171

• [Code health] Include what you use cleanup, part 5 #3140

• [BUILD] Upgrade cmake #3167

• [SHIM] Fix string_view mappings between OT and OTel #3181

• [EXPORTER] Refactor ElasticSearchRecordable #3164

• [SEMANTIC CONVENTIONS] Upgrade to semantic conventions 1.29.0 #3182

• [BUILD] Fix cross-compilation with protoc #3186

• [Code health] Perform cppcheck cleanup #3150

• [EXPORTER] add instrumentation scope attributes to otlp proto messages for traces and metrics #3185

• [SDK] Tracer provider shutdown blocks in-definitively #3191

• [SEMANTIC CONVENTIONS] Upgrade to weaver 0.11.0 #3194

• [DOC] Update existing maintaining dependencies doc #3195

• [TEST] Change iscalled and gotresponse to use atomic #3204

• [SEMANTIC CONVENTIONS] update links to openmetrics to reference the v1.0.0 release #3205

• [CI] Fix CI on ubuntu-latest #3207

• [BUILD] Build break using protoc 3.14 #3211

• [TEST] Build the singleton test on windows #3183

• [BUILD] Add cxx feature detections #3203

• [SDK] Do not frequently create and destroy http client threads #3198

• [EXPORTER] Optimize OTLP HTTP compression #3178

• [SDK] Fix include instrumentation scope attributes in equal method #3214

• Upgrade to opentelemetry-proto 1.5.0 #3210

• [TEST] Added support for SELINUX in functional tests #3212

• [EDITORIAL] fix changelog entry for PR 3185 #3217

• [TEST] Functional tests for OTLP/gRPC with mutual TLS #3227

• [SEMCONV] Metrics are incorrectly prefixed with 'metric' #3228

• [BUILD] Add OTLP/file exporter for dll and examples #3231

• [Code Health] Include what you use, part 6 #3216

• [CI] Spurious test failures #3233

• [BUILD] Fix error ‘uint8_t’ does not name a type with gcc-15 #3240

• [EXPORTER] fix throw in OtlpGrpcMetricExporter with shared grpc client #3243

• [SDK] Better control of threads executed by opentelemetry-cpp #3175

• [Code Health] Include what you use, part 7 #3238

• [SDK] Fix lifetime of GlobalLogHandler #3221

• [MAINTAINER] Add devcontainer #3123

• [SDK] enable deriving from ResourceDetector to create a Resource #3247

• [EXPORTER] Support handling retry-able errors for OTLP/HTTP #3223

• [CI] Add GRPC in maintainer CI #3248

• [EXPORTER] Support handling retry-able errors for OTLP/gRPC #3219

• [SDK] Optimize Metric Processing for Single Collector with Delta Temporality #3236

New features:

• [SDK] Better control of threads executed by opentelemetry-cpp #3175

  • This feature provides a way for applications, when configuring the SDK and exporters, to participate in the execution path of internal opentelemetry-cpp threads.

  • The opentelemetry-cpp library provides the following:

  • a new ThreadInstrumentation interface,

  • new runtime options structures, to optionally configure the SDK:

    • BatchSpanProcessorRuntimeOptions
    • PeriodicExportingMetricReaderRuntimeOptions
    • BatchLogRecordProcessorRuntimeOptions

  • new runtime options structures, to optionally configure the OTLP HTTP exporters:

    • OtlpHttpExporterRuntimeOptions
    • OtlpHttpMetricExporterRuntimeOptions
    • OtlpHttpLogRecordExporterRuntimeOptions

  • new ThreadInstrumentation parameters, to optionally configure the CURL HttpClient

  • new runtime options structures, to optionally configure the OTLP FILE exporters:

    • OtlpFileExporterRuntimeOptions
    • OtlpFileMetricExporterRuntimeOptions
    • OtlpFileLogRecordExporterRuntimeOptions

  • new runtime options structure, to optionally configure the OTLP FILE client:

    • OtlpFileClientRuntimeOptions

  • Using the optional runtime options structures, an application can subclass the ThreadInstrumentation interface, and be notified of specific events of interest during the execution of an internal opentelemetry-cpp thread.

  • This allows an application to call, for example:

  • pthread_setaffinity_np(), for better performances,

  • setns(), to control the network namespace used by HTTP CURL connections

  • pthread_setname_np(), for better observability from the operating system

  • many more specific apis, as needed

  • See the documentation for ThreadInstrumentation for details.

  • A new example program, example_otlp_instrumented_http, shows how to use the feature, and add application logic in the thread execution code path.

  • Note that this feature is experimental, protected by a WITH_THREAD_INSTRUMENTATION_PREVIEW flag in CMake. Various runtime options structures, as well as the thread instrumentation interface, may change without notice before this feature is declared stable.

• [EXPORTER] Support handling retry-able errors for OTLP/HTTP #3223

  • This feature is experimental, protected by a WITH_OTLP_RETRY_PREVIEW flag in CMake.

• [EXPORTER] Support handling retry-able errors for OTLP/gRPC #3219

  • This feature is experimental, protected by a WITH_OTLP_RETRY_PREVIEW flag in CMake.

[1.18 2024-11-25]

• [EXPORTER] Fix crash in ElasticsearchLogRecordExporter #3082

• [BUILD] Avoid buggy warning with gcc <= 8 #3087

• [API] Jaeger Propagator should not be deprecated #3086

• Update bzlmod version #3093

• [BUILD] Remove std::make_unique #3098

• [BUILD] Fix compiling problems for gcc 4.8 #3100

• [TEST] Fix linking order and gmock linking #3106

• [EXPORTER] Add config options to prometheus exporter #3104

• [BUILD] Add a CMake option to disable shared libs #3095

• [EXPORTER] Remove out of date ETW exporter doc #3103

• [EXPORTER] Add logging for async gRPC errors #3108

• [BUILD] Remove aligned_storage from nostd #3112

• [EXPORTER] Elastic Search exporter follow ECS guidelines #3107

• [INSTALL] Resolve dependencies in opentelemetry-cpp-config.cmake #3094

• [API] Add synchronous gauge #3029

• [BUILD] allow building with -DWITH_OTLP_HTTP_COMPRESSION=OFF without zlib #3120

• [CI] Comment the arm64 CI #3125

• [API] Comply with W3C Trace Context #3115

• [EXPORTER] bump prometheus to v1.3.0 #3122

• [EXPORTER] Log SSL Connection Information #3113

• [BUILD] Improve how to handle yield() in ARM #3129

• [BUILD] Fix -Wmissing-template-arg-list-after-template-kw warning #3133

• [EXPORTER]: Elasticsearch exporter put log resource in root instead of under 'resources' #3131

• [TEST] Rename w3c_tracecontext_test to w3c_tracecontext_http_test_server #3132

• [BUILD] Patches for building on AIX #3127

• [SEMANTIC CONVENTIONS] Migration to weaver #3105

• [SEMANTIC CONVENTIONS] Upgrade to semantic conventions 1.28.0 #3139

• [EXPORTER] handling of invalid ports in UrlParser #3142

• [CI] speed up clang-tidy workflow #3148

• [EXPORTER] Allow to share gRPC clients between OTLP exporters #3041

• Bump codecov/codecov-action from 4 to 5 #3143

• [CI] Add cppcheck in the build #3151

• [BUILD] Fix error message #3152

• [EXPORTER] fix clang-tidy warnings in UrlParser #3146

• [EXPORTER] Upgrade to opentelemetry-proto 1.4.0 #3157

• [TEST] refactor UrlParser tests to use value-paramterized tests #3153

• [TEST] add a test for ElasticSearchRecordable #3154

• [BUILD] Fix missing dependency on protoc compiler #3159

• [bazel] Update prometheus-cpp in MODULE.bazel #3162

• [bazel] Enable --incompatible_disallow_empty_glob #2642

• [INSTALL] Fix cmake/opentelemetry-cpp-config.cmake.in #3165

• [BUILD] Do not set OTELCPP_PROTO_PATH in the CMake cache #3160

• [BUILD] Fix build for esp32 #3155

• [bazel] Update opentelemetry-proto in MODULE.bazel #3163

Important changes:

• [API] Jaeger Propagator should not be deprecated #3086

  • Deprecation of the Jaeger propagator, as announced on 2023-01-31 in version 1.8.2, is now reverted.
  • This deprecation turned out to be not justified, as the Jaeger propagator can be used without the (now removed) Jaeger exporter.

• [EXPORTER] Change log resources location for ElasticsearchLogRecordExporter #3119

  • Moved from root/resources to root

• [SEMANTIC CONVENTIONS] Migration to weaver #3105

  • semantic_convention.h header files are deprecated, replaced by semconv/xxx_attributes.h header files, for each xxx semantic attribute group.
  • See file DEPRECATED.md for details.

Deprecations:

• This release contains deprecations, see file DEPRECATED.md for details.

[1.17 2024-10-07]

• [CI] Add a clang-tidy build #3001

• [BUILD] Upgrade to opentelemetry-proto 1.3.2 #2991

• [REMOVAL] Remove build option WITH_DEPRECATED_SDK_FACTORY #2717

• [EXPORTER] ForceFlush before canceling the running requests on shutdown #2727

• [SDK] Fix crash in PeriodicExportingMetricReader #2983

• [SDK] Fix memory leak in TlsRandomNumberGenerator() constructor #2661

• [EXPORTER] Ignore exception when create thread in OTLP file exporter #3012

• [BUILD] Update the version in MODULE.bazel #3015

• [BUILD] Fix build without vcpkg on Windows when gRPC is disabled #3016

• [BUILD] Add abi_version_no bazel flag #3020

• [Code health] Expand iwyu coverage to include unit tests #3022

• [BUILD] Version opentelemetry_proto/proto_grpc shared libraries #2992

• [SEMANTIC CONVENTIONS] Upgrade semantic conventions to 1.27.0 #3023

• [SDK] Support empty histogram buckets #3027

• [TEST] Fix sync problems in OTLP File exporter tests #3031

• [SDK] PeriodicExportingMetricReader: future is never set, blocks until timeout #3030

• [Code Health] Clang Tidy cleanup, Part 2 #3038

• [Code Health] include-what-you-use cleanup, part 3 #3004

• [SDK] Fix overflow in timeout logic #3046

• [TEST] Add missing tests to Bazel build #3045

• [TEST] update collector tests with debug exporter #3050

• [EXAMPLE] update collector example with debug exporter #3049

• [TEST] update references to logging exporter #3053

• [EXAMPLE] Clean the tracer initialization in OStream example #3051

• [EXPORTER] Fix the format of SpanLink for ETW #3054

• [EXPORTER] Add in-memory metric exporter #3043

• [Code Health] include-what-you-use cleanup, part 4 #3040

• [BUILD] add loongarch info #3052

• [CI] Update otel-collector version #3067

• [SDK] Update MetricProducer interface to match spec #3044

• [EXPORTER] Fix URL in ES exporter, fix ipv6 supporting for http client #3081

• [EXPORTER] Add HttpHeaders in ElasticsearchLogRecordExporter #3083

Breaking changes:

• [REMOVAL] Remove build option WITH_DEPRECATED_SDK_FACTORY #2717

  • As announced in opentelemetry-cpp previous release 1.16.0, CMake option WITH_DEPRECATED_SDK_FACTORY was temporary, and to be removed by the next release.
  • This option is now removed.

  • Code configuring the SDK must be adjusted, as previously described:

  • [API/SDK] Provider cleanup #2664

  • Before this fix:

    • SDK factory methods such as:
    • opentelemetry::sdk::trace::TracerProviderFactory::Create()
    • opentelemetry::sdk::metrics::MeterProviderFactory::Create()
    • opentelemetry::sdk::logs::LoggerProviderFactory::Create()
    • opentelemetry::sdk::logs::EventLoggerProviderFactory::Create()

    returned an API object (opentelemetry::trace::TracerProvider) to the caller.

  • After this fix, these methods return an SDK level object (opentelemetry::sdk::trace::TracerProvider) to the caller.

  • Returning an SDK object is necessary for the application to cleanup and invoke SDK level methods, such as ForceFlush(), on a provider.

  • The application code that configures the SDK, by calling the various provider factories, may need adjustment.

  • All the examples have been updated, and in particular no longer perform static_cast do convert an API object to an SDK object. Please refer to examples for guidance on how to adjust.

[1.16.1 2024-07-17]

• [BUILD] Add bazel missing BUILD file #2720

• [SDK] Added reserve for spans array in BatchSpanProcessor. #2724

• [DOC] Update "Using triplets" section in building-with-vcpkg documentation. #2726

• [DOC] Remove comment for unused LoggerProvider initialization params #2972

• [SECURITY] Remove OTLP HTTP support for TLS 1.0 and TLS 1.1, require TLS 1.2 or better #2722

• [TEST] Fix opentelemetry-collector bind address #2989

• [EXPORTER] Fix references in AttributeValueVisitor #2985

• [Code health] include-what-you-use cleanup, part 2 #2704

• [Code Health] clang-tidy cleanup, part 1 #2990

• [CI] Build failures with ABSEIL 20240116 and CMAKE 3.30 #3002

• [CI] Enable bzlmod #2995

• [Metrics SDK] Fix hash calculation for nostd::string #2999

Breaking changes:

• [SECURITY] Remove OTLP HTTP support for TLS 1.0 and TLS 1.1, require TLS 1.2 or better #2722
  • The OTLP HTTP exporter no longer accept options like:
  • min_TLS = 1.0
  • min_TLS = 1.1
  • max_TLS = 1.0
  • max_TLS = 1.1
  • When connecting to an OTLP HTTP endpoint, using https, the connection will require TLS 1.2 by default, unless min_TLS is set to 1.3
  • Plain http connections (insecure) are not affected.

[1.16.0] 2024-06-21

• [BUILD] Upgrade bazel abseil from 20220623.1 to 20230802.2 #2650
• [BUILD] Use nostd::enable_if_t instead of std::enable_if_t #2648
• [EXEMPLAR] Update ExemplarFilter and ExemplarReservoir for spec #2372
• [BUILD] Link CoreFoundation on apple systems #2655
• [SDK] Avoid missing conditional variable update and simplify atomic bool #2553
• [BUILD] Build break in OLTP_FILE tests #2659
• [EXPORTER] General cleanup for is_shutdown flags in exporters. #2663
• [CI] Upgrade Maintainers CI to ubuntu-24.04 #2670
• [BUILD] Upgrade to opentelemetry-proto 1.3.1 #2669
• [API] Return NoopLogRecord from NoopLogger #2668
• [BUILD] Remove the hard-coded separator in tracestate #2672
• [SDK] Fix forceflush may wait for ever #2584
• [API] DO not allow unsafe Logger::EmitLogRecord #2673
• [BUILD] Read default proto version from third_party_release #2677
• [CI] include-what-you-use #2629
• [CI] Upgrade to clang-format 18 #2684
• [CI] Fix CI failures on Ubuntu 24.04 #2686
• [SEMANTIC CONVENTIONS] Upgrade to version 1.26.0 #2687
• [API/SDK] Provider cleanup #2664
• [ETW] Add table name mapping for Logs other than the default Log table #2691
• [CI] Remove benchmark overlay for vcpkg #2695
• [BUILD] Remove the incorrect set of CMAKE_MSVC_RUNTIME_LIBRARY for vcpkg #2696
• [BUILD] CMakeLists.txt: Enable CMAKE_MSVC_RUNTIME_LIBRARY support #2652
• [EXPORTER] OTLP file: use thread-safe file/io #2675
• [bazel] Bump version and deps #2679
• [BUILD] Add support for bzlmod #2608
• [BUILD] Fix Import Abseil-cpp #2701
• [Code health] include-what-you-use cleanup #2692
• [BUILD] Restore Bazel flag removed from public API #2702
• [DOC] Fix typo tace_id -> trace_id in logger.h #2703
• Bump docker/build-push-action from 5 to 6 #2705
• [CI] Enable ARM64 build in CI #2699
• [Code health] Remove Unicode Text from Source files #2707
• [BUILD] Add option WITH_OTLP_GRPC_SSL_MTLS_PREVIEW #2714
• [EXPORTER] All 2xx return codes should be considered successful. #2712

Important changes:

• [API/SDK] Provider cleanup #2664
  • Before this fix:
  • The API class opentelemetry::trace::Tracer exposed methods such as ForceFlush(), ForceFlushWithMicroseconds(), Close() and CloseWithMicroseconds().
  • These methods are meant to be used when configuring the SDK, and should not be part of the API. Exposing them was an oversight.
  • Two of these methods are virtual, and therefore part of the ABI.
  • After this fix:
  • In OPENTELEMETRY_ABI_VERSION_NO 1, nothing is changed, because removing this code would break the ABI.
  • In OPENTELEMETRY_ABI_VERSION_NO 2, these methods are moved from the API to the SDK. This is a breaking change for ABI version 2, which is still experimental.
  • In all cases, instrumenting an application should not invoke flush or close on a tracer, do not use these methods.

Breaking changes:

• [API/SDK] Provider cleanup #2664
  • Before this fix:
  • SDK factory methods such as:
    • opentelemetry::sdk::trace::TracerProviderFactory::Create()
    • opentelemetry::sdk::metrics::MeterProviderFactory::Create()
    • opentelemetry::sdk::logs::LoggerProviderFactory::Create()
    • opentelemetry::sdk::logs::EventLoggerProviderFactory::Create() returned an API object (opentelemetry::trace::TracerProvider) to the caller.
  • After this fix, these methods return an SDK level object (opentelemetry::sdk::trace::TracerProvider) to the caller.
  • Returning an SDK object is necessary for the application to cleanup and invoke SDK level methods, such as ForceFlush(), on a provider.
  • The application code that configures the SDK, by calling the various provider factories, may need adjustment.
  • All the examples have been updated, and in particular no longer perform static_cast do convert an API object to an SDK object. Please refer to examples for guidance on how to adjust.
  • If adjusting application code is impractical, an alternate and temporary solution is to build with option WITH_DEPRECATED_SDK_FACTORY=ON in CMake.
  • Option WITH_DEPRECATED_SDK_FACTORY=ON will allow to build code without application changes, posponing changes for later.
  • WITH_DEPRECATED_SDK_FACTORY=ON is temporary, only to provide an easier migration path. Expect this flag to be removed, as early as by the next release.

Notes on experimental features:

• #2372 introduced MeterProvider::SetExemplar() which accepts en ExemplarFilterType enumeration with kAlwaysOff, kAlwaysOn and kTraceBased.

[1.15.0] 2024-04-21

• [EXPORTER] Change OTLP HTTP content_type default to binary #2564
• [DOC] Fix OTLP documentation: Default endpoint is wrong for OTLP/HTTP #2560
• [BUILD] Fix old style cast warning #2567
• [EXPORTER] Gzip compression support for OTLP/HTTP and OTLP/gRPC exporter #2530
• [BUILD] update vcpkg submodule to 2024.02.14 #2575
• [SDK] Support for OTEL_SERVICE_NAME #2577
• [EXPORTER] Support URL-encoded values for OTEL_EXPORTER_OTLP_HEADERS #2579
• [BUILD] CMake cleanup for message() #2582
• [BUILD] Bump CMake minimum required version to 3.9 #2581
• [BUILD] Provide LIKELY / UNLIKELY macros #2580
• [EXPORTER] OTLP: Fix missing ResourceMetrics SchemaURL #2587
• [ETW] cleanup include path #2594
• Upgrade to googletest 1.14.0 #2596
• Upgrade to nlohmann_json 3.11.3 #2595
• [BAZEL] Move -std=c++14 to .bazelrc #2600
• [BAZEL] Fix -std=c++14 warning on Windows #2601
• Upgrade to benchmark 1.8.3 #2597
• Upgrade to prometheus 1.2.4 #2598
• [DOC] Fix typo: Asynchronouse -> Asynchronous in meter.h #2604
• [BUILD] Do not link prometheus-cpp::util when it doesn't exist #2606
• [SDK] Remove unused variable #2609
• [METRICS SDK] Remove extra OfferMeasurement call in SyncMetricsStorage::OfferMeasurement #2610
• [MISC] Use set -e on all shell scripts and pass shellcheck --severity=error #2616
• [CI] Add shellcheck --severity=error as a CI step #2618
• [CI] Upgrade to abseil 20240116.1 (CMake only) #2599
• [CI] Benchmark, provide units with --benchmark_min_time #2621
• [EXPORTER] OTLP file exporter #2540
• [CI] Use platform CMake #2627
• [PROTO] Upgrade to opentelemetry-proto 1.2.0 #2631
• [SDK] DefaultLogHandler to print errors to std::cerr, add LogLevel::None #2622
• [SEMANTIC CONVENTIONS] Upgrade to semantic convention 1.25.0 #2633
• [DOC] Add readme and examples for OTLP FILE exporters. #2638
• [SEMANTIC CONVENTIONS] Rework on semantic conventions 1.25.0 #2640
• [DOC] Update INSTALL.md #2592

Important changes:

• [EXPORTER] Gzip compression support for OTLP/HTTP and OTLP/gRPC exporter #2530
  • In the OtlpHttpExporterOptions and OtlpGrpcExporterOptions, a new field called compression has been introduced. This field can be set to "gzip” to enable gzip compression.
  • The CMake option WITH_OTLP_HTTP_COMPRESSION is introduced to enable gzip compression support for the OTLP HTTP Exporter and includes a dependency on zlib.
• [SDK] Change OTLP HTTP content_type default to binary #2558
• [CI] Use platform CMake #2627
  • The CI in github no longer install a different version of cmake.
  • It now always use the cmake provided by the platform.
  • As part of this change, the script ci/setup_cmake.sh was renamed to ci/setup_googletest.sh, for clarity, now that this script only installs googletest.
• [SDK] DefaultLogHandler to print to std::cerr, add LogLevel::None #2622
  • Change DefaultLogHandler output
  • Before, the default internal logger, DefaultLogHandler, used to print to std::cout.
  • Now, DefaultLogHandler prints errors and warnings to std::cerr, as expected, while printing info and debug messages to std::cout.
  • Applications that expected to find the opentelemetry-cpp internal error log in std::cout may need adjustments, either by looking at std::cerr instead, or by using a custom log handler.
  • Additional LogLevel::None
  • LogLevel::None is a new supported log level, which does not print any message.
  • Custom log handlers may need to implement a new case, to avoid compiler warnings.
  • Numbering of log levels like OTEL_INTERNAL_LOG_LEVEL_ERROR has changed, which requires to rebuild, as the SDK ABI differs.

[1.14.2] 2024-02-27

• [SDK] Fix observable attributes drop #2557

[1.14.1] 2024-02-23

• [SDK] Restore Recordable API compatibility with versions < 1.14.0 #2547
• [DOC] Add missing CHANGELOG. #2549
• [EXPORTER] Error when grpc endpoint is empty #2507
• [DOC] Fix typo in benchmarks.rst #2542

Important changes:

• [SDK] Restore Recordable API compatibility with versions < 1.14.0 #2547
  • For third party extending the SDK, release 1.14.0 introduced an API breaking change compared to 1.13.0
  • This fix restores API (but not ABI) compatibility of release 1.14.1 with release 1.13.0.
  • This allows to build a third party exporter with no source code changes, for both releases 1.14.1 and 1.13.0.

[1.14.0] 2024-02-16

• [BUILD] Add DLL build CI pipeline with CXX20 #2465
• [EXPORTER] Set is_monotonic flag for Observable Counters #2478
• [PROTO] Upgrade to opentelemetry-proto v1.1.0 #2488
• [BUILD] Introduce CXX 20 CI pipeline for MSVC/Windows #2450
• [API] Propagation: fix for hex conversion to binary for odd hex strings #2533
• [DOC] Fix calendar link #2532
• [ETW EXPORTER] Remove namespace using in ETW exporter which affects global namespace #2531
• [BUILD] Don't invoke vcpkg from this repo with CMAKE_TOOLCHAIN_FILE set #2527
• [EXPORTER] Async exporting for otlp grpc #2407
• [METRICS SDK] Fix attribute filtering for synchronous instruments. #2472
• [BUILD] Better handling of OPENTELEMETRY_STL_VERSION under Bazel. #2503
• [DOC] Fixes CI markdown error MD055 - Table pipe style #2517
• [API] Propagators: do not overwrite the active span with a default invalid span #2511
• [BUILD] Updated the recorded vcpkg submodule version #2513
• [BUILD] Remove unnecessary usage/includes of nostd/type_traits #2509
• [SEMANTIC CONVENTIONS] Upgrade to version 1.24.0 #2461
• [EXAMPLES] Improve readme of Metrics example #2510
• [BUILD] Clang-15 warning about __has_trivial_destructor #2502
• [BUILD] Fix multiple assignment operators for SpinLockMutex #2501
• [BUILD] Alternative way of exporting symbols (generating .def file) #2476
• [CI] Make cmake.c++20.test actually use C++20 and add cmake.c++23.test #2496
• [DOCUMENTATION] Add api reference documentation for logs #2497
• [BUILD] Fix variable shadow #2498
• [BUILD] Fix checks on __cplusplus under MSVC, do not assume /Zc #2493
• [EXAMPLES] Use logs API instead of logs bridge API in the example #2494
• [EXPORTER] Fix forward protocol encoding for ETW exporter #2473
• [BUILD] Skip patch alias target #2457
• [EXPORTER] Rename populate_otel_scope to without_otel_scope #2479
• [EXPORTER SDK] Additional fixes after NOMINMAX removal on Windows #2475
• [EXPORTER] Do not use regex in CleanUpString because some implementations of STL may crash. #2464
• [EXPORTER] Fix Aggregation type detection in OTLP Exporter #2467
• [EXPORTER] Add option to disable Prometheus otel_scope_name and otel_scope_version attributes #2451
• [SEMANTIC CONVENTIONS] Code generation script fails on SELINUX #2455
• [BUILD] Fix removing of NOMINMAX on Windows #2449
• [BUILD] Accept path list in OPENTELEMETRY_EXTERNAL_COMPONENT_PATH #2439
• [BUILD] Remove gmock from GTEST_BOTH_LIBRARIES #2437
• [REMOVAL] Remove option WITH_OTLP_HTTP_SSL_PREVIEW #2435

Important changes:

Breaking changes:

• [REMOVAL] Remove option WITH_OTLP_HTTP_SSL_PREVIEW #2435

  • CMake options WITH_OTLP_HTTP_SSL_PREVIEW and WITH_OTLP_HTTP_SSL_TLS_PREVIEW are removed. Building opentelemetry-cpp without SSL support is no longer possible.

• [PROTO] Upgrade to opentelemetry-proto v1.1.0 #2488

  • Class opentelemetry::sdk::trace::Recordable has a new virtual method, SetTraceFlags().
  • This is an incompatible change for the SDK Recordable API and ABI.
  • Applications configuring the SDK are not affected.
  • Third parties providing SDK extensions are affected, and must provide a SetTraceFlags() implementation, starting with opentelemetry-cpp 1.14.0.

[1.13.0] 2023-12-06

• [BUILD] Remove WITH_REMOVE_METER_PREVIEW, use WITH_ABI_VERSION_2 instead #2370
• [SDK] Metrics ObservableRegistry Cleanup #2376
• [BUILD] Make WITH_OTLP_HTTP_SSL_PREVIEW mainstream #2378
• [SDK] Creating DoubleUpDownCounter with no matching view #2379
• [API] Add InstrumentationScope attributes in TracerProvider::GetTracer() #2371
• [BUILD] DLL export interface for Metrics #2344
• [BUILD] enum CanonicalCode names too generic... conflict with old C defines #2385
• [BUILD] Fix cpack broken package version #2386
• [API] Add a new AddLink() operation to Span #2380
• [opentracing-shim] Add check for sampled context #2390
• [BUILD] Fix exported definitions when building DLL with STL #2387
• [BUILD] Add missing includes to runtime_context_test #2395
• [ADMIN] Add file .github/repository-settings.md #2392
• [SDK] Fix GetLogger with empty library name #2398
• [TEST] Fix compiling problem and removed -DENABLE_TEST #2401
• [BUILD] Check windows options are not passed to non-Windows build #2399
• [EXPORTER] Rework OTLP/HTTP and OTLP/GRPC exporter options #2388
• [Build] Update vcpkg to latest release #2412
• [SDK] Cardinality limits for metrics streams (Sync Instruments + Delta Temporality) #2255
• [EXPORTER] Prometheus: Add unit to names, convert to word #2213
• [Metrics] Make context optional for histogram instruments in Metrics SDK #2416
• [BUILD] Fix references to trace namespace to be fully qualified #2422
• [BUILD] Bump third_party/googletest to same version as bazel #2421
• [BUILD] Remove defining NOMINMAX from api #2420
• [BUILD] 'uint8_t' not declared in this scope with gcc 13.2.1 #2423
• [BUILD] Improve the handling of OPENTELEMETRY_HAVE_WORKING_REGEX #2430
• [SEMANTIC CONVENTION] Upgrade to semconv 1.23.1 #2428
• [BUILD] Use fully qualified references to trace/common namespace #2424
• [API] Create root span with active span #2427
• [REMOVAL] Remove ZPAGES #2433

Important changes:

• [API] Add InstrumentationScope attributes in TracerProvider::GetTracer() #2371

  • TracerProvider::GetTracer() now accepts InstrumentationScope attributes.
  • Because this is an ABI breaking change, the fix is only available with the CMake option WITH_ABI_VERSION_2=ON.
  • When building with CMake option WITH_ABI_VERSION_1=ON (by default) the ABI is unchanged, and the fix is not available.

• [API] Add a new AddLink() operation to Span #2380

  • New API Span::AddLink() adds a single link to a span.
  • New API Span::AddLinks() adds multiple links to a span.
  • Because this is an ABI breaking change, the fix is only available with the CMake option WITH_ABI_VERSION_2=ON.
  • When building with CMake option WITH_ABI_VERSION_1=ON (by default) the ABI is unchanged, and the fix is not available.

• [BUILD] Make WITH_OTLP_HTTP_SSL_PREVIEW mainstream #2378

  • The experimental CMake option WITH_OTLP_HTTP_SSL_PREVIEW is now promoted to stable. The default is changed to ON.
  • The experimental CMake option WITH_OTLP_HTTP_SSL_TLS_PREVIEW is now promoted to stable. The default is changed to ON.
  • These build options are scheduled to be removed by the next release, building without SSL/TLS will no longer be possible.

• [EXPORTER] Rework OTLP/HTTP and OTLP/GRPC exporter options #2388

  • OtlpGrpcMetricExporterOptions used to honor _TRACES_ environment variables, instead of _METRICS_ environment variables.
  • The implementation of OtlpGrpcMetricExporterOptions is now fixed.
  • Please check configuration variables, to make sure _METRICS_ variables are set as expected.

Breaking changes:

• [BUILD] Remove WITH_REMOVE_METER_PREVIEW, use WITH_ABI_VERSION_2 instead #2370

  • The experimental CMake option WITH_REMOVE_METER_PREVIEW is removed, use option WITH_ABI_VERSION_2 instead.

• [BUILD] enum CanonicalCode names too generic... conflict with old C defines #2385

  • Header file opentelemetry/trace/canonical_code.h is unused, and is now removed.
  • This header should not be included directly in an application. If this is the case, please remove any remaining include directives.

• [BUILD] Fix exported definitions when building DLL with STL #2387

  • The MeterSelector, MeterSelectorFactory, InstrumentSelector, and InstrumentSelectorFactory APIs now use const std::string& instead of nostd::string_view for name, version and schema to maintain a single export definition for DLL.

• [EXPORTER] Rework OTLP/HTTP and OTLP/GRPC exporter options #2388

  • OtlpGrpcLogRecordExporter incorrectly used OtlpGrpcExporterOptions, which are options for traces and not logs.
  • This created a bug: the OtlpGrpcLogRecordExporter honors _TRACES_ environment variables, instead of _LOGS_ environment variables.
  • OtlpGrpcLogRecordExporter is changed to use OtlpGrpcLogRecordExporterOptions instead, fixing the bug.
  • User code that initializes the SDK with a GRPC Log exporter, and uses exporter options, should adjust to replace OtlpGrpcExporterOptions with OtlpGrpcLogRecordExporterOptions.
  • Please check configuration variables, to make sure _LOGS_ variables are set as expected.

• [REMOVAL] Remove ZPAGES #2433

  • As announced in release 1.12.0, the deprecated ZPAGES exporter is now removed.

[1.12.0] 2023-10-16

• [BUILD] Support pkg-config #2269
• [CI] Do not automatically close stale issues #2277
• [CI] Benchmark workflow fails, C++14 required to build grpc #2278
• [SDK] Increase metric name maximum length from 63 to 255 characters #2284
• [SEMANTIC CONVENTION] Deprecated semconv (in the spec) not deprecated (in C++) #2285
• [SDK] Remove unused member variables from SyncMetricStorage #2294
• [DEPRECATION] Deprecate ZPAGES #2291
• [API] Deliver ABI breaking changes #2222
• [SDK] Allow metric instrument names to contain / characters #2310
• [SDK] Fix Observable Counters/UpDownCounters #2298
• [SDK] Add exemplar reservoir to async metric storage #2319
• [TEST] Fix lifetime issues in prometheus test utils #2322
• [EXPORTER] Prometheus: Remove explicit timestamps from metric points #2324
• [EXPORTER] Prometheus: Handle attribute key collisions from sanitation #2326
• [EXPORTER] Prometheus cleanup, test with TranslateToPrometheus #2329
• [SDK] Fix log message in Meter::RegisterSyncMetricStorage #2325
• [DOC] Simplify the project status section #2332
• [EXPORTER] Prometheus: Sanitize labels according to spec #2330
• [SDK] Fix deadlock when shuting down http client #2337
• [Exporter] Group spans by resource and instrumentation scope in OTLP export requests #2335
• [BUILD] Need fine-grained HAVE_CPP_STDLIB #2304
• [API] Add InstrumentationScope attributes in MeterProvider::GetMeter() #2224
• [REMOVAL] Drop C++11 support #2342
• [EXPORTER] prometheus: add otel_scope_name and otel_scope_version labels #2293
• [EXPORTER] Export resource for prometheus #2301
• [BUILD] error: read-only reference ‘value’ used as ‘asm’ output #2354
• [BUILD] Build break with external CMake nlohman_json package #2353
• [BUILD] Upgrade libcurl to version 8.4.0 #2358
• [BUILD] Fix opentracing-shim when added in super project #2356
• [BUILD] Fix protoc searching with non-imported protobuf::protoc target #2362
• [BUILD] Support to use different cmake package CONFIG of dependencies #2263
• [SEMANTIC CONVENTION] Upgrade to semconv 1.22.0 #2368

Important changes:

• [API] Add InstrumentationScope attributes in MeterProvider::GetMeter() #2224
  • MeterProvider::GetMeter() now accepts InstrumentationScope attributes.
  • Because this is an ABI breaking change, the fix is only available with the CMake option WITH_ABI_VERSION_2=ON.
  • When building with CMake option WITH_ABI_VERSION_1=ON (by default) the ABI is unchanged, and the fix is not available.

Breaking changes:

• [BUILD] Need fine-grained HAVE_CPP_STDLIB #2304

  • In CMAKE, the boolean option WITH_STL as changed to an option that accepts the values OFF, ON, CXX11, CXX14, CXX17, CXX20 and CXX23.
  • Applications makefiles that did not set WITH_STL need to use WITH_STL=OFF instead (this is the default).
  • Applications makefiles that did set WITH_STL need to use WITH_STL=ON instead, or may choose to pick a specific value.
  • In the API header files, the preprocessor symbol HAVE_CPP_STDLIB is no longer used.
  • Applications that did set HAVE_CPP_STDLIB before, need to set OPENTELEMETRY_STL_VERSION=<version> instead, to build with a specific STL version (2011, 2014, 2017, 2020, 2023).
  • The opentelemetry-cpp makefile no longer sets CMAKE_CXX_STANDARD by itself. Instead, the CMAKE_CXX_STANDARD and/or compiler options -stdc++ used by the caller are honored.
  • Applications that set neither CMAKE_CXX_STANDARD nor -stdc++ options may need to provide a C++ standard in their makefiles.

• [REMOVAL] Drop C++11 support #2342

  • Building with C++11 is no longer supported.

Deprecations:

• [DEPRECATION] Deprecate ZPAGES #2291

[1.11.0] 2023-08-21

• [BUILD] Fix more cases for symbol name for 32-bit win32 DLL build #2264
• [BUILD] added public link of opentelemetry_proto_grpc against gRPC lib (only if gRPC library is shared) #2268
• [CI] use ubuntu-latest for tsan CI #2267
• [SDK] Fixing an apparent logging macro bug #2265
• [BUILD] Support protobuf 3.22 or upper #2163
• [BUILD] Remove extra includes #2252
• [LOGS API SDK] Mark logs signal as stable API/SDK #2229
• [SEMANTIC CONVENTIONS] Upgrade to 1.21.0 #2248
• [SDK] Valgrind errors on std::atomic variables #2244
• [BUILD] Fix compile with clang 16 and libc++ #2242
• [Metrics SDK] Add unit to Instrument selection criteria #2236
• [SDK] Add OStreamLogRecordExporterFactory #2240
• [SDK] Add support for LowMemory metrics temporality #2234
• [CI] Misc build scripts cleanup #2232
• [CI] Upgrade GoogleTest version from 1.12.1 to 1.13.0 #2114
• [BUILD] include cstdint #2230
• [EXPORTER] Support protobuf 3.22 or upper #2163
• [SDK] Mark logs signal as stable API/SDK #2229

Breaking changes:

• [SDK] Add unit to Instrument selection criteria #2236
  • The View constructor and ViewFactory::Create method now takes a unit criteria as optional third argument.
  • Please adjust SDK configuration code accordingly.

[1.10.0] 2023-07-11

• [REMOVAL] Remove the jaeger exporter #2031

• [CI] Add a C++11 build #2152

• [CI] Add Include what you use #2214

• [CI] opentelemetry-cpp project CI #2071

• [CI] Do not tag pull_request with the "need-triage" label #2228

• [BUILD] Fixing CMake to build GTest on Windows #1887

• [BUILD] Remove option WITH_OTLP #2161

• [BUILD] Link to opentelemetry_logs even without OTLP #2177

• [BUILD] Avoid dependency on protobuf from the OTLP HTTP metrics exporter header #2179

• [BUILD] Add ctime header to metrics_exporter.cc #2187

• [BUILD] Fix the exported symbol name for 32-bit win32 DLL #2190

• [BUILD] Upgrade to opentelemetry-proto 0.20.0 #2195

• [BUILD] SDK Header files cleanup, use forward declarations #2182

• [BUILD] Enable building otel-cpp extensions from main repo #1937

• [BUILD] Fix if check on environment variable and add CMake variable #2207

• [BUILD] Add OPENTELEMETRY_CPP_FOUND into cmake CONFIG file #2215

• [BUILD] Upgrade opentelemetry-proto to 1.0.0 #2216

• [BUILD] Include nostd/string_view which is used in severity.h #2219

• [TEST] Expand api singleton test to cover explicit dlopen() #2164

• [API] Remove include_trace_context #2194

• [API] Remove Meters #2205

• [SDK] Add AdaptingCircularBufferCounter for exponential histograms #2158

• [SDK] Add base2 exponential histogram indexer #2173

• [SDK] Simplify SDK version #2180

• [SDK] Add benchmark for base2 exponential histogram indexer #2181

• [SDK] Provide builders to avoid exposing Metrics SDK internals #2189

• [SDK] MeterProvider should own MeterContext, not share it #2218

• [SDK] TracerProvider should own TracerContext, not share it #2221

• [EXPORTER] Change OTLP Json field name to camelCase #2162

• [EXPORTER] Support empty arrays in OtlpRecordable attributes #2166

• [EXPORTER] set is_monotonic only for instrument type kCounter #2171

• [EXPORTER] Fixed HTTP CURL for 32bits platforms #2178

• [EXPORTER] Fix OTLP HTTP exporting in sync mode #2193

• [EXPORTER] Prometheus exporter sanitizes invalid characters #1934

• [EXPORTER] Prometheus: Error on ingesting samples with different value but same timestamp #2200

• [EXPORTER] OTLP GRPC mTLS support #2120

• [DOC] Small fix for Histogram documentation #2156

• [DOC] Move Reiley Yang to emeritus #2198

Important changes:

• [API] Remove Meters #2205
  • The CMake option WITH_REMOVE_METER_PREVIEW was added.
  • This option is experimental, and may change in the future.
  • Enabling it is an ABI breaking change.

Breaking changes:

• [REMOVAL] Remove the jaeger exporter #2031

  • The CMake WITH_JAEGER option has been removed
  • Please remove usage of WITH_JAEGER from user scripts and makefiles.

• [SDK] MeterProvider should own MeterContext, not share it #2218

  • The MeterProvider constructor now takes a unique_ptr on MeterContext, instead of a shared_ptr.
  • Please adjust SDK configuration code accordingly.

• [SDK] TracerProvider should own TracerContext, not share it #2221

  • The TracerProvider constructor now takes a unique_ptr on TracerContext, instead of a shared_ptr.
  • The LoggerProvider constructor now takes a unique_ptr on LoggerContext, instead of a shared_ptr.
  • Please adjust SDK configuration code accordingly.

[1.9.1] 2023-05-26

• [DEPRECATION] Drop C++11 support #2146

• [CI] Upgrade Bazel and Bazelisk version #2118

• [CI] Upgrade Google Benchmark version from 1.6.0 to 1.7.1 #2116

• [CI] Upgrade Nlohmann JSON library version from 3.10.5 to 3.11.2 #2115

• [BUILD] Missed include #2143

• [BUILD] Add opentelemetry_proto_grpc and allow build shared opentelemetry_proto and opentelemetry_proto_grpc on non-Windows platform. #2097

• [BUILD] Warning cleanup, single character wrapped by std::string #2137

• [BUILD] Add missing target dependencies #2128

• [BUILD] Fix if JSON library already added another CMake target #2126

• [BUILD] shared libraries with version suffix, along with the symbolic link #2109

• [BUILD] Show warning message if WITH_OTLP is enabled #2112

• [BUILD] Add missing STL header. #2107

• [BUILD] Build break with old curl, macro CURL_VERSION_BITS unknown #2102

• [BUILD] Transitive dependency issue with the otlp http exporter #2154

• [TEST] Add unit test for log body implicit conversions. #2136

• [TEST] Add event id to logger benchmark method #2133

• [API] Fix inclusion header files and use forward declaration #2124

• [API] Add user facing Logging API and Benchmarks #2094

• [SDK] SDK support for the new OTel log #2123

• [EXPORTER] Fixed HTTP session cleanup on shutdown #2111

• [EXPORTER] Delegate all API calls of gRPC into opentelemetry_exporter_otlp_grpc_client, and make it contains all symbols needed. #2005

• [DOC] Add Marc as maintainer. #2027

Breaking changes:

• Add opentelemetry_proto_grpc and move gRPC sources into it. #2097
  • There will be no breaking changes for users who only use OTLP exporters and do not directly use opentelemetry-cpp::proto. However, it is important to note that opentelemetry-cpp::proto no longer contains generated gRPC codes , and all components that depend on these gRPC codes should also link to opentelemetry-cpp::proto_grpc.

Deprecations:

• The Jaeger Exporter is deprecated, see DEPRECATED for details.
• C++11 support is to end, C++14 will be supported instead, see DEPRECATED for details.

[1.9.0] 2023-04-12

• [CI] Make build environment parallel (Windows) #2080
• [CI] Make build environment parallel (Linux) #2076

• [CI] Remove separate run of metrics ostream example #2030

• [BUILD] Include directory path added for Zipkin exporter example #2069

• [BUILD] Ignore more warning in generated protobuf files #2067

• [BUILD] Clean warnings in ETW exporters #2063

• [BUILD] Fix default value of OPENTELEMETRY_INSTALL_default #2062

• [SEMANTIC CONVENTIONS] Upgrade to version 1.20.0 #2088

• [SEMANTIC CONVENTIONS] Upgrade to version 1.19.0 #2017

• [API] Checking indices before dereference in string utils #2040

• [API] Export factory class of log provider #2041

• [SDK] Implement Forceflush for Periodic Metric Reader #2064

• [SDK] Add ForceFlush for all LogRecordExporter and SpanExporter #2000

• [SDK] Fix schema URL precedence bug in Resource::Merge #2036

• [SDK] Use sdk_start_ts for MetricData start_ts for instruments having cumulative aggregation temporality. #2086

• [EXPORTER] Add OTLP HTTP SSL support #1793

• [EXPORTER] GRPC endpoint scheme should take precedence over OTEL_EXPORTER_OTLP_TRACES_INSECURE #2060

• [EXAMPLES] Remove unused 'alerting' section from prometheus.yml in examples #2055

• [EXAMPLES] Fix view names in Prometheus example #2034

• [DOC] Fix some docs typo #2057

• [DOC] Update OpenTracing shim README.md #2028

• [DOC] INSTALL doc clarifications #2078

Important changes:

• [EXPORTER] GRPC endpoint scheme should take precedence over OTEL_EXPORTER_OTLP_TRACES_INSECURE #2060
  • The logic to decide whether or not an OTLP GRPC exporter uses SSL has changed to comply with the specification:
  • Before this change, the following settings were evaluated, in order:
    • OTEL_EXPORTER_OTLP_TRACES_INSECURE (starting with 1.8.3)
    • OTEL_EXPORTER_OTLP_INSECURE (starting with 1.8.3)
    • OTEL_EXPORTER_OTLP_TRACES_SSL_ENABLE
    • OTEL_EXPORTER_OTLP_SSL_ENABLE
  • With this change, the following settings are evaluated, in order:
    • The GRPC endpoint scheme, if provided:
    • "https" imply with SSL,
    • "http" imply without ssl.
    • OTEL_EXPORTER_OTLP_TRACES_INSECURE
    • OTEL_EXPORTER_OTLP_INSECURE
    • OTEL_EXPORTER_OTLP_TRACES_SSL_ENABLE
    • OTEL_EXPORTER_OTLP_SSL_ENABLE
  • As a result, a behavior change for GRPC SSL is possible, because the endpoint scheme now takes precedence. Please verify configuration settings for the GRPC endpoint.
• [SDK] Add ForceFlush for all LogRecordExporter and SpanExporter #2000
  • LogRecordExporter and SpanExporter add a new virtual function ForceFlush, and if users implement any customized LogRecordExporter and SpanExporter, they should also implement this function. There should be no impact if users only use factory to create exporters.

Deprecations:

• The Jaeger Exporter is deprecated, see DEPRECATED for details.

[1.8.3] 2023-03-06

• Provide version major/minor/patch macros #2014
• [BUILD] Add OPENTELEMETRY_INSTALL to allow user to skip install targets. #2022
• [SDK] Rename the global SDK version variables to avoid naming clash #2011
• [BUILD] Fix typo in CMakeLists.txt #2010
• [EXPORTER] fix Prometheus test iterator iterator increment #2006
• [SDK]Add attributes for InstrumentationScope #2004
• [METRICS SDK] Performance improvement in measurement processing #1993
• [EXAMPLE] Add example for logs ostream exporter #1992
• [ETW Exporter] Support serialize span/log attributes into JSON #1991
• [ETW Exporter]Do not overwrite ParentId when setting attribute on Span #1989
• Upgrade prometheus-cpp to v1.1.0 #1954
• Convert Prometheus Exporter to Pull MetricReader #1953
• [DOCS] Add alpine packages to INSTALL.md #1957
• [METRICS SDK] Add benchmark tests for Sum Aggregation. #1948
• [BUILD] Build OpenTelemetry SDK and exporters into DLL #1932
• [CI] Enforce copyright check in CI #1965
• [BUILD] Fix typo GENENV -> GETENV #1972
• [SEMANTIC CONVENTIONS] Upgrade to version 1.18.0 #1974
• [EXT] Fix thread-safety when shutdown. #1977
• [SDK] Fix missing ObservedTimestamp. #1985
• [METRICS SDK] fix variable names #1987
• [EXPORTER] Fix Prometheus server crash on listening to already used port #1986
• [EXPORTER] Boolean environment variables not parsed per the spec #1982
• [EXPORTER] Opentracing shim #1909

[1.8.2] 2023-01-31

• Remove redundant macro check in nostd::shared_ptr #1939
• Fix typo in packages.cmake causing incorrect nuget package versions #1936
• [METRICS] Custom Aggregation support #1899
• Small fix in INSTALL.md for enabling building package. #1930
• [METRICS] Fix warning for misconfiguration of PeriodicExportingMetricReader #1929
• Make macros.h available for all source files via version.h #1918
• [METRICS] Histogram Aggregation: Fix bucket detection logic, performance improvements, and benchmark tests #1869
• Remove unused namespace alias for nostd #1914
• [METRICS] Update meter.h #1907
• sdk::resource::Resource::Merge should be const #1905
• [METRICS] Collect and Export metric data before PeriodicMetricReader shutdown. #1860
• [ETW EXPORTER] Add Virtual destructor for TailSampler, Update Maintainer mode warnings for MSVC #1897
• Fix #1867 Orderly shutdown in examples #1868
• [METRICS] minor metrics handling optimizations #1890
• fix SpinLockMutex for Intel Compiler #1885
• [LOGS] Change BatchLogRecordProcessorFactory::Create to static method #1876
• Enable generating deb, rpm, NuGet, tgz, zip package through cmake build #1662
• Updated clone command in INSTALL.md #1818
• Small cleanup to remove old metrics design docs #1855
• [BUILD] Fix build error with older version of VS2017 compiler. 1857
• [EXPORTERS] Enable setting Span endtime for ETW exporter #1846
• [REMOVAL] Remove deprecated experimental semantic conventions #1743
• [EXPORTERS] Fix console debug logs for otlp exporters. #1848
• [LOGS] Add include_trace_context and EventLogger #1884
• [METRICS] Change BatchLogRecordProcessorFactory::Create to static method
• [BUILD] Fix OTELCPP_MAINTAINER_MODE #1844
• [BUILD] Fix compatibility when using clang and libc++, upgrade GTest and cmake when using C++20 #1852
• [SEMANTIC CONVENTIONS] Upgrade to version 1.16.0 #1854
• [SDK] BatchSpanProcessor now logs a warning when dropping a span because the queue is full 1871
• [BUILD] Migrate from @bazel_tools//platforms to Bazel Platforms to enable Bazel 6.0.0 compatibility #1873
• [BUILD] Cleanup CMake makefiles for nlohmann_json #1912
• [BUILD] Cleanup CMake makefiles for CURL usage #1916
• [SEMANTIC CONVENTIONS] Upgrade to version 1.17.0 #1927
• [MAINTAINER DOC] Define and document a deprecation process, [DEPRECATION] Deprecate the Jaeger exporter, implemented by #1923
• [BUILD] OTLP HTTP Exporter has build warnings in maintainer mode #1943

Deprecations:

• [MAINTAINER DOC] Define and document a deprecation process, #1923
  • A new file, DEPRECATED list all the code currently deprecated.
  • A new deprecation process details the plan to deprecate and later remove code.
• [DEPRECATION] Deprecate the Jaeger exporter #1923
  • The Jaeger Exporter is deprecated, see DEPRECATED for details.

Important changes:

• [BUILD] Cleanup CMake makefiles for CURL usage #1916
  • CMake option WITH_OTLP_HTTP
  • Before this change, the CMake option WITH_OTLP_HTTP was unpredictable, sometime set to ON and sometime set to OFF by default, depending on whether a CURL package was found or not. The option WITH_OTLP_HTTP was sometime not displayed in the ccmake UI, making it impossible to even discover there is an option of that name.
  • With this change, CMake option WITH_OTLP_HTTP is always OFF by default. WITH_OTLP_HTTP MUST be set to ON explicitly to build the OTLP HTTP exporter. The option is always visible in the ccmake UI.
  • CMake option BUILD_W3CTRACECONTEXT_TEST
  • Before this change, the W3C trace context tests were built, or not, in an unpredictable way, depending on the presence, or not, of a CURL package. In particular, the build could ignore the W3C trace context tests even when BUILD_W3CTRACECONTEXT_TEST=ON.
  • With this change, option BUILD_W3CTRACECONTEXT_TEST is honored.
  • HTTP client/server examples
  • Before this change, the HTTP client/server examples were built, or not, in an unpredictable way, depending on the presence, or not, of a CURL package.
  • With this change, a new option WITH_EXAMPLES_HTTP is used to build the HTTP client/server examples.

[1.8.1] 2022-12-04

• [ETW Exporter] Tail based sampling support #1780
• [EXPORTERS] fix typo [affecting otlp exported histogram metrics max uint] #1827
• [EXPORTERS] fix enum-compare-switch warning #1833
• [METRICS] Change default temporality as "Cumulative" for OTLP metrics exporters #1828
• [BUILD] Moved otlp_grpc_utils.cc to opentelemetry_exporter_otlp_grpc_client. #1829
• Fix type mismatch when move nostd::shared_ptr #1815
• [BUILD] Fix Prometheus target name #1820
• Clean unused docker files #1817
• [BUILD] Fix default bazel build #1816
• [BUILD] move client::nosend under test_common #1811
• [BUILD] Fix opentelemetry-proto file exists check #1824

[1.8.0] 2022-11-27

• [DOC] Update Metrics status in README.md #1722
• [DOC] Remove misleading comments about ABI compatibility for nostd::span #1731
• [BUILD] Bump abseil-cpp for cmake CI #1807
• [Exporter] Add status code to OTLP grpc trace log #1792
• [Exporter] add fix for prometheus exporter build #1795
• [BUILD] Add option WITH_BENCHMARK to disable building benchmarks #1794
• [BUILD] Fix CI benchmark #1799
• [BUILD] bump to gRPC v1.48.1 for bazel CIs #1786
• [BUILD] Fix CI build #1798
• [BUILD] Fix clang-format in CI #1796
• Fix session lock of OtlpHttpClient #1760
• [Metrics SDK] Add MeterContext::ForEachMeter() method to process callbacks on Meter in thread-safe manner #1783
• [DOC] Document that clang-format version 10.0 is used. #1782
• [BUILD] Upgrade bazel build to use abseil-cpp-20220623.1 #1779
• Fix GlobalLogHandler singleton creation order #1767
• [Metrics SDK] Change Prometheus CMake target name #1765
• [DOC] Cleanup INSTALL.md #1757
• [DOC] Format config options in OTLP exporter readme #1748
• [DOC] Cleanup ENABLE_METRICS_PREVIEW #1745
• [Build] Multiple CURL packages leads to invalid build (#1738) #1739
• [Metrics SDK] Cleanup ENABLE_METRICS_PREVIEW #1735
• [Logs SDK] LogProcessor, LogExporter class name #1736
• [Metrics SDK] Cleanup of old _metric api/sdk #1734
• [ETW Exporter] Fix span timestamp(s) precision to nanoseconds #1726
• [LOGS SDK] Rename LogProcessor and LogExporter to LogRecordProcessor and LogRecordExporter #1727
• [METRICS SDK] - Remove old metrics from Github CI #1733
• [BUILD] Add CMake OTELCPP_PROTO_PATH #1730
• [SEMANTIC CONVENTIONS] Upgrade to version 1.15.0 #1761
• [LOGS SDK] New LogRecord and logs::Recordable implementations. #1766

Deprecation notes:

• [Deprecation] Deprecate experimental semantic conventions #1744

  • The file api/include/opentelemetry/trace/experimental_semantic_conventions.h is deprecated, and will be removed in a future release. Use file api/include/opentelemetry/trace/semantic_conventions.h instead.

  • The file sdk/include/opentelemetry/sdk/resource/experimental_semantic_conventions.h is deprecated, and will be removed in a future release. Use file sdk/include/opentelemetry/sdk/resource/semantic_conventions.h instead.

  • The function, declared in the global namespace uint32_t hashCode(const char *str, uint32_t h = 0) is deprecated, and will be removed in a future release. No replacement will be provided. Note that function opentelemetry::utils::hashCode, declared in the ETW exporter, is not affected by this deprecation.

Breaking changes:

• [SEMANTIC CONVENTIONS] Upgrade to version 1.15.0 #1761
  • Naming of semantic conventions has changed from uppercase constants, like SemanticConventions::SERVICE_NAME, to camel case, like SemanticConventions::kServiceName. This is necessary to avoid collisions with macros in general, which breaks the build on some platforms.
  • Semantic conventions are flagged as experimental, which is why this change is done in this release.

[1.7.0] 2022-10-28

• [METRICS SDK] Validate Instrument meta data (name, unit, description) #1713
• [DOCS] Document libthrift 0.12.0 doesn't work with Jaeger exporter #1714
• [Metrics SDK] Add Monotonic Property to Sum Aggregation, and unit tests for Up Down Counter #1675
• [Metrics SDK] Move Metrics Exemplar processing behind feature flag #1710
• [Metrics API/SDK] Change Meter API/SDK to return nostd::unique_ptr for Sync Instruments #1707 which includes breaking change in the Metrics api and sdk.
• [BUILD] Add e2e test to asan & tsan CI #1670
• [BUILD] Add otlp-grpc example bazel #1708
• [TRACE SDK] Fix debug log of OTLP HTTP exporter and ES log exporter #1703
• [METRICS SDK] Fix a potential precision loss on integer in ReservoirCellIndexFor #1696
• [METRICS SDK] Fix Histogram crash #1685
• [METRICS SDK] Fix:1676 Segfault when short export period is used for metrics #1682
• [METRICS SDK] Add timeout support to MeterContext::ForceFlush #1673
• [DOCS] - Minor updates to OStream Metrics exporter documentation #1679
• [DOCS] Fix:#1575 API Documentation for Metrics SDK and API #1678
• [BUILD] Fixed compiler warnings #1677
• [METRICS SDK] Fix threading issue between Meter::RegisterSyncMetricStorage and Meter::Collect #1666
• [METRICS SDK] Fix data race on MeterContext::meters_ #1668
• [METRICS SDK] Fix observable Gauge metrics generation #1651
• [BUILD] Detect ARCH=sparc in CMake #1660
• [SDK] Add user agent for OTLP http/grpc client #1657
• [BUILD] Fix clang and gcc warnings #1658
• [Metrics SDK] Add Metrics ExemplarFilter and ExemplarReservoir #1584
• [LOGS SDK] Rename OnReceive to OnEmit #1652
• [METRICS SDK] Fix Observable Gauge does not reflect updated values, and send the old value always #1641
• [Metrics SDK] Change boundary type to double for Explicit Bucket Histogram Aggregation, and change default bucket range #1626
• [METRICS SDK] Fix occasional Segfault with LongCounter instrument #1638
• [BUILD] Bump vcpk to 2022.08.15 #1633
• [BUILD] Bump gRPC to v1.48.1 for CMake Linux CI #1608
• [Metrics] Switch to explicit 64 bit integers #1686 which includes breaking change in the Metrics api and sdk.
• [Metrics SDK] Add support for Pull Metric Exporter #1701 which includes breaking change in the Metrics api.
• [BUILD] Add CMake OTELCPP_MAINTAINER_MODE #1650
• [SEMANTIC CONVENTIONS] Upgrade to version 1.14.0 #1697

Notes:

Metrics API/SDK GA release includes PRs #1686, #1701, and #1707 with breaking changes in the Metrics API and SDK.

[1.6.1] 2022-09-22

• [BUILD] Upgrade opentelemetry-proto to v0.19.0 #1579
• [METRICS EXPORTER] Add OtlpGrpcMetricExporterFactory and OtlpHttpMetricExporterFactory. #1606
• [SEMANTIC CONVENTIONS] Upgrade to version 1.13.0 #1624
• [BUILD] Fixes span creation benchmark issue. #1622
• [BUILD] Fix more build warnings (#1616) #1620
• [SDK gRPC]: Fix out-of-bounds access of string_view in GrpcClientCarrier in the example #1619
• [EXPORTER ETW] Add Trace flags in SpanContext #1618
• [SDK] resource sdk: Update Resource::Merge function docs #1615
• [BUILD] Fix build warnings #1613
• [API BUILD] Fix header only api singletons (#1520) #1604
• [METRICS SDK] Fix default value of OtlpHttpMetricExporterOptions::aggregation_temporality. #1601
• [METRICS EXAMPLE] Example for OTLP gRPC exporter for Metrics. #1598
• [SDK] Fix LoggerContext::Shutdown and tsan of OtlpHttpClient #1592
• [METRICS SDK] Fix 1585 - Multiple cumulative metric collections without measurement recording. #1586
• [BUILD] metrics warnings #1583
• [METRICS SDK] Fix ObservableInstrument::RemoveCallback #1582
• [SDK] Add error log when getting a http error code #1581
• [EXPORTER] ETW Exporter - Add support for Sampler and ID Generator #1547

Notes:

While OpenTelemetry semantic convention is still in experimental state, PR #1624 upgraded it from 1.12.0 to 1.13.0 which MAY break the instrumentation library. Please update the semantic convention in instrumentation library is needed.

[1.6.0] 2022-08-15

• [METRICS SDK] Calling Observable Instruments callback during metrics collection #1554
• [METRICS CI] Add CI jobs for new and deprecated metrics #1531
• [METRICS BUILD] Fix metrics asan and tsan CI #1562
• [METRICS SDK] remove throw check from metrics with noexcept #1560
• [METRICS SDK] fix metrics race condition #1552
• [METRICS SDK] Fix metrics context circular reference #1535
• [METRICS EXPORTER] Improve scope/instrument names in metrics ostream exporter #1544
• [METRICS BUILD] fix IWYU error in instruments.h #1555
• [EXPORTER] Prometheus exporter support Gauge Type #1553
• [METRICS SDK] Fix default Metric view name #1515
• [SDK] Fix infinitely waiting when shutdown with more than one running http sessions. #1549
• [METRICS SDK] Fix OTLP gRPC Metrics env variables #1543
• [METRICS SDK] Metric aggregation temporality controls #1541
• [METRICS SDK] Histogram min/max support #1540
• [METRICS EXPORTER] ostream exporter should print out resource attributes #1523
• [METRICS SDK] Support multiple async callbacks #1495
• [BUILD] Fix code scanning alert #1530
• [BUILD] Fix several compiling/linking errors #1539
• [TRACE SDK] Add SpanData getter for Span Recordable #1508
• [LOG SDK] Fix log sdk builder (#1486) #1524
• [METRICS SDK] Add configuration options for Aggregation creation #1513
• [METRICS TEST] Fix metrics unit test memory leack #1533
• [LOG SDK] Add log sdk builders (#1486) #1524

[1.5.0] 2022-07-29

• [EXPORTER BUILD] Add resources to dep list of prometheus exporter test #1527
• [BUILD] Don't require applications using jaeger exporter to know about libcurl #1518
• [EXPORTER] Inline print_value() in ostream exporter #1512
• [SDK] fix: urlPaser will incorrect parsing url like http://abc.com/xxx@xxx/a/b #1511
• [SDK] Rename InstrumentationLibrary to InstrumentationScope #1507
• [BUILD] Try to build nlohmann-json only it's depended. #1505
• [EXPORTER BUILD] Link opentelemetry_api to ETW exporter test #1503
• [SDK] Add automatically semantic conventions from the spec (#873) #1497
• [SDK] Use template class for in-memory data. #1496
• [SDK] fix compiler warnings #1499
• [TRACE SDK] Add trace sdk builders (#1393) #1471
• [METRICS BUILD] Enable bazel build for metrics proto files #1489
• [METRICS EXPORTER] Add metrics OTLP/HTTP exporter #1487
• [EXPORTER] fix otlp grpc exporter naming #1488
• [BUILD] Remove --config Debug when installing. #1480
• [EXPORTER] Fix endpoint in otlp grpc exporter #1474
• [EXAMPLE] Fix memory ownership of InMemorySpanExporter (#1473) #1471
• [EXPORTER TESTS] Prometheus unit test #1461
• [DOCS] Update docs to use relative code links. #1447
• [SDK] Remove reference to deprecated InstrumentationLibrary in OTLP #1469
• [SDK] Fix trace kIsSampled flag set incorrectly #1465
• [METRICS EXPORTER] OTLP gRPC Metrics Exporter #1454
• [EXPORTER] fix prometheus exporter failure type #1460
• [SDK] Fix build warnings about missing aggregates. #1368
• [EXT] curl::HttpClient use curl_multi_handle instead of creating a thread for every request and it's able to reuse connections now. (#1317)
• [SEMANTIC CONVENTIONS] Upgrade to version 1.12.0 #873

[1.4.1] 2022-06-19

• [METRICS SDK] Fix variables inizialization #1430
• [DOCS] Fixed broken link to OpenTelemetry.io (#1445) #1446
• [BUILD] Upgrade nlohmann_json to 3.10.5 (#1438) #1441
• [METRICS SDK] fix histogram #1440
• [DOCS] Fix GettingStarted documentation for Jaeger HTTP exporter (#1347) #1439
• [BUILD] install sdk-config.h #1419
• [EXAMPLE] Log current timestamp instead of epoch time #1434
• [METRICS SDK] Add attributes/dimensions to metrics ostream exporter #1400
• [SDK] Fix global log handle symbols when using dlopen #1420
• [METRICS] Only record non-negative / finite / Non-NAN histogram values(#1427)
• [ETW EXPORTER] Fix ETW log exporter header inclusion #1426
• [ETW EXPORTER] Copy string_view passed to ETW exporter in PropertyVariant #1425
• [METRICS API/SDK] Pass state to async callback function. #1408
• [BUILD] fix nlohmann_json's (third party) include dir #1415
• [SDK] fix: WaitOnSocket select error when sockfd above FD_SETSIZE #1410
• [SDK] fix OTEL_INTERNAL_LOG_INFO #1407
• [DOCS] Document Getting Started with Prometheus and Grafana #1396

[1.4.0] 2022-05-17

• [API SDK] Upgrade proto to v0.17.0, update log data model (#1383)
• [BUILD] Alpine image (#1382)
• [LOGS SDK] Get span_id from context when Logger::Log received invalid span_id (#1398)
• [METRICS SDK] Connect async storage with async instruments (#1388)
• [DOCS] Getting started document using ostream exporter (#1394)
• [BUILD] Fix missing link to nlohmann_json (#1390)
• [SDK] Fix sharing resource in batched exported spans (#1386)
• [PROTOCOL & LOGS] Upgrade proto to v0.17.0, update log data model (#1383)
• [METRICS SDK] Remove un-necessary files. (#1379)
• [EXPORTER] Prometheus exporter meters and instrument name (#1378)
• [API] Add noexcept/const qualifier at missing places for Trace API. (#1374)
• [SDK] Fix empty tracestate header propagation (#1373)
• [METRICS SDK] Reuse temporal metric storage for sync storage (#1369)
• [SDK] Fix baggage propagation for empty/invalid baggage context (#1367)
• [BUILD] Export opentelemetry_otlp_recordable (#1365)
• [TESTS] Disable test on prometheus-cpp which not need (#1363)
• [METRICS] Fix class member initialization order (#1360)
• [METRICS SDK] Simplify SDK Configuration: Use View with default aggregation if no matching View is configured (#1358)
• [BUILD] Add missing include guard (#1357)
• [ETW EXPORTER] Fix scalar delete against array (#1356)
• [ETW EXPORTER] Conditional include for codecvt header (#1355)
• [BUILD] Use latest TraceLoggingDynamic.h (#1354)
• [SDK] Add explicit type cast in baggage UrlDecode (#1353)
• [METRICS SDK] Remove exporter registration to meter provider (#1350)
• [METRICS SDK] Fix output time in metrics OStream exporter (#1346)
• [BUILD] ostream metrics cmake (#1344)
• [BUILD] Link opentelemetry_ext with opentelemetry_api (#1336)
• [METRICS SDK] Enable metric collection for Async Instruments - Delta and Cumulative (#1334)
• [BUILD] Dependencies image as artifact (#1333)
• [EXAMPLE] Prometheus example (#1332)
• [METRICS EXPORTER] Prometheus exporter (#1331)
• [METRICS] Metrics histogram example (#1330)
• [TESTS] Replace deprecated googletest API (#1327)
• [BUILD] Fix Ninja path (#1326)
• [API] Update yield logic for ARM processor (#1325)
• [BUILD] Fix metrics compiler warnings (#1328)
• [METRICS SDK] Implement Merge and Diff operation for Histogram Aggregation (#1303)

Notes:

While opentelemetry-cpp Logs are still in experimental stage, #1383 updated opentelemetry-proto to 0.17.0, which includes some breaking change in the protocol, like this. This makes name parameter for our log API unnecessary. However, this parameter is marked deprecated instead of being removed in this release, and it will be removed in future release.

[1.3.0] 2022-04-11

• [ETW EXPORTER] ETW provider handle cleanup (#1322)
• [BUILD] Move public definitions into opentelemetry_api. (#1314)
• [METRICS] OStream example (#1312)
• [BUILD] Rename http_client_curl to opentelemetry_http_client_curl (#1301)
• [METRICS SDK] Add InstrumentationInfo and Resource to the metrics data to be exported. (#1299)
• [TESTS] Add building test without RTTI (#1294)
• [METRICS SDK] Implement periodic exporting metric reader (#1286)
• [SDK] Bugfix: span SetAttribute crash (#1283)
• [BUG] Remove implicitly deleted default constructor (#1267)
• [METRICS SDK] Synchronous Metric collection (Delta , Cumulative) (#1265)
• [METRICS SDK] Metrics exemplar round 1 (#1264)
• [EXPORTER] Fix: use CURLOPT_TIMEOUT_MS to config OtlpHttpExporter's timeout instead of CURLOPT_TIMEOUT (#1261)
• [EXPORTER] Jaeger Exporter - Populate Span Links (#1251)
• [SDK] Reorder the destructor of members in LoggerProvider and TracerProvider (#1245)
• [METRICS SDK] Enable metric collection from MetricReader (#1241)
• [METRICS SDK] Asynchronous Aggregation storage (#1232)
• [METRICS SDK] Synchronous Instruments - Aggregation Storage(s) creation for configured views (#1219)
• [BUILD] Added s390x arch into CMake build. (#1216)
• [API] Allow extension of the lifetime of ContextStorage. (#1214)
• [METRICS SDK] Add Aggregation storage (#1213)
• [TESTS] Fix ostream_log_test Mac (#1208)
• [BUILD] Update grpc to v1.43.2 to support VS2022/MSVC 19.30 and bazel 5.0 (#1207)
• [DOCS] Benchmark documentation (#1205)
• [DOCS] Fix errors in SDK documentation (#1201)
• [METRICS EXPORTER] Ostream metric exporter (#1196)
• [Metrics SDK] Filtering metrics attributes (#1191)
• [Metrics SDK] Sync and Async Instruments SDK (#1184)
• [Metrics SDK] Add Aggregation as part of metrics SDK. (#1178)
• [BUILD] Cmake: thrift requires boost headers, include them as Boost_INCLUDE_DIRS (#1100)

Notes:

#1301 added opentelemetry_ as prefix to http_client_curl library for resolving potential naming conflict, this could break existing cmake build if http_client_curl is listed as explicit dependency in user's cmake file.

[1.2.0] 2022-01-31

• [CI] Continuous benchmark tests as part of the CI (#1174)
• [API] Allow to use external abseil for bazel targets (#1172)
• [EXPORTER] Importing gsl::span if std::span is not available (#1167)
• [EXPORTER] Synchronized calls to Exporter::Export & Shutdown (#1164)
• [EXPORTER] OTLP http exporter block thread (#1163)
• [TESTS] Jaeger: ThriftSender unit test (#1162)
• [EXPORTER] InMemorySpanExporter shutdown fix (#1161)
• [EXPORTER] Fix leak in Jaeger exporter (#1160)
• [TESTS] ZipkinExporter unit-tests (#1155)
• [SDK] Logger: propagating resources through LoggerProvider (#1154)
• [SDK] Logger: support for instrumentation library (#1149)
• [SDK] Add log level for internal log of sdk (#1147)
• [METRICS] Metrics SDK: View API (#1110)

Notes on experimental features:

#1149 and #1154 from above CHANGELOG introduced API changes which are not backward compatible with previous logs, please update API package to this release if ENABLE_LOGS_PREVIEW is turned on (it is turned off by default).

[1.1.1] 2021-12-20

• [SDK] Rename OTEL_CPP_GET_ATTR macro, and define it using fully qualified attr function (#1140)
• [SDK] Default resource attributes and attributes in OTEL_RESOURCE_ATTRIBUTES are missing when using Otlp*LogExporter (#1082)
• [METRICS] Add Meter and MeterProvider in the SDK (#1078)
• [EXPORTER] ZipkinExporter shutdown (#1153)
• [EXPORTER] Jaeger exporter shutdown (#1150)
• [EXPORTER] Bugfix: jaeger::TUDPTransport::write crash when getaddrinfo returns error (#1116)
• [EXPORTER] Bugfix: Jaeger exporter: extend supported attributes types (#1106)
• [EXPORTER] Fix otlp generates null span ids (#1113)
• [EXPORTER] Jaeger bazel (Linux only) (#1077)
• [DOCS] Add note on DLL support (#1137)
• [DOCS] Improve the instructions for Bazel build (#1136)
• [DOCS] Document dependencies (#1119)
• [DOCS] Dockerfile for quick demo/troubleshooting purpose (#905)
• [TESTS] Fix data race in BM_ThreadYieldSpinLockThrashing (#1099)
• [EXAMPLE] Otlp gRPC log example (#1083)
• [BUILD] C++20 not Building with VS2019 (#1144)
• [BUILD] Mark tags to bazel targets(#1075)

[1.1.0] 2021-11-19

• [BUILD] build release tarball when nlohmann-json not installed (#1074)
• [SDK] Bugfix: regex is neither working on GCC 4.9.x (#1069)
• [SDK] Improvement: span_id should not break strict aliasing. (#1068)
• [EXAMPLE] OTLP HTTP log example (#1062)
• [SDK] OTLP gRPC log export should fail after shutdown (#1064)
• [BUILD] Building otlp exporter from the release tarball (#1056)
• [METRICS] Move old metrics implementation to different directory, and rename targets to _deprecated (#1053)
• [EXPORTER] Add OTLP/gRPC Log Exporter (#1048)
• [EXPORTER] Prometheus Exporter (#1031)
• [EXPORTER] Add OTLP/HTTP Log Exporter (#1030)
• [SDK] fix: issue 368- consistent namespace scope resolution (#1008)

[1.0.1] 2021-10-21

• [EXPORTER] Exports span attributes to ETW (#1021)
• [BUILD] cmake: add FindThrift.cmake find module method for thrift (#1020)
• [BUILD] Fix nlohmann_json package dependency (#1017)
• [EXPORTER] Change OTLP/HTTP default port from 4317 to 4318 (#1018)
• [EXPORTER] ETW Log Exporter (#1006)
• [API] Adding new Logger:log() method (#1005)
• [EXPORTER] Remove scheme from OTLP endpoint before passing to gRPC (#988)
• [BUILD] Update opentelemetry-proto for bazel build to 0.9.0 (#984)
• [BUILD] Cross compling grpc_cpp_plugin not found bug (#982)
• [EXPORTER] Support environment variables for both OtlpGrpcExporter and OtlpHttpExporter (#983)
• [API/SDK] Add schema_url support to both Resource and InstrumentationLibrary (#979)
• [BUILD] Fix build issue where memcpy was not declared in scope (#985)

[1.0.0] 2021-09-16

API

• Document DefaultSpan, remove DefaultTracer (#959)
• Separate baggage<->Context api from Baggage Propagator (#963)
• Remove unused public API to_span_ptr (#964)
• :collision: Make span context management public (#967)
• Support determining parent span from Context while creating new Span (#969)
• :collision: Traces: Add note on experimental semantic convention implementation, prefix semantics headers with experimental tag (#970)
• Increment OPENTELEMETRY_ABI_VERSION_NO to 1 (#980)

SDK

• Clean up GetEnvironmentVariable and remove unused variable under NO_GETENV (#976)
• :collision: Resources: Add note on experimental semantic convention implementation, prefix semantics headers with experimental tag (#970)

OTLP Exporter

• :bug: Ignore status description if status code is not Error (#962)
• :collision: Make Otlp exporter configuration environment variables specs-compliant (#974)

Zipkin Exporter

• :bug: Don't set parentId in case parentId is empty (#943)
• :rocket: Extend zipkin exporter with ability to provide headers (#951)

DOCS

• :book: Add getting-started documentation for SDK: (#942)
• :book: Remove unnecessary spaces and spelling of gRPC in README (#965)

BUILD

• Disable bazel build for gcc 4.8, upgrade versions for grpc(v1.39.1) and bazel(4.2.0), document bazel support (#953)
• Move CMake config template to cmake folder (#958)
• Enable CMake to search the new package variable <PackageName>_ROOT (#975)
• :bug: Do not override CMAKE_CXX_STANDARD (#977)

:construction: Experiemental Features (Will change in future)

• Semantic Conventions for traces - As the specs is still experimental, the implementation will change in future.
• Semantic Convention for resource - As the specs is still experimental, the implementation will change in future.
• Logs and Metrics API & SDK - These are not compliant, and are behind feature flag. Not recommended to use for now.

[1.0.0-rc4] 2021-08-04

• [EXPORTER] BREAKING CHANGE Fix default HTTP port for OTLP HTTP Exporter (#939)
• [API] Fix timeout calculation for Tracer::Flush() and Tracer::Close() (#937)
• [API] Fix for Stack::Resize that newcapacity is not assigned to capacity (#934)
• [SDK] Fix race condition in circular buffer simulation test (#931)
• [EXPORTER] Fix error logging in Jaeger Exporter (#930)
• [BUILD] Use latest grpc version (v1.39.0) for cmake build of otlp exporter (#927)
• [EXPORTER] Add Jaeger Thrift HTTP exporter (#926)
• [SDK] Move env-var read logic to common dir, and optional reading of env-var (#924)
• [EXPORTER] Remove recordable header from CMake install rules for exporters (#923)
• [EXPORTER] BREAKING CHANGE Rename Recordable to JaegerRecordable in Jaeger exporter (#919)
• [EXPORTER] BREAKING CHANGE Rename Jaeger exporter target (#918)
• [EXPORTER] Add Zipkin exporter example (#917)
• [EXPORTER] Bazel build for Zipkin exorter (#916)
• [BUILD] Allow to use local GSL (#915)
• [DOCS] Document vcpkg toolchain configuration (#913)
• [SDK] Fix for resource deletion after tracer provider shutdown (#911)
• [BUILD] Add bazel build for grpc example (#910)
• [EXPORTER] Add resource and instrumentation library support for OStreamSpanExporter (#906)
• [API] Adding semantic-convention attributes for trace (#868)

[1.0.0-rc3] 2021-07-12

• [DOCS] Add doxygen reference docs for SDK (#902)
• [EXPORTER] Jaeger Exporter - Populate resource attributes into process tags in Jaeger (#897)
• [EXPORTER] Zipkin Exporter - Report Event timestamp into microseconds (#896)
• [EXPORTER] Jaeger Exporter - Handle span events (#895)
• [DOCS] Fix API docs for Scope object (#894)
• [BUILD] Fix Linking error for libcurl on some macOS environments (#893)
• [API] Context cleanup from Runtime Storage (#885)
• [DOCS] Document strategy to avoid conflict between two different versions of Abseil (#883)
• [EXPORTER] ETW Exporter - Document example for ETW Exporter (#882)
• [SDK] Create Span with Valid spanId and traceId irrespective of Sampling decision (#879)
• [EXPORTER] Jaeger Exporter - Rename bswap macros to avoid clash on some systems (#876)
• [API] Add Semantics Conventions attributes for Resources (#872)
• [BUILD] Use nlohmann-json from submodules if not already installed (#870)

[1.0.0-rc2] 2021-06-18

• [EXPORTER] Jaeger Exporter - Support for Instrumentation Library (#864)
• [TESTS] Adding benchmark tests for baggage api (#861)
• [BUILD] Fix for GCC9/C++20 Support for using STL for modern C++ features (#860)
• [TESTS] Adding benchmark tests for span create api (#856)
• [BUILD] Fix for using Abseil library for modern C++ features (#850)
• [BUILD] Fix issues with win32/x86 compilation (#847)
• [DOCS] Document OSS dependencies and their licenses (#844)
• [BUILD] Various fixes to build with Visual Studio 2015 (#840)
• [INSTRUMENTATION] HTTPClient: Change support for full URL argument (#833)
• [EXPORTER] Jaeger Exporter - fix endianness of Jaeger IDs for transmission (#832)
• [INSTRUMENTATION] fix protobuf compilation warning in gRPC example (#830)
• [EXPORTER] BREAKING CHANGE - Add OTLP/HTTP+JSON Protocol exporter; Rename OtlpExporter to OtlpGrpcExporter (#810)

[1.0.0-rc1] 2021-06-04

• [BUILD] Enable Jaeger exporter build in Windows (#815)
• [DOCS] Versioning doc update to clarify release and versioning policy (#811)
• [LOGS] Move Logging implementation under feature-flag (#807)
• [BUILD] Filter metric headers files from opentelemetry-api and opentelemetry-sdk targets if metrics feature-flag is disabled (#806)
• [BUILD] Fix install rule for ostream exporter, Jaeger, ETW, ElasticSearch (#805)
• [API/SDK] Switch from mpark::variant to absl::variant as default (#771)
• [API/SDK] Support const char * as acceptable data type for attributes and resources (#771)
• [EXAMPLE] gRPC instrumentation example with context propagation (#729)

[0.7.0] 2021-05-26

• [METRICS] Move metrics api/sdk under preview feature flag (#745)
• [DOCS] Add instructions to build using Bazel (#747)
• [DOCS] Update copyright headers (#754)
• [EXPORTER] Populate resource to OTLP proto data (#758)
• [CI] Add CodeQL security scan CI workflow (#770)
• [BUILD] Enable building API only CMake Project (#778)
• [SDK] Fix for sampling of root span (#784)
• [CI] Add Jaeger exporter to CMake CI build (#786)
• [API] BREAKING CHANGE - Tracer::WithActiveSpan() to return Scope object intead of unique_ptr (#788)
• [DOCS] Add docs for nested spans and context propagation in readthedocs (#792)
• [CI] Output verbose error for failed unit-test in CI (#796)

[0.6.0] 2021-05-11

• [EXPORTER] Add Jaeger exporter (#534)
• [SDK] Support multiple processors (#692)
• [SDK] Add instrumentation library and multiple tracer support (#693)
• [SDK] Resource integration with Exporters (#706)
• [EXAMPLE] Enhance existing http example with propagation (#727)

[0.5.0] 2021-04-26

• [SDK] Support custom span-id and trace-id generator (#681)
• [SDK] Add SpanContext (and TraceState) to Recordable (#667)
• [SDK] Global Propagator (#668)
• [SDK] Create SharedContext for updating span pipeline (#650)
• [API] Baggage implementation (#676)
• [API] Move class from opentelemetry::core namespace to opentelemetry::common namespace (#686)

[0.4.0] 2021-04-12

• [EXPORTER] ETW Exporter enhancements (#519)
• [EXPORTER] Read Zipkin endpoint from environment variable. (#624)
• [EXPORTER] Split Zpages webserver hosting from Exporter (#626)
• [EXPORTER] ETW Exporter Usage Instructions (#628)
• [INSTRUMENTATION] HTTP Client/Server Instrumentation example (#632)
• [EXPORTER] Enable tls authentication for otlp grpc exporter (#635)
• [API] Refactoring trace_state to reuse common functionality in baggage (#638)

[0.3.0] 2021-03-19

• [EXPORTER] Added Zipkin Exporter. (#471)
• [API] Added Jaeger propagator. (#599)
• [PROPAGATOR] Added Composite Propagator (#597)
• [API] Propagate traceflag from parent (#603)
• [DOCS] Add sphinx support for api doc generation (595)
• [SDK] Add service.name if missing in Resource (#616)

[0.2.0] 2021-03-02

• [SDK] Added ForceFlush to TracerProvider. (#588).
• [SDK] Added Resource API. (#502)
• [API] Modified TraceState support for w3c trace context as per specs.
• [SDK] TraceState implementation as per spec (#551)
• [API] Added B3 Propagator. (#523)
• [Exporter] Added ETW Exporter. (#376)
• [CI] Enable cache for Bazel for faster builds. (#505)

[0.0.1] 2020-12-16

Added

• Trace API and SDK experimental
• OTLP Exporter

Changed

Removed