Loki — Kubernetes günlük toplama sunucusu
Bu örnek, küçük ama gerçek bir yığını — bir Grafana Loki günlük toplama
sunucusunu — Developer tarafından yazılmış tek bir Aggregate’ten Kubernetes’e derler ve
tek ikili (single-binary) biçimindeki resmi Grafana Loki Helm chart’ına dayanır.
Loki bir günlük arka ucudur: HTTP push API’si üzerinden günlük akışlarını alır, bunları tam metin içeriğine göre değil etikete göre dizinler, bir chunk nesne deposunda saklar ve günlük sorgusu ile aralık isteklerini aynı HTTP API üzerinden yanıtlar. Tek ikili biçiminde her Loki alt sistemi — distributor, ingester, querier, compactor — yerel bir chunk deposuna dayanan tek bir süreç içinde çalışır; böylece sunucunun tamamı durum bilgili tek bir iş yüküdür. Bir günlük gönderici akışları Loki’ye iter; bir pano sunucusu bunları sorgu API’si üzerinden geri okur.
Dosyalar
| Dosya | Rol |
|---|---|
aggregate.yaml | Developer amacı: günlükleri yedi gün saklayan tek bir logging bileşeni (core/observability/loki). |
manifest.yaml | Bileşen türünü Loki kaynaklı Recipe’e (loki) eşler. |
release.yaml | Kubernetes hedefi için operatör kaydı: sunucu hesaplama kaynakları ve chunk deposu birim boyutu. |
Neyi gösteriyor
- Tek bir yazım yüzeyi. Loki’nin ne olduğunun tek doğruluk kaynağı tek bir Aggregate’tir; Manifest ise onun nasıl gerçekleştirileceğini söyler.
- Tek ikili bir günlük arka ucu. Kaynaklı Recipe, Loki’yi bir veri birimine sahip tek bir
StatefulSet,ConfigMap’lerdeki yapılandırması, HTTP push ve sorgu uç noktasını sunanService’ler ve birServiceAccountolarak oluşturur — dağıtık ölçekleme yolları ve birlikte gelen yardımcı hizmetler devre dışı bırakılmış, kendi içinde bütün tek bir iş yükü. - Geliştirici tarafından ayarlanan saklama süresi. Geliştiricinin
retention_perioddeğeri süreç içi compactor’a aktarılır; compactor, saklanan günlük akışlarını bu süreyi aştıklarında siler. - Dışa aktarılan bir alım sözleşmesi. Bileşen, küme içi hizmet ana bilgisayarını
ve bağlantı noktasını
usestopolojisi üzerinden dışa aktarır; böylece bir günlük gönderici ona bağlanır ve akışları oraya iter. - Yeniden üretilebilir imajlar. Recipe, Loki sunucu imajını ve config-reload sidecar imajını çözümlenebilir etiketlere sabitler; böylece oluşturulan iş yükü sabitlenmiş sürümlere başvurur.
Örneği oluşturun
Bu örneği aşağıdaki komutlarla derleyebilir ya da yapay zekâ asistanınıza sizin için derletebilirsiniz.
Örneği, adını taşıyan yeni bir klasöre yazın:
aggrega scaffold --example loki-loggingArdından sırada çalıştırılacak komutları yazdırır. İlki yeni klasöre geçer:
cd loki-loggingDerleme
Bu çalışma alanında .aggrega-config.yaml bulunmaz; bu nedenle standart kütüphane varlıkları hub kayıt defteri hub.aggrega.ai üzerinden çözümlenir ve katalog bayrağına gerek yoktur:
aggrega pull --release release.yamlaggrega build --release release.yamlOluşturulan yapıtlar dist/ altına yerleşir. Derleme, upstream chart’ı
aggrega pull sırasında OCI başvurusuyla çözümler ve bir kilit dosyasına sabitler.
Bir yapay zekâ asistanıyla
Aggrega araçlarıyla kurulmuş bir yapay zekâ asistanı da aynısını yapabilir: bu istemi ona yapıştırın.
Yalnızca Aggrega araçlarını kullanın ve kendiniz klasör oluşturmayın. Çalışma alanı klasöründe henüz `loki-logging` klasörü yoksa `scaffold` aracını `example` değeri `loki-logging` olacak şekilde ve `dir` olmadan bir kez çağırın: araç örneği yeni bir `loki-logging` klasörüne yazar. Ardından `build` aracını `workspace_root` değeri `loki-logging`, `release` değeri `release.yaml`, `auto_pull` değeri true ve `write` değeri true olacak şekilde çağırın. Derlemenin hangi dosyaları yazdığını bana söyleyin; dosyalar `loki-logging/dist/` altındadır.Neler oluşturulur
Derleme, Loki sunucusunu kendi içinde bütün tek bir Kubernetes nesneleri kümesi olarak üretir:
- bir
StatefulSet— chunk deposu kalıcı bir birimde bulunan tek ikili Loki süreci, ConfigMap’ler — Loki yapılandırması ve çalışma zamanı yapılandırması,Service’ler — HTTP push ve sorgu uç noktasını 3100 numaralı bağlantı noktasında sunar,- iş yükü için erişim bağlamalarıyla birlikte bir
ServiceAccount.
Dağıtık read/write/backend iş yükleri, nesne deposu alt chart’ı, önbellek veya operatör oluşturulmaz — çıktı tek bir Loki iş yüküdür. Loki sunucusu ve config-reload sidecar imajları sürüm etiketlerine sabitlenmiştir; böylece iş yükü sabitlenmiş imajlara başvurur.