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

Tempo — serwer śledzenia rozproszonego dla Kubernetes

Ten przykład kompiluje mały, rzeczywisty stos — serwer śledzenia rozproszonego Grafana Tempo — z jednej encji Aggregate napisanej przez programistę do Kubernetes poprzez syntezę Workload na oficjalnym obrazie grafana/tempo, w jego postaci pojedynczego pliku binarnego.

Tempo to backend śladów: odbiera spany przez protokół OpenTelemetry (oraz inne formaty przesyłu śladów), przechowuje je w magazynie obiektów śladów i odpowiada na zapytania o wyszukiwanie i odczyt śladów przez swoje HTTP API. W postaci pojedynczego pliku binarnego każdy podsystem Tempo — distributor, ingester, querier, compactor — działa w jednym procesie opartym na lokalnym magazynie śladów, więc cały serwer jest jednym stanowym obciążeniem. Instrumentowana aplikacja wysyła spany do odbiornika OTLP w Tempo; serwer pulpitów odczytuje je przez API zapytań.

Pliki

PlikRola
aggregate.yamlIntencja programisty: pojedynczy komponent tracing (core/observability/tempo) przechowujący ślady przez siedem dni.
manifest.yamlMapuje typ komponentu na syntetyzowaną encję Recipe dla Tempo (tempo).
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 Tempo; encja Manifest określa, jak to zrealizować.
  • Backend śladów w jednym pliku binarnym. Syntetyzowana encja Recipe renderuje Tempo jako jeden StatefulSet z woluminem danych dla każdej repliki, jeden ConfigMap zawierający konfigurację Tempo oraz ClusterIP i Headless Service udostępniające odbiorniki śladów i HTTP API zapytań — jedno samodzielne obciążenie.
  • Retencja ustawiana przez programistę. Wartość retention_period programisty trafia do działającego w procesie compactora, który usuwa zapisane bloki śladów, gdy przekroczą ten wiek.
  • 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 tag obrazu serwera Tempo z infra.engine_version, dzięki czemu renderowane 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 tempo-tracing

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

Terminal window
cd tempo-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; --auto-pull zapisuje w trakcie kompilacji plik blokady, którego brakuje w świeżym klonie:

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

Renderowane artefakty trafiają do dist/. Syntetyzowany cel nie wymaga pobierania zewnętrznego chartu — encja Recipe renderuje oficjalny obraz bezpośrednio do StatefulSet, obiektów Service i woluminu danych.

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 `tempo-tracing`, wywołaj raz narzędzie `scaffold` z `example` ustawionym na `tempo-tracing` i bez `dir`: zapisze ono przykład w nowym folderze `tempo-tracing`. Następnie wywołaj narzędzie `build` z `workspace_root` ustawionym na `tempo-tracing`, `release` ustawionym na `release.yaml`, `auto_pull` ustawionym na true i `write` ustawionym na true. Podaj mi, jakie pliki zapisała kompilacja; znajdują się w `tempo-tracing/dist/`.

Co jest renderowane

Kompilacja emituje serwer Tempo jako cztery obiekty Kubernetes:

  • StatefulSet — proces Tempo w jednym pliku binarnym, z magazynem śladów na trwałym woluminie każdej repliki,
  • ConfigMap — konfiguracja Tempo,
  • ClusterIP Service — udostępniający odbiornik OTLP gRPC na porcie 4317, odbiornik OTLP HTTP na porcie 4318 oraz HTTP API zapytań na porcie 3200,
  • Headless Service — stabilna tożsamość sieciowa StatefulSet, udostępniająca te same porty.

Tag obrazu Tempo jest przypięty z infra.engine_version, więc obciążenie odwołuje się do przypiętego tagu obrazu.