Loki — сервер агрегации журналов для Kubernetes
Этот пример компилирует небольшой реальный стек — сервер агрегации журналов Grafana Loki —
из одного написанного разработчиком Aggregate в Kubernetes на основе
официального Helm-чарта Grafana Loki в однобинарной конфигурации.
Loki — это бэкенд журналов: он принимает потоки журналов через свой HTTP 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-контейнера перезагрузки конфигурации закреплены за тегами своих релизов, поэтому рабочая нагрузка ссылается на закреплённые образы.