Skip to content

Latest commit

 

History

History
174 lines (107 loc) · 4.29 KB

DEPRECATED.md

File metadata and controls

174 lines (107 loc) · 4.29 KB
Raw

Deprecated

This document lists all the items currently deprecated in opentelemetry-cpp.

Deprecated items will be removed in the future.

Guidelines

Maintainer guidelines

See the deprecation-process

[TEMPLATE]

New Deprecation Title (Template)

Announcement (Template)

Motivation (Template)

Scope (Template)

Mitigation (Template)

Planned removal (Template)

[Platforms]

N/A

[Compilers]

Drop C++11 support

Announcement (C++11)

  • Date: 2022-12-01
  • Issue: [DEPRECATION] Drop C++11 support #1830
  • This announcement has been pinned, visible in the issues pages since December 2022.

Motivation (C++11)

This repository, opentelemetry-cpp, supports a "bring your own dependency" model.

In this model, the build scripts can be configured to:

  • pick a given version for a third party library,
  • build opentelemetry-cpp with the library given.

The makefiles do not mandate to use a particular version, hence the "bring your own" denomination.

To have an up to date build, projects are encouraged to use up to date versions of third party libraries, to benefit from bug fixes.

Now, many libraries deliver new versions that require C++14, bug fixes releases for C++11 are no longer available.

In particular, the following components:

  • GRPC C++
  • abseil
  • googletest

now require C++14, per google support policies

As a result, to stay up to date, opentelemetry-cpp needs to upgrade its minimum build requirements to use C++14 instead of C++11.

Scope (C++11)

Continuous Integration (CI) builds will use C++14 instead of C++11.

The CI build for gcc 4.8 is now deprecated, to be decommissioned when C++11 support is dropped.

Mitigation (C++11)

Building the code with recent third party libraries will require C++14 instead of C++11.

Planned end of life (C++11)

Support for C++11 in opentelemetry-cpp will end on September 2023.

After this date, opentelemetry-cpp may still build properly in C++11 mode, assuming a suitable, old, version for each dependency is used, but the C++11 build will no longer be tested for each new release.

[Third party dependencies]

Jaeger

See Jaeger exporter

[Build tools]

N/A

[Build scripts]

N/A

[opentelemetry-cpp API]

N/A

[opentelemetry-cpp SDK]

N/A

[opentelemetry-cpp Exporter]

Jaeger exporter

Announcement (Jaeger)

  • Version: 1.8.2
  • Date: 2023-01-31
  • PR: [DEPRECATION] Deprecate the Jaeger exporter #1923

Motivation (Jaeger)

The Jaeger client libraries are deprecated, as announced here.

The initial Jaeger announcement in release 1.35 reads as:

" We plan to continue accepting pull requests and making new releases of Jaeger clients through the end of 2021. In January 2022 we will enter a code freeze period for 6 months, during which time we will no longer accept pull requests with new features, with the exception of security-related fixes. After that we will archive the client library repositories and will no longer accept new changes. "

At time of writing, Jan 2023, the client libraries have been archived 6 months ago already.

Scope (Jaeger)

The following are deprecated and planned for removal:

  • the API header opentelemetry/trace/propagation/jaeger.h, including:
    • the C++ class JaegerPropagator
  • all the code located under exporters/jaeger/, including:
    • the jaeger exporter C++ class (JaegerExporter)
    • the related factory (JaegerExporterFactory)
    • the related options (JaegerExporterOptions)
  • the jaeger exporter library(opentelemetry_exporter_jaeger_trace)
  • the jaeger build options in CMake (WITH_JAEGER)
  • the dependency on thrift

Mitigation (Jaeger)

Jaeger supports natively the OTLP protocol, starting with jaeger 1.35.

An application instrumented with opentelemetry needs to change how the SDK and exporter are configured to replace the Jaeger exporter with the OTLP exporter (both OTLP HTTP and OTLP GRPC are supported).

Planned removal (Jaeger)

  • Date: July, 2023

[Documentation]

N/A