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.yaml | Developer の意図:トレースを 7 日間保持する単一の tracing コンポーネント(core/observability/tempo)。 |
manifest.yaml | コンポーネントタイプを、合成された Tempo の Recipe(tempo)にマッピングします。 |
release.yaml | Kubernetes ターゲット向けのオペレーターレコード:サーバーのコンピュートとトレースストアのボリュームサイズ。 |
示す内容
- 単一のオーサリング面。 単一の 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 アシスタントにビルドを任せることもできます。
例の名前を付けた新しいフォルダーに例を書き出します。
aggrega scaffold --example tempo-tracingその後、次に実行するコマンドを表示します。最初のコマンドは新しいフォルダーに移動します。
cd tempo-tracingビルド
このワークスペースには .aggrega-config.yaml がないため、標準ライブラリのエンティティはハブレジストリ hub.aggrega.ai から解決され、カタログフラグは不要です。--auto-pull は、新しいクローンに欠けているロックファイルをビルド中に書き込みます。
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 から固定されるため、ワークロードは固定されたイメージタグを参照します。