Opentracing shim

.gitmodules

@@ -32,3 +32,8 @@ branch = main
 path = third_party/nlohmann-json
 url = https://github.com/nlohmann/json
 branch = master
+
+[submodule "third_party/opentracing-cpp"]
+path = third_party/opentracing-cpp
+url = https://github.com/opentracing/opentracing-cpp.git
+branch = master

CMakeLists.txt

@@ -170,6 +170,8 @@ option(BUILD_W3CTRACECONTEXT_TEST "Whether to build w3c trace context" OFF)
 
 option(OTELCPP_MAINTAINER_MODE "Build in maintainer mode (-Wall -Werror)" OFF)
 
+option(WITH_OPENTRACING "Whether to include the Opentracing shim" OFF)
+
 set(OTELCPP_PROTO_PATH
     ""
     CACHE PATH "Path to opentelemetry-proto")
@@ -497,6 +499,29 @@ include_directories(api/include)
 
 add_subdirectory(api)
 
+if(WITH_OPENTRACING)
+  find_package(OpenTracing CONFIG QUIET)
+  if(NOT OpenTracing_FOUND)
+    set(OPENTRACING_DIR "third_party/opentracing-cpp")
+    message("Trying to use local ${OPENTRACING_DIR} from submodule")
+    if(EXISTS "${PROJECT_SOURCE_DIR}/${OPENTRACING_DIR}/.git")
+      set(SAVED_BUILD_TESTING ${BUILD_TESTING})
+      set(BUILD_TESTING OFF)
+      add_subdirectory(${OPENTRACING_DIR})
+      set(BUILD_TESTING ${SAVED_BUILD_TESTING})
+    else()
+      message(
+        FATAL_ERROR
+          "\nopentracing-cpp package was not found. Please either provide it manually or clone with submodules. "
+          "To initialize, fetch and checkout any nested submodules, you can use the following command:\n"
+          "git submodule update --init --recursive")
+    endif()
+  else()
+    message("Using external opentracing-cpp")
+  endif()
+  add_subdirectory(opentracing-shim)
+endif()
+
 if(NOT WITH_API_ONLY)
   set(BUILD_TESTING ${BUILD_TESTING})
   include_directories(sdk/include)
@@ -506,6 +531,7 @@ if(NOT WITH_API_ONLY)
   add_subdirectory(sdk)
   add_subdirectory(ext)
   add_subdirectory(exporters)
+
   if(BUILD_TESTING)
     add_subdirectory(test_common)
   endif()

bazel/repository.bzl

@@ -179,6 +179,17 @@ def opentelemetry_cpp_deps():
         ],
     )
 
+    # Opentracing
+    maybe(
+        http_archive,
+        name = "com_github_opentracing",
+        sha256 = "5b170042da4d1c4c231df6594da120875429d5231e9baa5179822ee8d1054ac3",
+        strip_prefix = "opentracing-cpp-1.6.0",
+        urls = [
+            "https://github.com/opentracing/opentracing-cpp/archive/refs/tags/v1.6.0.tar.gz",
+        ],
+    )
+
     # boost headers from vcpkg
     maybe(
         native.new_local_repository,

cmake/opentelemetry-cpp-config.cmake.in

@@ -46,6 +46,7 @@
 #   opentelemetry-cpp::jaeger_trace_exporter             - Imported target of opentelemetry-cpp::jaeger_trace_exporter
 #   opentelemetry-cpp::zpages                            - Imported target of opentelemetry-cpp::zpages
 #   opentelemetry-cpp::http_client_curl                  - Imported target of opentelemetry-cpp::http_client_curl
+#   opentelemetry-cpp::opentracing_shim                  - Imported target of opentelemetry-cpp::opentracing_shim
 #
 
 # =============================================================================
@@ -101,7 +102,8 @@ set(_OPENTELEMETRY_CPP_LIBRARIES_TEST_TARGETS
     etw_exporter
     jaeger_trace_exporter
     zpages
-    http_client_curl)
+    http_client_curl
+    opentracing_shim)
 foreach(_TEST_TARGET IN LISTS _OPENTELEMETRY_CPP_LIBRARIES_TEST_TARGETS)
   if(TARGET opentelemetry-cpp::${_TEST_TARGET})
     list(APPEND OPENTELEMETRY_CPP_LIBRARIES opentelemetry-cpp::${_TEST_TARGET})

