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
| Datei | Rolle |
|---|---|
aggregate.yaml | Entwicklerabsicht: eine einzelne Komponente tracing (core/observability/tempo), die Traces sieben Tage lang aufbewahrt. |
manifest.yaml | Bildet den Komponententyp auf das synthetisierte Tempo-Recipe ab (tempo). |
release.yaml | Dokument 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
StatefulSetmit einem Daten-Volume pro Replica, eineConfigMapmit der Tempo-Konfiguration sowie einenServicevom TypClusterIPund einen vom TypHeadless, die die Trace-Receiver und die HTTP-Abfrage-API freigeben — eine einzige in sich geschlossene Arbeitslast. - Vom Entwickler festgelegte Aufbewahrung. Die
retention_perioddes 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:
aggrega scaffold --example tempo-tracingDanach gibt er die als Nächstes auszuführenden Befehle aus. Der erste wechselt in den neuen Ordner:
cd tempo-tracingBuild
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:
aggrega build --release release.yaml --auto-pullGerenderte 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.