OpenTelemetry C++ pacchetto SDK per i clienti

Modifica online

Il pacchetto SDK client OpenTelemetry C++ è un esportatore OpenTelemetry OTLP per C++. Questo pacchetto consente di integrare la strumentazione OpenTelemetry nelle proprie applicazioni. I dati possono quindi essere inviati a Instana tramite il protocollo OTLP. Il pacchetto si basa su Opentelemetry-cpp.

Sistemi operativi supportati

Modifica online
  • Linux: Ubuntu 20.04 (GCC 9.4.0) (64 bit)
  • Windows e: Windows Server 2016 (Visual Studio Enterprise 2019) (32 bit e 64 bit)

Prerequisiti

Modifica online

Verificare che siano soddisfatti i seguenti prerequisiti:

  • Linux:

    • GNU Compiler Collection (GCC) 9.4.0 o versione successiva è installato.

    • Sono installati Git, Python 3 e Perl .

    • vcpkg viene installato eseguendo il seguente comando:

      git clone https://github.com/Microsoft/vcpkg.git
./vcpkg/bootstrap-vcpkg.sh
./vcpkg/vcpkg install abseil
./vcpkg/vcpkg install c-ares
./vcpkg/vcpkg install curl[non-http,openssl,ssl]
./vcpkg/vcpkg install grpc[codegen]
  • Piattaforme Windows:
    • Il compilatore MSVC o MinGW con CMake è installato.
    • CMake o Visual Studio 2019 è installato.
      • Per installare CMake, vai sul sito ufficiale di CMake e scarica il programma di installazione " Windows " per l'ultima versione stabile di CMake. Scegliere la versione appropriata per il sistema, a 32 bit o a 64 bit.
      • Per installare Visual Studio 2019, vai alla pagina di download di Visual Studio e scarica il programma di installazione di Visual Studio Windows. Eseguire il programma di installazione scaricato. Durante il processo di installazione, è necessario selezionare i workload, che sono una serie di strumenti e componenti per scenari di sviluppo specifici. Se installi il compilatore MSVC, seleziona il flusso di lavoro "Sviluppo desktop con C++ ".
    • vcpkg viene installato eseguendo i seguenti comandi:
      git clone https://github.com/Microsoft/vcpkg.git
.\vcpkg\bootstrap-vcpkg.cmd
.\vcpkg.exe integrate
.\vcpkg.exe install abseil
.\vcpkg.exe install c-ares
.\vcpkg.exe install curl
.\vcpkg.exe install grpc
Nota: per creare un ambiente di lavoro C++, è necessario un sistema di gestione delle librerie C++, come ad esempio Vcpkg.

Installazione del package

Modifica online

Per installare il package, scaricare il file del package ed estrarlo in una directory locale.

tar xzf opentelemetry-cpp-1.9.1-gcc9.4.0-ubuntu20.04_x64.tar.gz

unzip opentelemetry-cpp-1.9.1-vs2019-windows_x64.zip

unzip opentelemetry-cpp-1.9.1-vs2019-windows_x86.zip

Verifica dell'installazione

Modifica online

Completa i seguenti passaggi per verificare se il pacchetto SDK client C++ OpenTelemetry funziona sulla tua macchina host:

  1. Scarica gli esempi OpenTelemetry .

    1. Scarica i file grpc_main.cc http_main.cc e d all'esempioOpentelemetry-cpp all'indirizzo OTeL. Salvarli quindi nella directory otlp .

    2. Scarica i file foo_library.cc foo_libary.h e d all'esempio foo_library diOpentelemetry-cpp. Salvarli quindi nella directory otlp/foo_library .

  2. Creare un file CMakeLists.txt nella directory otlp .

    • Linux:

      cmake_minimum_required(VERSION 3.12.0)

project(sample)

set(CMAKE_CXX_STANDARD 14)
set(OTEL_CPP_DIR "/opt/otel-cppclient/opentelemetry-cpp_x64-linux")
set(OTEL_LIBS_PATH "${OTEL_CPP_DIR}/lib")
set(VCPKGL_LIBS_PATH "<path to vcpkg>/installed/x64-linux/lib")

include_directories("${OTEL_CPP_DIR}/include")

find_package(absl REQUIRED)
find_package(Protobuf CONFIG REQUIRED)
find_package(CURL REQUIRED)
find_package(gRPC REQUIRED)

# HTTP
add_executable(otel_http_sample http_main.cc
    "foo_library/foo_library.cc"
)

target_link_libraries(otel_http_sample
    -pthread
    ${OTEL_LIBS_PATH}/libopentelemetry_trace.a
    ${OTEL_LIBS_PATH}/libopentelemetry_proto.a
    ${OTEL_LIBS_PATH}/libopentelemetry_http_client_curl.a
    ${OTEL_LIBS_PATH}/libopentelemetry_exporter_otlp_http.a
    ${OTEL_LIBS_PATH}/libopentelemetry_exporter_otlp_http_client.a
    ${OTEL_LIBS_PATH}/libopentelemetry_logs.a
    ${OTEL_LIBS_PATH}/libopentelemetry_otlp_recordable.a
    ${OTEL_LIBS_PATH}/libopentelemetry_common.a
    ${OTEL_LIBS_PATH}/libopentelemetry_trace.a
    ${OTEL_LIBS_PATH}/libopentelemetry_resources.a
    ${VCPKGL_LIBS_PATH}/libprotobuf.a
    ${VCPKGL_LIBS_PATH}/libcurl.a
    ${VCPKGL_LIBS_PATH}/libssl.a
    ${VCPKGL_LIBS_PATH}/libcrypto.a
    -lpthread
    -ldl
    ${VCPKGL_LIBS_PATH}/libz.a
    )

