Loki — server agregasi log Kubernetes
Contoh ini mengompilasi sebuah stack kecil yang nyata — sebuah server agregasi log Grafana Loki —
dari satu Aggregate yang ditulis oleh Developer ke Kubernetes, didukung oleh
Helm chart resmi Grafana Loki dalam bentuk single-binary-nya.
Loki adalah backend log: ia menerima aliran log melalui API push HTTP-nya, mengindeksnya berdasarkan label alih-alih berdasarkan konten teks lengkap, menyimpannya dalam penyimpanan objek chunk, dan menjawab permintaan kueri log dan rentang melalui API HTTP yang sama. Dalam bentuk single-binary, setiap subsistem Loki — distributor, ingester, querier, compactor — berjalan di dalam satu proses yang didukung oleh penyimpanan chunk lokal, sehingga seluruh server merupakan satu workload stateful. Pengirim log mendorong aliran ke Loki; server dasbor membacanya kembali melalui API kueri.
Berkas
| Berkas | Peran |
|---|---|
aggregate.yaml | Intent Developer: satu komponen logging (core/observability/loki) yang menyimpan log selama tujuh hari. |
manifest.yaml | Memetakan tipe komponen ke Recipe Loki yang bersumber dari luar (loki). |
release.yaml | Catatan operator untuk target Kubernetes: komputasi server dan ukuran volume penyimpanan chunk. |
Apa yang didemonstrasikan
- Satu permukaan penulisan. Satu Aggregate adalah sumber kebenaran tentang apa itu Loki; Manifest menyatakan bagaimana mewujudkannya.
- Backend log single-binary. Recipe yang bersumber dari luar merender Loki sebagai satu
StatefulSetdengan volume data, konfigurasinya dalam beberapaConfigMap, beberapaServiceyang mengekspos endpoint push-dan-kueri HTTP, serta sebuahServiceAccount— satu workload mandiri, dengan jalur penskalaan terdistribusi dan layanan tambahan bawaan dinonaktifkan. - Retensi yang ditetapkan developer.
retention_perioddari developer diteruskan ke compactor dalam proses, yang menghapus aliran log tersimpan setelah usianya melewati batas tersebut. - Kontrak ingesti yang diekspor. Komponen mengekspor host dan port layanan
dalam klusternya melalui topologi
uses, sehingga pengirim log terhubung ke sana dan mendorong aliran ke sana. - Image yang dapat direproduksi. Recipe mematok image server Loki dan image sidecar config-reload ke tag yang dapat di-resolve sehingga workload yang dirender merujuk ke versi yang dipatok.
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 loki-loggingKemudian ia mencetak perintah yang dijalankan berikutnya. Perintah pertama berpindah ke folder baru:
cd loki-loggingBuild
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/. Build me-resolve chart upstream melalui
referensi OCI saat aggrega pull dan mem-pin-nya dalam sebuah lockfile.
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 `loki-logging`, panggil alat `scaffold` sekali dengan `example` diatur ke `loki-logging` dan tanpa `dir`: alat ini menulis contoh ke folder `loki-logging` yang baru. Kemudian panggil alat `build` dengan `workspace_root` diatur ke `loki-logging`, `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 `loki-logging/dist/`.Apa yang dirender
Build menghasilkan server Loki sebagai satu set objek Kubernetes yang mandiri:
- sebuah
StatefulSet— proses Loki single-binary, dengan penyimpanan chunk-nya pada volume persisten, - beberapa
ConfigMap— konfigurasi Loki dan konfigurasi runtime, - beberapa
Service— mengekspos endpoint push-dan-kueri HTTP pada port 3100, - sebuah
ServiceAccountuntuk workload, beserta binding aksesnya.
Tidak ada workload read/write/backend terdistribusi, subchart penyimpanan objek, cache, maupun operator yang dirender — hasil render adalah satu workload Loki. Image server Loki dan sidecar config-reload dipatok ke tag rilisnya, sehingga workload merujuk ke image yang dipatok.