Zum Inhalt springen
AggregaAggrega
Sprache wählen: Deutsch
Diese Seite wurde maschinell übersetzt. Das englische Original lesen.

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

DateiRolle
aggregate.yamlEntwicklerabsicht: eine einzelne Komponente logging (core/observability/loki), die Logs sieben Tage lang aufbewahrt.
manifest.yamlBildet den Komponententyp auf das Loki-Recipe mit Quelle ab (loki).
release.yamlDokument 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 StatefulSet mit einem Daten-Volume, seine Konfiguration in ConfigMaps, Services, die den HTTP-Endpunkt für Push und Abfrage freigeben, und ein ServiceAccount — eine einzige in sich geschlossene Arbeitslast, wobei die verteilten Skalierungspfade und die mitgelieferten Hilfsdienste ausgeschaltet bleiben.
  • Vom Entwickler festgelegte Aufbewahrung. Die retention_period des 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:

Terminal window
aggrega scaffold --example loki-logging

Danach gibt er die als Nächstes auszuführenden Befehle aus. Der erste wechselt in den neuen Ordner:

Terminal window
cd loki-logging

Build

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:

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

Gerenderte 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 ServiceAccount fü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.