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.
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.
- [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
- [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
toInstrumentationScope
#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
usecurl_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
- [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
- [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
withopentelemetry_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.
- [ETW EXPORTER] ETW provider handle cleanup (#1322)
- [BUILD] Move public definitions into
opentelemetry_api
. (#1314) - [METRICS] OStream example (#1312)
- [BUILD] Rename
http_client_curl
toopentelemetry_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.
- [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).
- [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 whengetaddrinfo
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)
- [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)
- [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
andOtlpHttpExporter
(#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)
- Document DefaultSpan, remove DefaultTracer (#959)
- Separate baggage<->Context api from Baggage Propagator (#963)
- Remove unused public API to_span_ptr (#964)
- π₯ Make span context management public (#967)
- Support determining parent span from Context while creating new Span (#969)
- π₯ Traces: Add note on experimental semantic convention implementation, prefix semantics headers with experimental tag (#970)
- Increment OPENTELEMETRY_ABI_VERSION_NO to 1 (#980)
- Clean up
GetEnvironmentVariable
and remove unused variable underNO_GETENV
(#976) - π₯ Resources: Add note on experimental semantic convention implementation, prefix semantics headers with experimental tag (#970)
- π Ignore status description if status code is not Error (#962)
- π₯ Make Otlp exporter configuration environment variables specs-compliant (#974)
- π Don't set parentId in case parentId is empty (#943)
- π Extend zipkin exporter with ability to provide headers (#951)
- π Add getting-started documentation for SDK: (#942)
- π Remove unnecessary spaces and spelling of gRPC in README (#965)
- 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) - π Do not override CMAKE_CXX_STANDARD (#977)
- 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.
- [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 new_capacity 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)
- [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)
- [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; RenameOtlpExporter
toOtlpGrpcExporter
(#810)
- [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
andopentelemetry-sdk
targets if metrics feature-flag is disabled (#806) - [BUILD] Fix install rule for ostream exporter, Jaeger, ETW, ElasticSearch ([#805](Fix install rule for header files of ostream exporter))
- [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)
- [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)
- [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)
- [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)
- [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](Enable tls authentication for otlp grpc exporter))
- [API] Refactoring trace_state to reuse common functionality in baggage (#638)
- [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)
- [SDK] Added
ForceFlush
toTracerProvider
. (#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)
- Trace API and SDK experimental
- OTLP Exporter