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

Tempo — Server für verteiltes Tracing für Kubernetes

Dieses Beispiel kompiliert einen kleinen, realen Stack — einen Grafana Tempo-Server für verteiltes Tracing — aus einem einzigen vom Entwickler verfassten Aggregate für Kubernetes über die Workload-Synthese auf dem offiziellen Image grafana/tempo, in seiner Single-Binary-Form.

Tempo ist ein Trace-Backend: Es empfängt Spans über das OpenTelemetry-Protokoll (und andere Tracing-Übertragungsformate), speichert sie in einem Objektspeicher für Traces und beantwortet Trace-Abfragen und Suchanfragen über seine HTTP-API. In der Single-Binary-Form läuft jedes Tempo-Subsystem — Distributor, Ingester, Querier, Compactor — in einem einzigen Prozess, der von einem lokalen Trace-Store gestützt wird, sodass der gesamte Server eine einzige zustandsbehaftete Arbeitslast ist. Eine instrumentierte Anwendung pusht Spans an den OTLP-Receiver von Tempo; ein Dashboard-Server liest sie über die Abfrage-API wieder aus.

Dateien

DateiRolle
aggregate.yamlEntwicklerabsicht: eine einzelne Komponente tracing (core/observability/tempo), die Traces sieben Tage lang aufbewahrt.
manifest.yamlBildet den Komponententyp auf das synthetisierte Tempo-Recipe ab (tempo).
release.yamlDokument des Operators für das Kubernetes-Ziel: die Rechenressourcen des Servers und die Größe des Volumes für den Trace-Store.

Was es zeigt

  • Eine Authoring-Oberfläche. Ein einziges Aggregate ist die maßgebliche Quelle dafür, was Tempo ist; das Manifest sagt, wie es zu realisieren ist.
  • Ein Single-Binary-Trace-Backend. Das synthetisierte Recipe rendert Tempo als ein StatefulSet mit einem Daten-Volume pro Replica, eine ConfigMap mit der Tempo-Konfiguration sowie einen Service vom Typ ClusterIP und einen vom Typ Headless, die die Trace-Receiver und die HTTP-Abfrage-API freigeben — eine einzige in sich geschlossene Arbeitslast.
  • Vom Entwickler festgelegte Aufbewahrung. Die retention_period des Entwicklers fließt in den prozessinternen Compactor, der gespeicherte Trace-Blöcke löscht, sobald sie älter als dieser Zeitraum sind.
  • Ein exportierter Ingestion-Vertrag. Die Komponente exportiert Host und Port ihres OTLP-gRPC-Receivers über die Topologie uses, sodass sich ein Trace-Produzent mit ihr verbindet und dort Spans hinpusht.
  • Reproduzierbare Images. Das Recipe fixiert den Tag des Tempo-Server-Images aus infra.engine_version, sodass die gerenderte Arbeitslast eine fixierte Version 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 tempo-tracing

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

Terminal window
cd tempo-tracing

Build

Dieser Workspace enthält kein .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; --auto-pull schreibt während des Builds das Lockfile, das einem frischen Klon fehlt:

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

Gerenderte Artefakte landen unter dist/. Das synthetisierte Ziel benötigt keinen Abruf eines externen Charts — das Recipe rendert das offizielle Image direkt in ein StatefulSet, Services und ein Daten-Volume.

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-Werkzeuge und legen Sie selbst keinen Ordner an. Wenn der Ordner des Arbeitsbereichs noch keinen Ordner `tempo-tracing` enthält, rufen Sie das Werkzeug `scaffold` einmal auf, mit `example` auf `tempo-tracing` gesetzt und ohne `dir`: Es schreibt das Beispiel in einen neuen Ordner `tempo-tracing`. Rufen Sie dann das Werkzeug `build` auf, mit `workspace_root` auf `tempo-tracing`, `release` auf `release.yaml`, `auto_pull` auf true und `write` auf true gesetzt. Nennen Sie mir die Dateien, die der Build geschrieben hat; sie liegen unter `tempo-tracing/dist/`.

Was gerendert wird

Der Build gibt den Tempo-Server als vier Kubernetes-Objekte aus:

  • ein StatefulSet — der Single-Binary-Tempo-Prozess, mit seinem Trace-Store auf einem persistenten Volume pro Replica,
  • eine ConfigMap — die Tempo-Konfiguration,
  • ein ClusterIP Service — der den OTLP-gRPC-Receiver auf 4317, den OTLP-HTTP-Receiver auf 4318 und die HTTP-Abfrage-API auf 3200 freigibt,
  • ein Headless Service — die stabile Netzwerkidentität des StatefulSet, die dieselben Ports freigibt.

Der Tag des Tempo-Images wird aus infra.engine_version fixiert, sodass die Arbeitslast einen fixierten Image-Tag referenziert.