第12章 移行
非推奨の Red Hat OpenShift Distributed Tracing Platform (Jaeger) 3.5 は、Red Hat がサポートする Red Hat OpenShift Distributed Tracing Platform (Jaeger)の最後のリリースです。
非推奨の Red Hat OpenShift Distributed Tracing Platform (Jaeger) 3.5 のサポートとメンテナンスはすべて 2025 年 11 月 3 日に終了しました。
Red Hat OpenShift Distributed Tracing Platform (Jaeger)を依然として使用する場合は、分散トレースコレクションおよびストレージ用に Red Hat build of OpenTelemetry Operator および Tempo Operator に移行する必要があります。詳細は、Red Hat build of OpenTelemetry ドキュメントのMigrating"、Red Hat build of OpenTelemetry ドキュメントの Installing、および Red Hat OpenShift Distributed Tracing Platform ドキュメントの Installing を参照してください。
詳細は、Red Hat ナレッジベースソリューション Jaeger Deprecation and Removal in OpenShift を参照してください。
アプリケーション用に Red Hat OpenShift Distributed Tracing Platform (Jaeger)をすでに使用している場合は、OpenTelemetry オープンソースプロジェクトに基づく Red Hat build of OpenTelemetry に移行できます。
Red Hat build of OpenTelemetry は、分散システムの可観測性実現に役立つ一連の API、ライブラリー、エージェント、および計装を提供します。Red Hat build of OpenTelemetry に含まれる OpenTelemetry Collector は、Jaeger プロトコルを取り込めるため、アプリケーションの SDK を変更する必要はありません。
Distributed Tracing Platform (Jaeger) から Red Hat build of OpenTelemetry に移行するには、トレースをシームレスに報告できるように、OpenTelemetry Collector とアプリケーションを設定する必要があります。サイドカーおよびサイドカーレスデプロイメントを移行できます。
12.1. サイドカーを使用した移行 リンクのコピーリンクがクリップボードにコピーされました!
Red Hat build of OpenTelemetry Operator は、デプロイメントワークロードへのサイドカー注入をサポートしています。そのため、Distributed Tracing Platform (Jaeger) サイドカーから Red Hat build of OpenTelemetry サイドカーに移行できます。
前提条件
- Red Hat OpenShift Distributed Tracing Platform (Jaeger)がクラスターで使用されます。
- Red Hat build of OpenTelemetry がインストールされている。
手順
OpenTelemetry Collector をサイドカーとして設定します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- このエンドポイントは、
<example>Tempo Operator を使用してデプロイされた TempoStack インスタンスのゲートウェイを指します。
アプリケーションを実行するためのサービスアカウントを作成します。
apiVersion: v1 kind: ServiceAccount metadata: name: otel-collector-sidecar
apiVersion: v1 kind: ServiceAccount metadata: name: otel-collector-sidecarCopy to Clipboard Copied! Toggle word wrap Toggle overflow 一部のプロセッサーで必要な権限のためのクラスターロールを作成します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
resourcedetectionprocessorには、インフラストラクチャーとインフラストラクチャー/ステータスに対する権限が必要です。
ClusterRoleBindingを作成して、サービスアカウントの権限を設定します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow - OpenTelemetry Collector をサイドカーとしてデプロイします。
-
Deploymentオブジェクトから"sidecar.jaegertracing.io/inject": "true"アノテーションを削除することで、注入された Jaeger Agent をアプリケーションから削除します。 -
sidecar.opentelemetry.io/inject: "true"アノテーションをDeploymentオブジェクトの.spec.template.metadata.annotationsフィールドに追加して、OpenTelemetry サイドカーの自動注入を有効にします。 - 作成したサービスアカウントをアプリケーションのデプロイメントに使用します。そうすることで、プロセッサーは正しい情報を取得してトレースに追加できます。