Jaeger — Single-Node-Tracing-Backend für Kubernetes
Dieses Beispiel kompiliert einen kleinen, realen Stack — ein Jaeger-Backend für verteiltes Tracing in seiner Single-Node-Struktur — aus einem einzigen vom Entwickler verfassten Aggregate für Kubernetes, direkt aus dem offiziellen Jaeger-Image synthetisiert, ohne Upstream-Chart.
Jaeger ist ein Trace-Backend: Es empfängt Spans über das OpenTelemetry-Protokoll, speichert sie in einem lokalen eingebetteten Key-Value-Store und beantwortet Trace-Abfragen und Suchanfragen über seine Abfrage-UI. In der Single-Node-Struktur laufen der OTLP-Receiver, der Storage-Writer und der Abfragedienst alle in einem Prozess, der von einem lokalen Store auf der Festplatte gestützt wird, sodass der gesamte Server eine einzige zustandsbehaftete Arbeitslast ist. Eine instrumentierte Anwendung pusht Spans an den OTLP-Receiver von Jaeger; ein Betreiber liest sie über die UI wieder aus.
Dateien
| Datei | Rolle |
|---|---|
aggregate.yaml | Entwicklerabsicht: eine einzelne Komponente tracing (core/observability/jaeger). |
manifest.yaml | Bildet den Komponententyp auf das Jaeger-Synthese-Recipe ab (jaeger). |
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 Jaeger ist; das Manifest sagt, wie es zu realisieren ist.
- Ein Single-Node-Trace-Backend. Das Synthese-Recipe rendert Jaeger als ein
StatefulSetmit einem Daten-Volume, eineConfigMapmit der Konfiguration von Jaeger v2 und zwei ObjekteService— einenClusterIP, der die Receiver und die UI freigibt, und einen steuernden Headless-Service für das StatefulSet. - Konfiguration als Datei geliefert. Jaeger v2 ist eine Distribution des OpenTelemetry Collector, die über eine YAML-Datei konfiguriert wird. Das Recipe gibt diese Konfiguration als
ConfigMapaus und hängt sie unter/etc/jaegerin den Container ein, und der Container liest sie mit--config /etc/jaeger/config.yaml. - Persistente Traces. Der eingebettete Key-Value-Store schreibt auf das persistente Volume unter
/badger, sodass Trace-Daten Neustarts überstehen. - 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 das Jaeger-Server-Image auf einen auflösbaren Tag, 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 jaeger-tracingDanach gibt er die als Nächstes auszuführenden Befehle aus. Der erste wechselt in den neuen Ordner:
cd jaeger-tracingBuild
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/. Das Kubernetes-Ziel rendert einfache Manifeste offline — es ist kein Chart-Pull erforderlich.
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 `jaeger-tracing` enthält, rufen Sie das Tool `scaffold` einmal mit `example` auf `jaeger-tracing` gesetzt und ohne `dir` auf: Es schreibt das Beispiel in einen neuen Ordner `jaeger-tracing`. Rufen Sie anschließend das Tool `build` mit `workspace_root` auf `jaeger-tracing`, `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 `jaeger-tracing/dist/`.Was gerendert wird
Der Build gibt den Jaeger-Server als vier Kubernetes-Objekte aus:
- ein
StatefulSet— der Single-Node-Jaeger-Prozess, mit seinem eingebetteten Trace-Store auf einem persistenten Volume, das unter/badgereingehängt ist, und der unter/etc/jaegereingehängten Konfiguration, - eine
ConfigMap— die Konfiguration von Jaeger v2 (OTLP-Receiver, der Batch-Prozessor und der eingebettete Key-Value-Store, der nach/badger/keyund/badger/dataschreibt), - ein
Servicevom TypClusterIP— der den OTLP-gRPC-Receiver auf 4317, den OTLP-HTTP-Receiver auf 4318 und die Abfrage-UI auf 16686 freigibt, - ein headless
Service— der steuernde Service, den das StatefulSet für eine stabile Identität pro Replica benötigt.
Das Jaeger-Image ist auf seinen Release-Tag fixiert, sodass die Arbeitslast einen fixierten Image-Tag referenziert.