コンテンツにスキップ
AggregaAggrega
言語の選択: 日本語
このページは機械翻訳されています。英語の原文を読む。

Jaeger — Kubernetes シングルノードのトレーシングバックエンド

この例では、小規模ながら実用的なスタック(シングルノード構成の Jaeger 分散トレーシング バックエンド)を、Developer が記述した 1 つの Aggregate から Kubernetes 向けにコンパイルします。アップストリームのチャートは使わず、公式 Jaeger イメージから直接合成します。

Jaeger はトレースバックエンドです。OpenTelemetry プロトコルでスパンを受信し、 ローカルの組み込みキーバリューストアに保存し、クエリ UI を通じてトレース検索や 検索クエリに応答します。シングルノード構成では、OTLP レシーバー、 ストレージライター、クエリサービスがすべて、ローカルのディスク上ストアを 持つ 1 つのプロセス内で動作するため、サーバー全体が 1 つのステートフルなワークロードになります。 計装されたアプリケーションは Jaeger の OTLP レシーバーにスパンを送信し、オペレーターは UI からそれを読み取ります。

ファイル

ファイル役割
aggregate.yamlDeveloper の意図:単一の tracing コンポーネント(core/observability/jaeger)。
manifest.yamlコンポーネントタイプを Jaeger 合成 Recipe(jaeger)にマッピングします。
release.yamlKubernetes ターゲット向けのオペレーターレコード:サーバーのコンピュートとトレースストアのボリュームサイズ。

示す内容

  • 単一のオーサリング面。 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 アシスタントにビルドを任せることもできます。

例の名前を付けた新しいフォルダーに例を書き出します。

Terminal window
aggrega scaffold --example jaeger-tracing

その後、次に実行するコマンドを表示します。最初のコマンドは新しいフォルダーに移動します。

Terminal window
cd jaeger-tracing

ビルド

このワークスペースには .aggrega-config.yaml がないため、標準ライブラリのエンティティはハブレジストリ hub.aggrega.ai から解決され、カタログフラグは不要です。

Terminal window
aggrega pull --release release.yaml
aggrega 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 イメージはリリースタグに固定されているため、ワークロードは固定されたイメージタグを参照します。