計装ライブラリを使用する

アプリを開発する際、作業を加速するためにサードパーティのライブラリやフレームワークを使用することがあるでしょう。 OpenTelemetryを使用してアプリを計装する場合、使用するサードパーティのライブラリやフレームワークにトレース、ログ、メトリクスを手動で追加するために時間を費やすことを避けたいことがあります。

多くのライブラリやフレームワークはすでにOpenTelemetryをサポートしているか、OpenTelemetryの計装を介してサポートされているため、テレメトリーを生成してオブザーバビリティバックエンドにエクスポートできます。

サードパーティのライブラリやフレームワークを使用しているアプリやサービスを計装する場合は、このページの手順に従って、ネイティブに計装されたライブラリと依存関係の計装ライブラリの使用方法を学んでください。

ネイティブに計装されたライブラリを使用する

デフォルトでOpenTelemetryサポートが付属しているライブラリの場合、アプリにOpenTelemetry SDKを追加して設定することで、そのライブラリから発行されるトレース、メトリクス、ログを取得できます。

ライブラリによっては、計装のために追加の構成が必要な場合があります。 詳細はライブラリごとのドキュメントをご覧ください。

計装ライブラリを使用する

アプリを開発する際、作業を加速するためにサードパーティのライブラリやフレームワークを使用することがあるでしょう。 OpenTelemetry を使用してアプリを計装する場合、使用するサードパーティのライブラリやフレームワークにトレース、ログ、メトリクスを手動で追加するために追加の時間を費やすことを避けたいかもしれません。

多くのライブラリやフレームワークはすでに OpenTelemetry をサポートしているか、OpenTelemetry の計装を介してサポートされているため、オブザーバビリティバックエンドにエクスポートできるテレメトリーを生成できます。

サードパーティのライブラリやフレームワークを使用するアプリやサービスを計装する場合は、以下の手順に従って、ネイティブに計装されたライブラリと依存関係の計装ライブラリの使用方法を学んでください。

ネイティブに計装されたライブラリを使用する

デフォルトで OpenTelemetry サポートが付属しているライブラリの場合、アプリに OpenTelemetry SDK を追加して設定することで、そのライブラリから発行されるトレース、メトリクス、ログを取得できます。

ライブラリによっては、計装のために追加の設定が必要な場合があります。 詳細はそのライブラリのドキュメントをご覧ください。

ライブラリに OpenTelemetry サポートが含まれていない場合は、計装ライブラリを使用して、ライブラリやフレームワークのテレメトリーデータを生成できます。

セットアップ

計装ライブラリのセットアップについては、otel-cpp-contrib をご覧ください。

利用可能なパッケージ

利用可能な計装ライブラリの完全なリストは、OpenTelemetry レジストリで確認できます。

次のステップ

計装ライブラリをセットアップした後、カスタムテレメトリーデータを収集するために追加の計装を追加することをお勧めします。

また、テレメトリーデータをエクスポートして1つ以上のテレメトリーバックエンドに送信するために、適切なエクスポーターを設定することもできます。