OpenTelemetry Rust クライアントSDKパッケージ

Instana OpenTelemetry Rust SDKはオープンソースの OpenTelemetry ( Rust )に基づいています。 OpenTelemetry の実装を提供し、 IBM プラットフォーム( S390XLinux、 PowerPCLinux、 AIX )をサポートします。また、 Linux ( x64 )、 ARM64、 Windows などのプラットフォームもサポートします。

このSDKには、テレメトリデータ(メトリクス、ログ、トレース)の計測、生成、収集、エクスポートに使用されるツール、API、SDKを提供する標準的な OpenTelemetry 機能が含まれています。 これらの機能により、ソフトウェアのパフォーマンスと動作を分析し理解することができます。

OpenTelemetry ( Rust )の標準機能に加え、 Instana ( OpenTelemetry ) Rust は、エクスポーター、伝播、シリアル化をサポートする Instana ( OpenTelemetry ) Rust SDKも提供します。 OpenTelemetry のトレースデータを監視および可観測性のために Instana に送信できます。 詳細については、 Instana OpenTelemetry Rust SDK を参照してください。

ダウンロードしてビルドする

InstanaOpenTelemetryRust SDKはソースコードとして tar.gz または zip ファイルで提供されており、 リリースページからダウンロードできます。

ソースからビルドする前に、以下のツールがインストールされていることを確認してください:

  • Rust 1.86 またはそれ以降: テスト済み環境は AIX 上の Rust 1.86 のみです。

    gcc/g++ 11.0.0 以降 ( Linux および AIX ): 環境変数 CC を に gccCXX を に設定してください g++

  • OpenSSL 開発パッケージ( Linux および AIX ):環境変数 OPENSSL_DIR および OPENSSL_LIB_DIR を、 OpenSSL のインストールディレクトリおよびライブラリディレクトリを指すように設定してください。

SDKをビルドするには、次のコードを実行します:

cargo build --release

木箱の使用

以下のいずれかの方法でクレートを使用できます:

  1. ファイル Cargo.toml 内のクレートパスを使用してください。例:
    [dependencies]
    <crate-name> = { path = "<path-to-the-root-of-source>" }
     
  2. 次の cargo install コマンドを使用して、ローカルにクレイトをインストールします:

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

opentelemetry-instana の例

folder opentelemetry-instana 内のサンプルは、 Instana OpenTelemetry エクスポーターを使用してトレースデータを Instana に送信する方法を示しています。 詳細については、を参照してください examples/README.md

IDOT の使用例( OpenTelemetry Collector の Instana ディストリビューション)

また、 OpenTelemetry Rust SDK を使用して、 IDOT 経由でトレースデータを送信する方法の例も掲載されています。 詳細については、 IDOT の「basic-otlp」 および IDOT の「basic-otlp-http」 を参照してください。

リリースノートに関する詳細情報は、 OpenTelemetry Rust client SDK releases を参照してください。