Jaeger — jednowęzłowy backend śledzenia w Kubernetes
Ten przykład kompiluje mały, rzeczywisty stos — backend rozproszonego śledzenia Jaeger
w wariancie jednowęzłowym — z jednej encji Aggregate napisanej przez dewelopera do
Kubernetes, syntetyzowany bezpośrednio z oficjalnego obrazu Jaeger, bez
chartu upstream.
Jaeger jest backendem śladów: odbiera spany przez protokół OpenTelemetry, przechowuje je w lokalnym osadzonym magazynie klucz-wartość i odpowiada na zapytania o ślady i wyszukiwania przez swój interfejs zapytań. W wariancie jednowęzłowym odbiornik OTLP, zapis do magazynu i usługa zapytań działają w jednym procesie opartym na lokalnym magazynie dyskowym, więc cały serwer jest jednym stanowym obciążeniem. Instrumentowana aplikacja wysyła spany do odbiornika OTLP Jaegera; operator odczytuje je w interfejsie.
Pliki
| Plik | Rola |
|---|---|
aggregate.yaml | Intencja dewelopera: pojedynczy komponent tracing (core/observability/jaeger). |
manifest.yaml | Mapuje typ komponentu na syntezującą encję Recipe Jaegera (jaeger). |
release.yaml | Zapis operatora dla celu Kubernetes: zasoby obliczeniowe serwera i rozmiar wolumenu magazynu śladów. |
Co demonstruje
- Jedna powierzchnia tworzenia. Pojedyncza encja Aggregate jest źródłem prawdy o tym, czym jest Jaeger; encja Manifest określa, jak go zrealizować.
- Jednowęzłowy backend śladów. Syntezująca encja Recipe renderuje Jaegera jako jeden
StatefulSetz wolumenem danych, jedenConfigMapz konfiguracją Jaeger v2 i dwa obiektyService—ClusterIPudostępniający odbiorniki i interfejs oraz headless Service zarządzający dla StatefulSet. - Konfiguracja dostarczana jako plik. Jaeger v2 jest dystrybucją OpenTelemetry Collector
konfigurowaną plikiem YAML. Encja Recipe emituje tę konfigurację jako
ConfigMapi montuje ją w kontenerze w/etc/jaeger, a kontener odczytuje ją za pomocą--config /etc/jaeger/config.yaml. - Trwałe ślady. Osadzony magazyn klucz-wartość zapisuje na trwałym
wolumenie w
/badger, więc dane śladów przetrwają restarty. - Eksportowany kontrakt przyjmowania danych. Komponent eksportuje host i port swojego
odbiornika OTLP gRPC przez topologię
uses, więc producent śladów łączy się z nim i wysyła tam spany. - Odtwarzalne obrazy. Encja Recipe przypina obraz serwera Jaeger do rozwiązywalnego tagu, więc wyrenderowane obciążenie odwołuje się do przypiętej wersji.
Generowanie przykładu
Ten przykład można zbudować za pomocą poniższych poleceń albo zlecić jego zbudowanie asystentowi AI.
Należy zapisać przykład w nowym folderze nazwanym tak jak on:
aggrega scaffold --example jaeger-tracingNastępnie wypisuje polecenia do uruchomienia w dalszej kolejności. Pierwsze przechodzi do nowego folderu:
cd jaeger-tracingKompilacja
Ta przestrzeń robocza nie zawiera pliku .aggrega-config.yaml, więc encje biblioteki standardowej są rozwiązywane z rejestru hub, hub.aggrega.ai, i flaga katalogu nie jest potrzebna:
aggrega pull --release release.yamlaggrega build --release release.yamlWyrenderowane artefakty trafiają do dist/. Cel Kubernetes renderuje zwykłe
manifesty offline — pobieranie chartu nie jest wymagane.
Z asystentem AI
Asystent AI skonfigurowany z narzędziami Aggrega może zrobić to samo: wystarczy wkleić mu ten prompt.
Używaj wyłącznie narzędzi Aggrega i nie twórz samodzielnie żadnego folderu. Jeśli folder obszaru roboczego nie zawiera jeszcze folderu `jaeger-tracing`, wywołaj raz narzędzie `scaffold` z `example` ustawionym na `jaeger-tracing` i bez `dir`: zapisuje ono przykład w nowym folderze `jaeger-tracing`. Następnie wywołaj narzędzie `build` z `workspace_root` ustawionym na `jaeger-tracing`, `release` ustawionym na `release.yaml`, `auto_pull` ustawionym na true i `write` ustawionym na true. Podaj, które pliki zapisała kompilacja; znajdują się w `jaeger-tracing/dist/`.Co jest renderowane
Kompilacja emituje serwer Jaeger jako cztery obiekty Kubernetes:
StatefulSet— jednowęzłowy proces Jaeger z osadzonym magazynem śladów na trwałym wolumenie zamontowanym w/badgeri konfiguracją zamontowaną w/etc/jaeger,ConfigMap— konfiguracja Jaeger v2 (odbiorniki OTLP, procesor wsadowy i osadzony magazyn klucz-wartość zapisujący do/badger/keyi/badger/data),ClusterIPService— udostępniający odbiornik OTLP gRPC na porcie 4317, odbiornik OTLP HTTP na porcie 4318 i interfejs zapytań na porcie 16686,- headless
Service— zarządzający Service, którego StatefulSet wymaga dla stabilnej tożsamości każdej repliki.
Obraz Jaeger jest przypięty do swojego tagu wydania, więc obciążenie odwołuje się do przypiętego tagu obrazu.