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

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

PlikRola
aggregate.yamlIntencja programisty: pojedynczy komponent logging (core/observability/loki) przechowujący logi przez siedem dni.
manifest.yamlMapuje typ komponentu na pozyskaną encję Recipe Loki (loki).
release.yamlRekord 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 StatefulSet z wolumenem danych, jego konfigurację w obiektach ConfigMap, obiekty Service udostępniające punkt końcowy HTTP do wysyłania i zapytań oraz ServiceAccount — jedno samodzielne obciążenie, z wyłączonymi ścieżkami skalowania rozproszonego i dołączonymi usługami pomocniczymi.
  • Retencja ustawiana przez programistę. Wartość retention_period ustawiona 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:

Terminal window
aggrega scaffold --example loki-logging

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

Terminal window
cd loki-logging

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/. 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,
  • ServiceAccount dla 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.