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を にgcc、CXXを に設定してくださいg++。OpenSSL 開発パッケージ( Linux および AIX ):環境変数
OPENSSL_DIRおよびOPENSSL_LIB_DIRを、 OpenSSL のインストールディレクトリおよびライブラリディレクトリを指すように設定してください。
SDKをビルドするには、次のコードを実行します:
cargo build --release
木箱の使用
以下のいずれかの方法でクレートを使用できます:
- ファイル
Cargo.toml内のクレートパスを使用してください。例:[dependencies] <crate-name> = { path = "<path-to-the-root-of-source>" } 次の
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 を参照してください。