Tempo — server distributed tracing Kubernetes
Contoh ini mengompilasi sebuah stack kecil yang nyata — server distributed tracing Grafana Tempo —
dari satu Aggregate yang ditulis oleh Developer ke Kubernetes melalui sintesis Workload
pada image resmi grafana/tempo, dalam bentuk single-binary.
Tempo adalah backend trace: Tempo menerima span melalui protokol OpenTelemetry (dan format wire tracing lainnya), menyimpannya dalam object store trace, dan menjawab kueri pencarian trace dan pencarian melalui API HTTP-nya. Dalam bentuk single-binary, setiap subsistem Tempo — distributor, ingester, querier, compactor — berjalan di dalam satu proses yang didukung oleh trace store lokal, sehingga seluruh server adalah satu workload stateful. Aplikasi yang diinstrumentasi mengirimkan span ke receiver OTLP Tempo; server dasbor membacanya kembali melalui API kueri.
Berkas
| Berkas | Peran |
|---|---|
aggregate.yaml | Intent Developer: satu komponen tracing (core/observability/tempo) yang menyimpan trace selama tujuh hari. |
manifest.yaml | Memetakan tipe komponen ke Recipe Tempo hasil sintesis (tempo). |
release.yaml | Catatan operator untuk target Kubernetes: komputasi server dan ukuran volume penyimpanan trace. |
Apa yang didemonstrasikan
- Satu permukaan penulisan. Satu Aggregate adalah sumber kebenaran untuk apa Tempo itu; Manifest menyatakan bagaimana mewujudkannya.
- Backend trace single-binary. Recipe hasil sintesis merender Tempo sebagai satu
StatefulSetdengan volume data per replika, satuConfigMapyang membawa konfigurasi Tempo, sertaServiceClusterIPdanHeadlessyang mengekspos receiver trace dan API kueri HTTP — satu workload yang mandiri. - Retensi yang ditetapkan developer.
retention_periodmilik developer diteruskan ke compactor dalam proses, yang menghapus blok trace tersimpan setelah usianya melewati batas tersebut. - Kontrak ingesti yang diekspor. Komponen mengekspor host dan port receiver OTLP gRPC-nya
melalui topologi
uses, sehingga produsen trace terhubung dengannya dan mengirimkan span ke sana. - Image yang dapat direproduksi. Recipe menyematkan tag image server Tempo dari
infra.engine_versionsehingga workload yang dirender merujuk ke versi yang disematkan.
Membuat contoh
Anda dapat mem-build contoh ini dengan perintah di bawah, atau meminta asisten AI Anda mem-build-nya untuk Anda.
Tulis contoh ke folder baru yang dinamai sesuai contoh itu:
aggrega scaffold --example tempo-tracingKemudian ia mencetak perintah yang dijalankan berikutnya. Perintah pertama berpindah ke folder baru:
cd tempo-tracingBuild
Workspace ini tidak memuat .aggrega-config.yaml, sehingga entitas pustaka standar di-resolve dari registry hub, hub.aggrega.ai, dan flag katalog tidak diperlukan; --auto-pull menulis lockfile yang tidak dimiliki clone baru selama build:
aggrega build --release release.yaml --auto-pullArtefak yang dirender ditempatkan di bawah dist/. Target hasil sintesis tidak memerlukan
pengambilan chart eksternal — Recipe merender image resmi langsung menjadi StatefulSet,
Service, dan volume data.
Dengan asisten AI
Asisten AI yang disiapkan dengan tool Aggrega dapat melakukan hal yang sama: tempelkan prompt ini ke asisten tersebut.
Gunakan hanya alat Aggrega, dan jangan membuat folder sendiri. Jika folder ruang kerja belum berisi folder `tempo-tracing`, panggil alat `scaffold` sekali dengan `example` diatur ke `tempo-tracing` dan tanpa `dir`: alat ini menulis contoh ke folder `tempo-tracing` yang baru. Lalu panggil alat `build` dengan `workspace_root` diatur ke `tempo-tracing`, `release` diatur ke `release.yaml`, `auto_pull` diatur ke true, dan `write` diatur ke true. Beri tahu saya file mana yang ditulis oleh build; file tersebut berada di bawah `tempo-tracing/dist/`.Apa yang dirender
Build menghasilkan server Tempo sebagai empat objek Kubernetes:
- sebuah
StatefulSet— proses Tempo single-binary, dengan trace store-nya pada volume persisten per replika, - sebuah
ConfigMap— konfigurasi Tempo, - sebuah
ClusterIP Service— mengekspos receiver OTLP gRPC pada 4317, receiver OTLP HTTP pada 4318, dan API kueri HTTP pada 3200, - sebuah
Headless Service— identitas jaringan stabil milik StatefulSet, yang mengekspos port yang sama.
Tag image Tempo disematkan dari infra.engine_version, sehingga workload merujuk ke tag image yang disematkan.