# GRPC
add_executable(otel_grpc_sample grpc_main.cc
    "foo_library/foo_library.cc"
)

target_link_libraries(otel_grpc_sample
    -pthread
    ${OTEL_LIBS_PATH}/libopentelemetry_trace.a
    ${OTEL_LIBS_PATH}/libopentelemetry_exporter_otlp_grpc.a
    -pthread
    ${OTEL_LIBS_PATH}/libopentelemetry_otlp_recordable.a
    ${OTEL_LIBS_PATH}/libopentelemetry_trace.a
    ${OTEL_LIBS_PATH}/libopentelemetry_logs.a
    ${OTEL_LIBS_PATH}/libopentelemetry_resources.a
    ${OTEL_LIBS_PATH}/libopentelemetry_metrics.a
    ${OTEL_LIBS_PATH}/libopentelemetry_common.a
    ${OTEL_LIBS_PATH}/libopentelemetry_exporter_otlp_grpc_client.a
    ${OTEL_LIBS_PATH}/libopentelemetry_proto.a
)
target_link_libraries(otel_grpc_sample absl::flat_hash_map absl::strings absl::str_format)
target_link_libraries(otel_grpc_sample gRPC::gpr gRPC::grpc gRPC::grpc++ gRPC::grpc++_alts)

    • Windows:

      cmake_minimum_required(VERSION 3.12.0)

project(otel_sample)

set(CMAKE_CXX_STANDARD 14)
set(OTEL_CPP_DIR "C:/otel-cppclient/opentelemetry-cpp_x64-windows")
set(OTEL_LIBS_PATH "${OTEL_CPP_DIR}/lib")
set(CMAKE_TOOLCHAIN_FILE "<path to vcpkg>/scripts/buildsystems/vcpkg.cmake" CACHE STRING "Vcpkg toolchain file")

include_directories("${OTEL_CPP_DIR}/include")

find_package(absl REQUIRED)
find_package(protobuf CONFIG REQUIRED)
find_package(CURL REQUIRED)
find_package(gRPC REQUIRED)

# HTTP
add_executable(otel_http_sample http_main.cc
    "foo_library/foo_library.cc" 
)

target_link_libraries(otel_http_sample 
    ${OTEL_LIBS_PATH}/opentelemetry_proto.lib
    ${OTEL_LIBS_PATH}/opentelemetry_http_client_curl.lib 
    ${OTEL_LIBS_PATH}/opentelemetry_exporter_otlp_http.lib
    ${OTEL_LIBS_PATH}/opentelemetry_exporter_otlp_http_client.lib
    ${OTEL_LIBS_PATH}/opentelemetry_logs.lib
    ${OTEL_LIBS_PATH}/opentelemetry_otlp_recordable.lib
    ${OTEL_LIBS_PATH}/opentelemetry_common.lib
    ${OTEL_LIBS_PATH}/opentelemetry_trace.lib
    ${OTEL_LIBS_PATH}/opentelemetry_resources.lib
    )
target_link_libraries(otel_http_sample absl::flat_hash_map absl::strings absl::str_format)
target_link_libraries(otel_http_sample CURL::libcurl)
target_link_libraries(otel_http_sample protobuf::libprotobuf)

# GRPC
add_executable(otel_grpc_sample grpc_main.cc
    "foo_library/foo_library.cc" 
)

target_link_libraries(otel_grpc_sample 
    ${OTEL_LIBS_PATH}/opentelemetry_proto.lib
    ${OTEL_LIBS_PATH}/opentelemetry_proto_grpc.lib
    ${OTEL_LIBS_PATH}/opentelemetry_exporter_otlp_grpc.lib
    ${OTEL_LIBS_PATH}/opentelemetry_exporter_otlp_grpc_client.lib
    ${OTEL_LIBS_PATH}/opentelemetry_logs.lib
    ${OTEL_LIBS_PATH}/opentelemetry_otlp_recordable.lib
    ${OTEL_LIBS_PATH}/opentelemetry_common.lib
    ${OTEL_LIBS_PATH}/opentelemetry_trace.lib
    ${OTEL_LIBS_PATH}/opentelemetry_resources.lib
)
target_link_libraries(otel_grpc_sample absl::flat_hash_map absl::strings absl::str_format)
target_link_libraries(otel_grpc_sample gRPC::gpr gRPC::grpc gRPC::grpc++ gRPC::grpc++_alts)

  3. Crea questi OpenTelemetry esempi che hai scaricato nel passo 1 immettendo i seguenti comandi:

    • Linux:

      cd otlp
mkdir build
cd ./build/
cmake .. -DCMAKE_BUILD_TYPE=Release -DCMAKE_SYSTEM_NAME=Linux -DCMAKE_VERBOSE_MAKEFILE=ON -DVCPKG_CHAINLOAD_TOOLCHAIN_FILE=<path to vcpkg>/scripts/toolchains/linux.cmake -DCMAKE_TOOLCHAIN_FILE=<path to vcpkg>/scripts/buildsystems/vcpkg.cmake
cmake --build .

    • Windows:

      cd otlp
mkdir build
cd .\build\
cmake .. -DCMAKE_TOOLCHAIN_FILE="<path to vcpkg>/scripts/buildsystems/vcpkg.cmake"
cmake --build .

  4. Verificare questi esempi di OpenTelemetry completando la seguente procedura:

    1. Installare l'agente host di Instana.

    2. Configurare l'agente di Instana per ricevere i dati di OTLP.

    3. Sulla stessa macchina host, inviare i dati dell' OTLP e all'agente host eseguendo uno dei seguenti comandi:

      example_otlp_grpc localhost:4317

      example_otlp_http localhost:4318/v1/traces

    4. Se viene visualizzato un messaggio di errore, controllare il log dell'agent host.