Loki — serwer agregacji logów w Kubernetes
Ten przykład kompiluje mały, rzeczywisty stos — serwer agregacji logów Grafana Loki —
z jednej encji Aggregate utworzonej przez programistę do Kubernetes, w oparciu o
oficjalny chart Helm Grafana Loki w wariancie single-binary.
Loki jest backendem logów: odbiera strumienie logów przez swoje HTTP push API, indeksuje je według etykiet, a nie według pełnej treści, przechowuje je w magazynie obiektów chunków i odpowiada na zapytania o logi i zakresy przez to samo HTTP API. W wariancie single-binary każdy podsystem Loki — distributor, ingester, querier, compactor — działa w jednym procesie opartym na lokalnym magazynie chunków, więc cały serwer jest jednym stanowym obciążeniem. Narzędzie do wysyłania logów przesyła strumienie do Loki; serwer dashboardów odczytuje je z powrotem przez API zapytań.
Pliki
| Plik | Rola |
|---|---|
aggregate.yaml | Intencja programisty: pojedynczy komponent logging (core/observability/loki) przechowujący logi przez siedem dni. |
manifest.yaml | Mapuje typ komponentu na pozyskaną encję Recipe Loki (loki). |
release.yaml | Rekord operatora dla celu Kubernetes: zasoby obliczeniowe serwera i rozmiar wolumenu magazynu chunków. |
Co demonstruje
- Jedna powierzchnia tworzenia. Pojedyncza encja Aggregate jest źródłem prawdy o tym, czym jest Loki; encja Manifest mówi, jak to zrealizować.
- Backend logów single-binary. Pozyskana encja Recipe renderuje Loki jako jeden
StatefulSetz wolumenem danych, jego konfigurację w obiektachConfigMap, obiektyServiceudostępniające punkt końcowy HTTP do wysyłania i zapytań orazServiceAccount— jedno samodzielne obciążenie, z wyłączonymi ścieżkami skalowania rozproszonego i dołączonymi usługami pomocniczymi. - Retencja ustawiana przez programistę. Wartość
retention_periodustawiona przez programistę trafia do działającego w procesie compactora, który usuwa zapisane strumienie logów, gdy przekroczą ten wiek. - Eksportowany kontrakt przyjmowania danych. Komponent eksportuje host i port swojej usługi
w klastrze przez topologię
uses, dzięki czemu narzędzie do wysyłania logów łączy się z nim i przesyła tam strumienie. - Powtarzalne obrazy. Encja Recipe przypina obraz serwera Loki i obraz sidecara przeładowania konfiguracji do rozwiązywalnych tagów, dzięki czemu wyrenderowane obciążenie odwołuje się do przypiętych 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 loki-loggingNastępnie wypisuje polecenia do uruchomienia w dalszej kolejności. Pierwsze przechodzi do nowego folderu:
cd loki-loggingKompilacja
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/. Kompilacja rozwiązuje chart nadrzędny
przez referencję OCI przy aggrega pull i przypina go w pliku blokady.
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 `loki-logging`, wywołaj raz narzędzie `scaffold` z `example` ustawionym na `loki-logging` i bez `dir`: zapisuje ono przykład w nowym folderze `loki-logging`. Następnie wywołaj narzędzie `build` z `workspace_root` ustawionym na `loki-logging`, `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 `loki-logging/dist/`.Co jest renderowane
Kompilacja emituje serwer Loki jako pojedynczy, samodzielny zestaw obiektów Kubernetes:
StatefulSet— proces Loki single-binary z magazynem chunków na trwałym wolumenie,- obiekty
ConfigMap— konfiguracja Loki i konfiguracja środowiska uruchomieniowego, - obiekty
Service— udostępniające punkt końcowy HTTP do wysyłania i zapytań na porcie 3100, ServiceAccountdla obciążenia wraz z jego powiązaniami dostępu.
Nie są renderowane rozproszone obciążenia read/write/backend, subchart magazynu obiektów, cache ani operator — wynikiem jest pojedyncze obciążenie Loki. Obrazy serwera Loki i sidecara przeładowania konfiguracji są przypięte do tagów wydań, więc obciążenie odwołuje się do przypiętych obrazów.