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

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

BerkasPeran
aggregate.yamlIntent Developer: satu komponen tracing (core/observability/tempo) yang menyimpan trace selama tujuh hari.
manifest.yamlMemetakan tipe komponen ke Recipe Tempo hasil sintesis (tempo).
release.yamlCatatan 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 StatefulSet dengan volume data per replika, satu ConfigMap yang membawa konfigurasi Tempo, serta Service ClusterIP dan Headless yang mengekspos receiver trace dan API kueri HTTP — satu workload yang mandiri.
  • Retensi yang ditetapkan developer. retention_period milik 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_version sehingga 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:

Terminal window
aggrega scaffold --example tempo-tracing

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

Terminal window
cd tempo-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; --auto-pull menulis lockfile yang tidak dimiliki clone baru selama build:

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

Artefak 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.