Przejdź do głównej zawartości
AggregaAggrega
Wybierz język: Polski
Ta strona została przetłumaczona maszynowo. Przeczytaj oryginał w języku angielskim.

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

PlikRola
aggregate.yamlIntencja dewelopera: pojedynczy komponent tracing (core/observability/jaeger).
manifest.yamlMapuje typ komponentu na syntezującą encję Recipe Jaegera (jaeger).
release.yamlZapis 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 StatefulSet z wolumenem danych, jeden ConfigMap z konfiguracją Jaeger v2 i dwa obiekty Service — ClusterIP udostę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 ConfigMap i 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:

Terminal window
aggrega scaffold --example jaeger-tracing

Następnie wypisuje polecenia do uruchomienia w dalszej kolejności. Pierwsze przechodzi do nowego folderu:

Terminal window
cd jaeger-tracing

Kompilacja

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:

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

Wyrenderowane 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 /badger i konfiguracją zamontowaną w /etc/jaeger,
  • ConfigMap — konfiguracja Jaeger v2 (odbiorniki OTLP, procesor wsadowy i osadzony magazyn klucz-wartość zapisujący do /badger/key i /badger/data),
  • ClusterIP Service — 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.