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

Tempo — Kubernetes 分散トレーシングサーバー

この例では、小規模ながら実際のスタックである Grafana Tempo 分散トレーシング サーバーを、Developer が作成した 1 つの Aggregate から、公式の grafana/tempo イメージ上での Workload 合成によって、シングルバイナリ構成で Kubernetes 向けにコンパイルします。

Tempo はトレースバックエンドです。OpenTelemetry プロトコル(および その他のトレーシング用ワイヤーフォーマット)でスパンを受信し、トレースオブジェクトストアに保存し、 HTTP API を介してトレース検索やサーチのクエリに応答します。シングルバイナリ構成では、 Tempo のすべてのサブシステム(distributor、ingester、querier、compactor)が、ローカルのトレースストアを 基盤とする 1 つのプロセス内で実行されるため、サーバー全体が 1 つのステートフルな ワークロードになります。計装されたアプリケーションは Tempo の OTLP レシーバーにスパンを送信し、 ダッシュボードサーバーはクエリ API を介してそれらを読み出します。

ファイル

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

示す内容

  • 単一のオーサリング面。 単一の Aggregate が、Tempo が何であるかについての信頼できる唯一の情報源であり、 Manifest はそれをどのように実現するかを示します。
  • シングルバイナリのトレースバックエンド。 合成された Recipe は Tempo を、レプリカごとのデータボリュームを持つ 1 つの StatefulSet、Tempo の設定を保持する 1 つの ConfigMap、そしてトレース レシーバーと HTTP クエリ API を公開する ClusterIP および Headless の Service としてレンダリングします。これは単一の自己完結したワークロードです。
  • Developer が設定する保持期間。 Developer の retention_period はプロセス内の compactor に渡され、compactor は保存されたトレースブロックがその期間を過ぎると削除します。
  • エクスポートされる取り込み契約。 コンポーネントは OTLP gRPC レシーバーのホストとポートを uses トポロジーを通じてエクスポートするため、トレースの生成元は そこに接続してスパンを送信できます。
  • 再現可能なイメージ。 Recipe は Tempo サーバーのイメージタグを infra.engine_version から固定するため、レンダリングされたワークロードは固定されたバージョンを参照します。

サンプルを生成する

このサンプルは以下のコマンドでビルドできます。または、AI アシスタントにビルドを任せることもできます。

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

Terminal window
aggrega scaffold --example tempo-tracing

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

Terminal window
cd tempo-tracing

ビルド

このワークスペースには .aggrega-config.yaml がないため、標準ライブラリのエンティティはハブレジストリ hub.aggrega.ai から解決され、カタログフラグは不要です。--auto-pull は、新しいクローンに欠けているロックファイルをビルド中に書き込みます。

Terminal window
aggrega build --release release.yaml --auto-pull

レンダリングされた成果物は dist/ 配下に出力されます。合成ターゲットでは外部の チャートの取得は不要です。Recipe が公式イメージを StatefulSet、 Service、データボリュームへ直接レンダリングします。

AI アシスタントを使う

Aggrega のツールでセットアップした AI アシスタントでも同じことができます。次のプロンプトを貼り付けてください。

Aggrega のツールのみを使用し、フォルダーは自分で作成しないでください。ワークスペースフォルダーにまだ `tempo-tracing` フォルダーがない場合は、`example` を `tempo-tracing` に設定し、`dir` を指定せずに `scaffold` ツールを 1 回呼び出してください。これにより、新しい `tempo-tracing` フォルダーに例が書き込まれます。次に、`workspace_root` を `tempo-tracing`、`release` を `release.yaml`、`auto_pull` を true、`write` を true に設定して `build` ツールを呼び出してください。ビルドが書き込んだファイルを教えてください。ファイルは `tempo-tracing/dist/` の下にあります。

レンダリングされるもの

ビルドは Tempo サーバーを 4 つの Kubernetes オブジェクトとして出力します:

  • StatefulSet:シングルバイナリの Tempo プロセスで、トレースストアは レプリカごとの永続ボリューム上に置かれます。
  • ConfigMap:Tempo の設定。
  • ClusterIP Service:OTLP gRPC レシーバーを 4317 で、OTLP HTTP レシーバーを 4318 で、HTTP クエリ API を 3200 で公開します。
  • Headless Service:StatefulSet の安定したネットワーク ID で、 同じポートを公開します。

Tempo のイメージタグは infra.engine_version から固定されるため、ワークロードは固定されたイメージタグを参照します。