Loki — сервер агрегації журналів для Kubernetes
Цей приклад компілює невеликий реальний стек — сервер агрегації журналів
Grafana Loki — з одного написаного розробником Aggregate у Kubernetes, на основі
офіційного Helm-чарта Grafana Loki у його однобінарній формі.
Loki — це бекенд журналів: він отримує потоки журналів через свій HTTP push API, індексує їх за мітками, а не за повнотекстовим вмістом, зберігає їх в об’єктному сховищі чанків і відповідає на запити журналів і запити діапазонів через той самий HTTP API. В однобінарній формі кожна підсистема Loki — distributor, ingester, querier, compactor — працює в одному процесі з локальним сховищем чанків, тож увесь сервер є одним робочим навантаженням зі станом. Відправник журналів надсилає потоки в Loki; сервер дашбордів зчитує їх назад через API запитів.
Файли
| Файл | Роль |
|---|---|
aggregate.yaml | Намір розробника: один компонент logging (core/observability/loki), що зберігає журнали сім днів. |
manifest.yaml | Зіставляє тип компонента із запозиченим Recipe для Loki (loki). |
release.yaml | Запис оператора для цілі Kubernetes: обчислювальні ресурси сервера і розмір тому сховища чанків. |
Що демонструє приклад
- Одна поверхня написання. Єдиний Aggregate є джерелом істини щодо того, чим є Loki; Manifest визначає, як це реалізувати.
- Однобінарний бекенд журналів. Запозичений Recipe рендерить Loki як один
StatefulSetіз томом даних, його конфігурацію в об’єктахConfigMap, об’єктиService, що відкривають HTTP-ендпоінт надсилання й запитів, іServiceAccount— єдине самодостатнє робоче навантаження, без розподілених шляхів масштабування та вбудованих допоміжних сервісів. - Термін зберігання, заданий розробником. Значення
retention_periodвід розробника передається у вбудований compactor, який видаляє збережені потоки журналів, щойно вони стають старішими за нього. - Експортований контракт приймання. Компонент експортує свій внутрішньокластерний
хост і порт сервісу через топологію
uses, тож відправник журналів під’єднується до нього і надсилає туди потоки. - Відтворювані образи. Recipe фіксує образ сервера Loki та образ sidecar-контейнера перезавантаження конфігурації на теги, що розв’язуються, тож відрендерене робоче навантаження посилається на зафіксовані версії.
Створення прикладу
Цей приклад можна зібрати командами нижче або доручити збирання вашому ШІ-асистенту.
Запишіть приклад у нову теку, названу за ним:
aggrega scaffold --example loki-loggingПотім вона виводить команди, які слід виконати далі. Перша переходить у нову теку:
cd loki-loggingЗбирання
Цей робочий простір не містить .aggrega-config.yaml, тож сутності стандартної бібліотеки розв’язуються з реєстру hub, hub.aggrega.ai, і прапорець каталогу не потрібен:
aggrega pull --release release.yamlaggrega build --release release.yamlВідрендерені артефакти потрапляють у dist/. Збірка розв’язує висхідний чарт за
посиланням OCI під час aggrega pull і фіксує його в lock-файлі.
З ШІ-асистентом
ШІ-асистент, налаштований з інструментами Aggrega, може зробити те саме: вставте йому цей промпт.
Використовуйте лише інструменти Aggrega і не створюйте жодної теки самостійно. Якщо тека робочого простору ще не містить теки `loki-logging`, викличте один раз інструмент `scaffold`, задавши для `example` значення `loki-logging`, без `dir`: він запише приклад у нову теку `loki-logging`. Потім викличте інструмент `build`, задавши для `workspace_root` значення `loki-logging`, для `release` — `release.yaml`, для `auto_pull` — true і для `write` — true. Скажіть, які файли записала збірка; вони розташовані в `loki-logging/dist/`.Що рендериться
Збірка видає сервер Loki як єдиний самодостатній набір об’єктів Kubernetes:
StatefulSet— однобінарний процес Loki зі сховищем чанків на постійному томі,- об’єкти
ConfigMap— конфігурація Loki та конфігурація часу виконання, - об’єкти
Service— відкривають HTTP-ендпоінт надсилання й запитів на порту 3100, ServiceAccountдля робочого навантаження з його прив’язками доступу.
Розподілені робочі навантаження read/write/backend, сабчарт об’єктного сховища, кеш чи оператор не рендеряться — результат є одним робочим навантаженням Loki. Образи сервера Loki та sidecar-контейнера перезавантаження конфігурації зафіксовано на їхніх релізних тегах, тож робоче навантаження посилається на зафіксовані образи.