opentracing-shim/BUILD

@@ -0,0 +1,102 @@
+package(default_visibility = ["//visibility:public"])
+
+cc_library(
+    name = "opentracing_shim",
+    srcs = [
+        "src/span_context_shim.cc",
+        "src/span_shim.cc",
+        "src/tracer_shim.cc",
+    ],
+    hdrs = [
+        "include/opentelemetry/opentracingshim/propagation.h",
+        "include/opentelemetry/opentracingshim/shim_utils.h",
+        "include/opentelemetry/opentracingshim/span_context_shim.h",
+        "include/opentelemetry/opentracingshim/span_shim.h",
+        "include/opentelemetry/opentracingshim/tracer_shim.h",
+    ],
+    strip_include_prefix = "include",
+    tags = ["opentracing"],
+    deps = [
+        "//api",
+        "@com_github_opentracing//:opentracing",
+    ],
+)
+
+cc_test(
+    name = "propagation_test",
+    srcs = [
+        "test/propagation_test.cc",
+        "test/shim_mocks.h",
+    ],
+    tags = [
+        "opentracing_shim",
+        "test",
+    ],
+    deps = [
+        ":opentracing_shim",
+        "@com_google_googletest//:gtest_main",
+    ],
+)
+
+cc_test(
+    name = "shim_utils_test",
+    srcs = [
+        "test/shim_utils_test.cc",
+        "test/shim_mocks.h",
+    ],
+    tags = [
+        "opentracing_shim",
+        "test",
+    ],
+    deps = [
+        ":opentracing_shim",
+        "@com_google_googletest//:gtest_main",
+    ],
+)
+
+cc_test(
+    name = "span_shim_test",
+    srcs = [
+        "test/span_shim_test.cc",
+        "test/shim_mocks.h",
+    ],
+    tags = [
+        "opentracing_shim",
+        "test",
+    ],
+    deps = [
+        ":opentracing_shim",
+        "@com_google_googletest//:gtest_main",
+    ],
+)
+
+cc_test(
+    name = "span_context_shim_test",
+    srcs = [
+        "test/span_context_shim_test.cc",
+    ],
+    tags = [
+        "opentracing_shim",
+        "test",
+    ],
+    deps = [
+        ":opentracing_shim",
+        "@com_google_googletest//:gtest_main",
+    ],
+)
+
+cc_test(
+    name = "tracer_shim_test",
+    srcs = [
+        "test/tracer_shim_test.cc",
+        "test/shim_mocks.h",
+    ],
+    tags = [
+        "opentracing_shim",
+        "test",
+    ],
+    deps = [
+        ":opentracing_shim",
+        "@com_google_googletest//:gtest_main",
+    ],
+)

opentracing-shim/CMakeLists.txt

