Lewati ke konten
AggregaAggrega
Pilih Bahasa: Bahasa Indonesia
Halaman ini diterjemahkan oleh mesin. Baca versi asli dalam bahasa Inggris.

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

BerkasPeran
aggregate.yamlIntent Developer: satu komponen tracing (core/observability/jaeger).
manifest.yamlMemetakan tipe komponen ke Recipe sintesis Jaeger (jaeger).
release.yamlCatatan 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 StatefulSet dengan volume data, satu ConfigMap yang membawa konfigurasi Jaeger v2, dan dua objek Service — sebuah ClusterIP yang 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 ConfigMap dan 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:

Terminal window
aggrega scaffold --example jaeger-tracing

Kemudian ia mencetak perintah yang dijalankan berikutnya. Perintah pertama berpindah ke folder baru:

Terminal window
cd jaeger-tracing

Build

Workspace ini tidak memuat .aggrega-config.yaml, sehingga entitas pustaka standar di-resolve dari registry hub, hub.aggrega.ai, dan flag katalog tidak diperlukan:

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

Artefak 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 /badger dan 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/key dan /badger/data),
  • sebuah ClusterIP Service — mengekspos receiver OTLP gRPC pada 4317, receiver OTLP HTTP pada 4318, dan UI kueri pada 16686,
  • sebuah Service headless — 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.