Jaeger — Kubernetes シングルノードのトレーシングバックエンド
この例では、小規模ながら実用的なスタック(シングルノード構成の Jaeger 分散トレーシング
バックエンド)を、Developer が記述した 1 つの Aggregate から
Kubernetes 向けにコンパイルします。アップストリームのチャートは使わず、公式 Jaeger イメージから直接合成します。
Jaeger はトレースバックエンドです。OpenTelemetry プロトコルでスパンを受信し、 ローカルの組み込みキーバリューストアに保存し、クエリ UI を通じてトレース検索や 検索クエリに応答します。シングルノード構成では、OTLP レシーバー、 ストレージライター、クエリサービスがすべて、ローカルのディスク上ストアを 持つ 1 つのプロセス内で動作するため、サーバー全体が 1 つのステートフルなワークロードになります。 計装されたアプリケーションは Jaeger の OTLP レシーバーにスパンを送信し、オペレーターは UI からそれを読み取ります。
ファイル
| ファイル | 役割 |
|---|---|
aggregate.yaml | Developer の意図:単一の tracing コンポーネント(core/observability/jaeger)。 |
manifest.yaml | コンポーネントタイプを Jaeger 合成 Recipe(jaeger)にマッピングします。 |
release.yaml | Kubernetes ターゲット向けのオペレーターレコード:サーバーのコンピュートとトレースストアのボリュームサイズ。 |
示す内容
- 単一のオーサリング面。 1 つの Aggregate が、Jaeger が何であるかの 信頼できる唯一の情報源であり、Manifest はそれをどのように実現するかを記述します。
- シングルノードのトレースバックエンド。 合成 Recipe は Jaeger を、データボリュームを持つ 1 つの
StatefulSet、Jaeger v2 の設定を保持する 1 つのConfigMap、 そして 2 つのServiceオブジェクト(レシーバーと UI を公開するClusterIP、 および StatefulSet 用のヘッドレスな管理 Service)としてレンダリングします。 - ファイルとして提供される設定。 Jaeger v2 は、YAML ファイルで設定される OpenTelemetry Collector の
ディストリビューションです。Recipe はその設定を
ConfigMapとして出力し、コンテナの/etc/jaegerにマウントします。 コンテナは--config /etc/jaeger/config.yamlでそれを読み込みます。 - 永続的なトレース。 組み込みキーバリューストアは
/badgerの永続 ボリュームに書き込むため、トレースデータは再起動後も保持されます。 - エクスポートされる取り込み契約。 コンポーネントは OTLP gRPC
レシーバーのホストとポートを
usesトポロジーを通じてエクスポートするため、トレースの生成元は そこに接続してスパンを送信できます。 - 再現可能なイメージ。 Recipe は Jaeger サーバーイメージを解決可能なタグに固定するため、レンダリングされたワークロードは固定されたバージョンを参照します。
サンプルを生成する
このサンプルは以下のコマンドでビルドできます。または、AI アシスタントにビルドを任せることもできます。
例の名前を付けた新しいフォルダーに例を書き出します。
aggrega scaffold --example jaeger-tracingその後、次に実行するコマンドを表示します。最初のコマンドは新しいフォルダーに移動します。
cd jaeger-tracingビルド
このワークスペースには .aggrega-config.yaml がないため、標準ライブラリのエンティティはハブレジストリ hub.aggrega.ai から解決され、カタログフラグは不要です。
aggrega pull --release release.yamlaggrega build --release release.yamlレンダリングされた成果物は dist/ 以下に出力されます。Kubernetes ターゲットはオフラインで
プレーンなマニフェストをレンダリングするため、チャートのプルは不要です。
AI アシスタントを使う
Aggrega のツールでセットアップした AI アシスタントでも同じことができます。次のプロンプトを貼り付けてください。
Aggrega のツールだけを使い、フォルダーは自分で作成しないでください。ワークスペースフォルダーにまだ `jaeger-tracing` フォルダーがない場合は、`example` を `jaeger-tracing` に設定し、`dir` を指定せずに `scaffold` ツールを一度呼び出してください。これにより、例が新しい `jaeger-tracing` フォルダーに書き込まれます。次に、`workspace_root` を `jaeger-tracing`、`release` を `release.yaml`、`auto_pull` を true、`write` を true に設定して `build` ツールを呼び出してください。ビルドが書き込んだファイルを教えてください。ファイルは `jaeger-tracing/dist/` の下にあります。レンダリングされるもの
ビルドは Jaeger サーバーを 4 つの Kubernetes オブジェクトとして出力します:
StatefulSet:シングルノードの Jaeger プロセス。組み込みトレース ストアは/badgerにマウントされた永続ボリューム上にあり、設定は/etc/jaegerにマウントされます。ConfigMap:Jaeger v2 の設定(OTLP レシーバー、バッチ プロセッサー、および/badger/keyと/badger/dataに書き込む組み込みキーバリューストア)。ClusterIPのService:OTLP gRPC レシーバーを 4317 で、OTLP HTTP レシーバーを 4318 で、クエリ UI を 16686 で公開します。- ヘッドレスな
Service:StatefulSet がレプリカごとの安定した ID のために 必要とする管理 Service です。
Jaeger イメージはリリースタグに固定されているため、ワークロードは固定されたイメージタグを参照します。