OpenTelemetry Rust client SDK package

Edit online

Instana OpenTelemetry Rust SDK is based on the open source OpenTelemetry Rust. It provides an OpenTelemetry implementation that supports and IBM platforms (S390X Linux, PowerPC Linux, and AIX), as well as other platforms such as Linux x64 or ARM64 and Windows.

The SDK includes standard OpenTelemetry features that provide tools, APIs, and SDKs that are used to instrument, generate, collect, and export telemetry data (metrics, logs, and traces). These capabilities help you to analyze and understand your software's performance and behavior.

In addition to the standard features of OpenTelemetry Rust, the Instana OpenTelemetry Rust also provides Instana OpenTelemetry Rust SDK, which supports exporter, propagation, and serialization. It allows you to send OpenTelemetry trace data to Instana for monitoring and observability. For more information, see the Instana OpenTelemetry Rust SDK.

Download and build

Edit online

The Instana OpenTelemetry Rust SDK is available in source as tar.gz or zip file and can be downloaded from the releases.

Before building from source, make sure that the following tools are installed:

  • Rust 1.86 or later: Only Rust 1.86 is tested on AIX.

    gcc/g++ 11.0.0 or later (Linux and AIX): Set the environment variable CC to gcc and CXX to g++.

  • OpenSSL development package (Linux and AIX): Set the environment variable OPENSSL_DIR and OPENSSL_LIB_DIR to point to the OpenSSL installation and library directories.

To build the SDK, run the following code:

cargo build --release

Using the crates

Edit online

You can use the crates in either of the following ways:

  1. Use the crate path in your Cargo.toml file, for example: 
    [dependencies]
<crate-name> = { path = "<path-to-the-root-of-source>" }

  2. Install the crates locally by using the cargo install command:

    cargo install --path <path-to-the-root-of-source>

Examples in opentelemetry-instana

Edit online

The examples in the opentelemetry-instana folder show how to use the Instana OpenTelemetry exporter to send trace data to Instana. For more information, see the examples/README.md.