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
| Plik | Rola |
|---|---|
aggregate.yaml | Intencja programisty: pojedynczy komponent tracing (core/observability/tempo) przechowujący ślady przez siedem dni. |
manifest.yaml | Mapuje typ komponentu na syntetyzowaną encję Recipe dla Tempo (tempo). |
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 Tempo; encja Manifest określa, jak to zrealizować.
- Backend śladów w jednym pliku binarnym. Syntetyzowana encja Recipe renderuje Tempo jako jeden
StatefulSetz woluminem danych dla każdej repliki, jedenConfigMapzawierający konfigurację Tempo orazClusterIPiHeadlessServiceudostępniające odbiorniki śladów i HTTP API zapytań — jedno samodzielne obciążenie. - Retencja ustawiana przez programistę. Wartość
retention_periodprogramisty 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:
aggrega scaffold --example tempo-tracingNastępnie wypisuje polecenia do uruchomienia w dalszej kolejności. Pierwsze przechodzi do nowego folderu:
cd tempo-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; --auto-pull zapisuje w trakcie kompilacji plik blokady, którego brakuje w świeżym klonie:
aggrega build --release release.yaml --auto-pullRenderowane 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.