Jaeger — backend tracing node tunggal Kubernetes
Contoh ini mengompilasi sebuah stack kecil yang nyata — backend distributed tracing Jaeger dalam bentuk node tunggalnya — dari satu Aggregate yang ditulis oleh Developer ke
Kubernetes, disintesis langsung dari image Jaeger resmi tanpa
chart upstream.
Jaeger adalah backend trace: ia menerima span melalui protokol OpenTelemetry, menyimpannya dalam penyimpanan key-value tertanam lokal, dan menjawab kueri pencarian trace dan kueri pencarian melalui UI kuerinya. Dalam bentuk node tunggal, receiver OTLP, penulis penyimpanan, dan layanan kueri semuanya berjalan di dalam satu proses yang didukung oleh penyimpanan lokal di disk, sehingga seluruh server merupakan satu workload stateful. Aplikasi yang diinstrumentasi mengirimkan span ke receiver OTLP Jaeger; seorang operator membacanya kembali dari UI.
Berkas
| Berkas | Peran |
|---|---|
aggregate.yaml | Intent Developer: satu komponen tracing (core/observability/jaeger). |
manifest.yaml | Memetakan tipe komponen ke Recipe sintesis Jaeger (jaeger). |
release.yaml | Catatan operator untuk target Kubernetes: komputasi server dan ukuran volume penyimpanan trace. |
Apa yang didemonstrasikan
- Satu permukaan penulisan. Satu Aggregate menjadi sumber kebenaran tentang apa Jaeger itu; Manifest menyatakan bagaimana mewujudkannya.
- Backend trace node tunggal. Recipe sintesis me-render Jaeger sebagai satu
StatefulSetdengan volume data, satuConfigMapyang membawa konfigurasi Jaeger v2, dan dua objekService— sebuahClusterIPyang mengekspos receiver dan UI, serta Service governing headless untuk StatefulSet. - Konfigurasi dikirim sebagai file. Jaeger v2 adalah distribusi OpenTelemetry Collector
yang dikonfigurasi oleh file YAML. Recipe mengeluarkan konfigurasi tersebut sebagai
ConfigMapdan me-mount-nya ke dalam container di/etc/jaeger, dan container membacanya dengan--config /etc/jaeger/config.yaml. - Trace persisten. Penyimpanan key-value tertanam menulis ke volume persisten
di
/badger, sehingga data trace tetap ada setelah restart. - 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 image server Jaeger ke tag yang dapat di-resolve sehingga workload yang di-render 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 jaeger-tracingKemudian ia mencetak perintah yang dijalankan berikutnya. Perintah pertama berpindah ke folder baru:
cd jaeger-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:
aggrega pull --release release.yamlaggrega build --release release.yamlArtefak yang dirender ditempatkan di bawah dist/. Target Kubernetes merender manifest
biasa secara offline — tidak diperlukan penarikan chart.
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 `jaeger-tracing`, panggil alat `scaffold` sekali dengan `example` diatur ke `jaeger-tracing` dan tanpa `dir`: alat ini menulis contoh ke folder `jaeger-tracing` yang baru. Kemudian panggil alat `build` dengan `workspace_root` diatur ke `jaeger-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 `jaeger-tracing/dist/`.Apa yang dirender
Build mengeluarkan server Jaeger sebagai empat objek Kubernetes:
- sebuah
StatefulSet— proses Jaeger node tunggal, dengan penyimpanan trace tertanamnya pada volume persisten yang di-mount di/badgerdan konfigurasi yang di-mount di/etc/jaeger, - sebuah
ConfigMap— konfigurasi Jaeger v2 (receiver OTLP, batch processor, dan penyimpanan key-value tertanam yang menulis ke/badger/keydan/badger/data), - sebuah
ClusterIPService— mengekspos receiver OTLP gRPC pada 4317, receiver OTLP HTTP pada 4318, dan UI kueri pada 16686, - sebuah
Serviceheadless — Service governing yang diperlukan StatefulSet untuk identitas per replika yang stabil.
Image Jaeger disematkan ke tag rilisnya, sehingga workload merujuk ke tag image yang disematkan.