Перейти к содержимому
AggregaAggrega
Выберите язык: Русский
Эта страница переведена машинным способом. Читать оригинал на английском.

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-контейнера перезагрузки конфигурации за разрешимыми тегами, чтобы сформированная рабочая нагрузка ссылалась на закреплённые версии.

Создание примера

Этот пример можно собрать командами ниже или поручить сборку вашему ИИ-ассистенту.

Запишите пример в новую папку, названную по его имени:

Terminal window
aggrega scaffold --example loki-logging

Затем она выводит команды, которые нужно выполнить дальше. Первая переходит в новую папку:

Terminal window
cd loki-logging

Сборка

В этом рабочем пространстве нет .aggrega-config.yaml, поэтому сущности стандартной библиотеки разрешаются из реестра hub, hub.aggrega.ai, и флаг каталога не нужен:

Terminal window
aggrega pull --release release.yaml
aggrega 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-контейнера перезагрузки конфигурации закреплены за тегами своих релизов, поэтому рабочая нагрузка ссылается на закреплённые образы.