@@ -0,0 +1,73 @@
+set(this_target opentelemetry_opentracing_shim)
+
+add_library(${this_target}
+  src/span_shim.cc
+  src/span_context_shim.cc
+  src/tracer_shim.cc)
+
+set_target_properties(${this_target} PROPERTIES EXPORT_NAME opentracing_shim)
+
+if(OPENTRACING_DIR)
+  include_directories(
+    "${CMAKE_BINARY_DIR}/${OPENTRACING_DIR}/include"
+    "${CMAKE_SOURCE_DIR}/${OPENTRACING_DIR}/include"
+    "${CMAKE_SOURCE_DIR}/${OPENTRACING_DIR}/3rd_party/include")
+endif()
+
+target_include_directories(
+  ${this_target}
+  PUBLIC "$<BUILD_INTERFACE:${CMAKE_CURRENT_LIST_DIR}/include>"
+         "$<INSTALL_INTERFACE:include>")
+
+target_link_libraries(
+  ${this_target}
+  PUBLIC opentelemetry_api)
+
+install(
+  TARGETS ${this_target}
+  EXPORT "${PROJECT_NAME}-target"
+  RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR}
+  LIBRARY DESTINATION ${CMAKE_INSTALL_LIBDIR}
+  ARCHIVE DESTINATION ${CMAKE_INSTALL_LIBDIR})
+
+install(
+  DIRECTORY include/opentelemetry/opentracingshim
+  DESTINATION include/opentelemetry
+  FILES_MATCHING
+  PATTERN "*.h")
+
+if(BUILD_TESTING)
+  foreach(
+    testname
+    propagation_test
+    shim_utils_test
+    span_shim_test
+    span_context_shim_test
+    tracer_shim_test)
+
+    add_executable(${testname} "test/${testname}.cc")
+
+    if(OPENTRACING_DIR)
+      target_link_libraries(
+        ${testname}
+        ${GTEST_BOTH_LIBRARIES}
+        ${CMAKE_THREAD_LIBS_INIT}
+        opentelemetry_api
+        opentelemetry_opentracing_shim
+        opentracing)
+    else()
+      target_link_libraries(
+        ${testname}
+        ${GTEST_BOTH_LIBRARIES}
+        ${CMAKE_THREAD_LIBS_INIT}
+        opentelemetry_api
+        opentelemetry_opentracing_shim
+        OpenTracing::opentracing)
+    endif()
+
+    gtest_add_tests(
+      TARGET ${testname}
+      TEST_PREFIX opentracing_shim.
+      TEST_LIST ${testname})
+  endforeach()
+endif() # BUILD_TESTING

opentracing-shim/README.md

@@ -0,0 +1,45 @@
+# OpenTracing Shim
+
+[![Apache License][license-image]][license-image]
+
+The OpenTracing shim is a bridge layer from OpenTelemetry to the OpenTracing API.
+It takes OpenTelemetry Tracer and exposes it as an implementation of an OpenTracing Tracer.
+
+## Usage
+
+Use the TracerShim wherever you initialize your OpenTracing tracers.
+There are 2 ways to expose an OpenTracing Tracer:
+1. From the global OpenTelemetry configuration:
+    ```cpp
+    auto tracer_shim = TracerShim::createTracerShim();
+    ```
+1. From a provided OpenTelemetry Tracer instance:
+    ```cpp
+    auto tracer_shim = TracerShim::createTracerShim(tracer);
+    ```
+
+Optionally, you can specify propagators to be used for the OpenTracing `TextMap` and `HttpHeaders` formats:
+
+```cpp
+OpenTracingPropagators propagators{
+  .text_map = nostd::shared_ptr<TextMapPropagator>(new trace::propagation::JaegerPropagator()),
+  .http_headers = nostd::shared_ptr<TextMapPropagator>(new trace::propagation::HttpTraceContext())
+};
+
+auto tracer_shim = TracerShim::createTracerShim(tracer, propagators);
+```
+
+If propagators are not specified, OpenTelemetry's global propagator will be used.
+
+## License
+
+Apache 2.0 - See [LICENSE][license-url] for more information.
+
+## Useful links
+
+- For more information on OpenTelemetry, visit: <https://opentelemetry.io/>
+- For help or feedback on this project, join us in [GitHub Discussions][discussions-url]
+
+[discussions-url]: https://github.com/open-telemetry/opentelemetry-cpp/discussions
+[license-url]: https://github.com/open-telemetry/opentelemetry-cpp/blob/main/LICENSE
+[license-image]: https://img.shields.io/badge/license-Apache_2.0-green.svg?style=flat