İçeriğe geç
AggregaAggrega
Dil seçin: Türkçe
Bu sayfa makine çevirisiyle çevrilmiştir. İngilizce orijinalini okuyun.

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

DosyaRol
aggregate.yamlDeveloper amacı: günlükleri yedi gün saklayan tek bir logging bileşeni (core/observability/loki).
manifest.yamlBileşen türünü Loki kaynaklı Recipe’e (loki) eşler.
release.yamlKubernetes 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ı sunan Service’ler ve bir ServiceAccount olarak 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_period değ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ı uses topolojisi ü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:

Terminal window
aggrega scaffold --example loki-logging

Ardından sırada çalıştırılacak komutları yazdırır. İlki yeni klasöre geçer:

Terminal window
cd loki-logging

Derleme

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:

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

Oluş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.