OpenTelemetry C++ v1.8.2

v1.8.2 release

Release of core packages

• opentelemetry-api
• opentelemetry-sdk

and exporter packages:

• opentelemetry-exporter-otlp (gRPC + HTTP/JSON)
• opentelemetry-exporter-etw

API

• No API change

SDK

• Log a warning when the BatchSpanProcessor queue is full. by @johanpel in #1871

Exporter

• Fix console debug logs for otlp exporters. by @marcalff in #1848
• Enable setting Span endtime for ETW exporter by @lalitb in #1846
• [ETW Exporter] Add Virtual destructor for TailSampler, Update Maintainer mode warnings for MSVC by @lalitb in #1897

Build

• Fix OTELCPP_MAINTAINER_MODE by @marcalff in #1844
• Fix #1856 by @lalitb in #1857
• Fix typo in packages.cmake causing incorrect nuget package versions by @bretdusseault in #1936
• Cleanup CMake makefiles for CURL usage by @marcalff in #1916
• Migrate from @bazel_tools//platforms to https://github.com/bazelbuild/platforms by @davidmandle in #1873
• Enable generating deb, rpm, NuGet, tgz, zip package through cmake build by @lalitb in #1662
• Cleanup CMake makefiles for nlohmann_json. by @marcalff in #1912
• Fix compatibility when using clang and libc++ by @owent in #1852
• fix SpinLockMutex for Intel Compiler by @gabswb in #1885
• sdk::resource::Resource::Merge should be const by @esigo in #1905

Metrics

• Custom Aggregation support by @lalitb in #1899
• Fix warning for misconfiguration of PeriodicExportingMetricReader by @jwbuurlage in #1929
• Make macros.h available for all source files via version.h by @ThomsonTan in #1918
• minor metrics handling optimizations by @ays7 in #1890
• Collect and Export metric data before PeriodicMetricReader shutdown. by @lalitb in #1860
• Histogram Aggregation: Fix bucket detection logic, performance improvements, and benchmark tests by @lalitb in #1869
• Update meter.h by @sanjaypujare in #1907

Logs

• Update logs sdk and api to follow specification by @owent in #1884
• New LogRecord and Recordable implementations. by @owent in #1766
• Change BatchLogRecordProcessorFactory::Create to static method by @ninghejun in #1876
• Fix resource and scope of new Logs SDK implementation. by @owent in #1881

Sementic Convention

• [SEMANTIC CONVENTIONS] Upgrade to version 1.17.0 by @marcalff in #1927

Documentation

• Updated clone command in INSTALL.md by @paul-ohl in #1818
• [MAINTAINER DOC] Define and document a deprecation process by @marcalff in #1923
• Small fix in INSTALL.md for enabling building package. by @lalitb in #1930

Examples

• Fix #1867 Orderly shutdown in examples by @marcalff in #1868

Removal

• Remove deprecated experimental semantic conventions (#1741) by @marcalff in #1743
• Remove redundant macro check in nostd::shared_ptr by @ThomsonTan in #1939
• Small cleanup to remove old metrics design docs by @lalitb in #1855
• Remove unused namespace alias for nostd by @ThomsonTan in #1914

New Contributors

• @paul-ohl made their first contribution in #1818
• @ninghejun made their first contribution in #1876
• @gabswb made their first contribution in #1885
• @johanpel made their first contribution in #1871
• @sanjaypujare made their first contribution in #1907
• @jwbuurlage made their first contribution in #1929
• @bretdusseault made their first contribution in #1936

Full Changelog: v1.8.1...v1.8.2

Notes:

Deprecation notes:

• [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.