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

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

DateiRolle
aggregate.yamlEntwicklerabsicht: eine einzelne Komponente tracing (core/observability/jaeger).
manifest.yamlBildet den Komponententyp auf das Jaeger-Synthese-Recipe ab (jaeger).
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 Jaeger ist; das Manifest sagt, wie es zu realisieren ist.
  • Ein Single-Node-Trace-Backend. Das Synthese-Recipe rendert Jaeger als ein StatefulSet mit einem Daten-Volume, eine ConfigMap mit der Konfiguration von Jaeger v2 und zwei Objekte Service — einen ClusterIP, 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 ConfigMap aus und hängt sie unter /etc/jaeger in 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:

Terminal window
aggrega scaffold --example jaeger-tracing

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

Terminal window
cd jaeger-tracing

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/. 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 /badger eingehängt ist, und der unter /etc/jaeger eingehängten Konfiguration,
  • eine ConfigMap — die Konfiguration von Jaeger v2 (OTLP-Receiver, der Batch-Prozessor und der eingebettete Key-Value-Store, der nach /badger/key und /badger/data schreibt),
  • ein Service vom Typ ClusterIP — 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.