Loki — Server zur Log-Aggregation für Kubernetes
Dieses Beispiel kompiliert einen kleinen, realen Stack — einen Grafana Loki-Server zur Log-Aggregation — aus einem einzigen vom Entwickler verfassten Aggregate für Kubernetes, gestützt auf das offizielle Helm-Chart von Grafana Loki in seiner Single-Binary-Struktur.
Loki ist ein Log-Backend: Es empfängt Log-Streams über seine HTTP-Push-API, indiziert sie nach Label statt nach Volltextinhalt, speichert sie in einem Chunk-Objektspeicher und beantwortet Log-Abfragen und Bereichsanfragen über dieselbe HTTP-API. In der Single-Binary-Struktur läuft jedes Loki-Subsystem — Distributor, Ingester, Querier, Compactor — in einem Prozess, der von einem lokalen Chunk-Store gestützt wird, sodass der gesamte Server eine einzige zustandsbehaftete Arbeitslast ist. Ein Log-Shipper pusht Streams an Loki; ein Dashboard-Server liest sie über die Abfrage-API wieder aus.
Dateien
| Datei | Rolle |
|---|---|
aggregate.yaml | Entwicklerabsicht: eine einzelne Komponente logging (core/observability/loki), die Logs sieben Tage lang aufbewahrt. |
manifest.yaml | Bildet den Komponententyp auf das Loki-Recipe mit Quelle ab (loki). |
release.yaml | Dokument des Operators für das Kubernetes-Ziel: die Rechenressourcen des Servers und die Größe des Volumes für den Chunk-Store. |
Was es zeigt
- Eine Authoring-Oberfläche. Ein einziges Aggregate ist die maßgebliche Quelle dafür, was Loki ist; das Manifest sagt, wie es zu realisieren ist.
- Ein Single-Binary-Log-Backend. Das Recipe mit Quelle rendert Loki als ein
StatefulSetmit einem Daten-Volume, seine Konfiguration inConfigMaps,Services, die den HTTP-Endpunkt für Push und Abfrage freigeben, und einServiceAccount— eine einzige in sich geschlossene Arbeitslast, wobei die verteilten Skalierungspfade und die mitgelieferten Hilfsdienste ausgeschaltet bleiben. - Vom Entwickler festgelegte Aufbewahrung. Die
retention_perioddes Entwicklers fließt in den prozessinternen Compactor, der gespeicherte Log-Streams löscht, sobald sie älter als dieser Zeitraum sind. - Ein exportierter Ingestion-Vertrag. Die Komponente exportiert Host und Port ihres clusterinternen Dienstes über die Topologie
uses, sodass sich ein Log-Shipper mit ihr verbindet und dort Streams hinpusht. - Reproduzierbare Images. Das Recipe fixiert das Loki-Server-Image und das Image des Config-Reload-Sidecars auf auflösbare Tags, sodass die gerenderte Arbeitslast fixierte Versionen referenziert.
Das Beispiel generieren
Sie können dieses Beispiel mit den folgenden Befehlen bauen oder es von Ihrem KI-Assistenten für Sie bauen lassen.
Schreiben Sie das Beispiel in einen neuen Ordner, der nach ihm benannt ist:
aggrega scaffold --example loki-loggingDanach gibt er die als Nächstes auszuführenden Befehle aus. Der erste wechselt in den neuen Ordner:
cd loki-loggingBuild
Dieser Workspace enthält keine .aggrega-config.yaml, daher werden die Entitäten der Standardbibliothek aus der Hub-Registry hub.aggrega.ai aufgelöst, und es ist kein Katalog-Flag nötig:
aggrega pull --release release.yamlaggrega build --release release.yamlGerenderte Artefakte landen unter dist/. Der Build löst das Upstream-Chart per OCI-Referenz bei aggrega pull auf und fixiert es in einem Lockfile.
Mit einem KI-Assistenten
Ein KI-Assistent, der mit den Tools von Aggrega eingerichtet ist, kann dasselbe tun: Fügen Sie ihm diesen Prompt ein.
Verwenden Sie ausschließlich die Aggrega-Tools und legen Sie selbst keinen Ordner an. Wenn der Workspace-Ordner noch keinen Ordner `loki-logging` enthält, rufen Sie das Tool `scaffold` einmal mit `example` auf `loki-logging` gesetzt und ohne `dir` auf: Es schreibt das Beispiel in einen neuen Ordner `loki-logging`. Rufen Sie anschließend das Tool `build` mit `workspace_root` auf `loki-logging`, `release` auf `release.yaml`, `auto_pull` auf true und `write` auf true gesetzt auf. Nennen Sie mir, welche Dateien der Build geschrieben hat; sie liegen unter `loki-logging/dist/`.Was gerendert wird
Der Build gibt den Loki-Server als eine einzige in sich geschlossene Menge von Kubernetes-Objekten aus:
- ein
StatefulSet— der Single-Binary-Loki-Prozess, mit seinem Chunk-Store auf einem persistenten Volume, ConfigMaps — die Loki-Konfiguration und die Laufzeitkonfiguration,Services — die den HTTP-Endpunkt für Push und Abfrage auf Port 3100 freigeben,- ein
ServiceAccountfür die Arbeitslast, mit seinen Zugriffsbindungen.
Es werden keine verteilten Read-, Write- oder Backend-Arbeitslasten, kein Objektspeicher-Subchart, kein Cache und kein Operator gerendert — das Rendering ist eine einzige Loki-Arbeitslast. Die Images des Loki-Servers und des Config-Reload-Sidecars sind auf ihre Release-Tags fixiert, sodass die Arbeitslast fixierte Images referenziert.