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

Jaeger — одноузловой бэкенд трассировки для Kubernetes

Этот пример компилирует небольшой реальный стек — бэкенд распределённой трассировки Jaeger в одноузловой конфигурации — из одного написанного разработчиком Aggregate в Kubernetes; стек синтезируется напрямую из официального образа Jaeger без вышестоящего чарта.

Jaeger — это бэкенд трассировки: он принимает спаны по протоколу OpenTelemetry, сохраняет их в локальном встроенном хранилище «ключ-значение» и отвечает на запросы поиска и просмотра трасс через свой интерфейс запросов. В одноузловой конфигурации приёмник OTLP, модуль записи в хранилище и служба запросов работают в одном процессе с локальным хранилищем на диске, поэтому весь сервер — это одна рабочая нагрузка с состоянием. Инструментированное приложение отправляет спаны в приёмник OTLP Jaeger; оператор читает их через интерфейс.

Файлы

ФайлРоль
aggregate.yamlНамерение разработчика: один компонент tracing (core/observability/jaeger).
manifest.yamlСопоставляет тип компонента с синтезирующим Recipe для Jaeger (jaeger).
release.yamlЗапись оператора для целевой платформы Kubernetes: вычислительные ресурсы сервера и размер тома хранилища трасс.

Что демонстрирует пример

  • Одна поверхность описания. Один Aggregate — источник истины о том, что представляет собой Jaeger; Manifest определяет, как это реализовать.
  • Одноузловой бэкенд трассировки. Синтезирующий Recipe отрисовывает Jaeger как один StatefulSet с томом данных, один ConfigMap с конфигурацией Jaeger v2 и два объекта Service — ClusterIP, открывающий доступ к приёмникам и интерфейсу, и headless-сервис, управляющий StatefulSet.
  • Конфигурация передаётся файлом. Jaeger v2 — это дистрибутив OpenTelemetry Collector, настраиваемый YAML-файлом. Recipe выдаёт эту конфигурацию как ConfigMap и монтирует её в контейнер по пути /etc/jaeger, а контейнер читает её с помощью --config /etc/jaeger/config.yaml.
  • Постоянное хранение трасс. Встроенное хранилище «ключ-значение» пишет на постоянный том по пути /badger, поэтому данные трасс сохраняются при перезапусках.
  • Экспортируемый контракт приёма данных. Компонент экспортирует хост и порт своего приёмника OTLP gRPC через топологию uses, поэтому источник трасс подключается к нему и отправляет туда спаны.
  • Воспроизводимые образы. Recipe закрепляет образ сервера Jaeger за разрешаемым тегом, поэтому отрисованная рабочая нагрузка ссылается на закреплённую версию.

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

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

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

Terminal window
aggrega scaffold --example jaeger-tracing

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

Terminal window
cd jaeger-tracing

Сборка

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

Terminal window
aggrega pull --release release.yaml
aggrega build --release release.yaml

Отрисованные артефакты помещаются в dist/. Целевая платформа Kubernetes отрисовывает обычные манифесты офлайн — загрузка чарта не требуется.

С ИИ-ассистентом

ИИ-ассистент, настроенный с инструментами Aggrega, может сделать то же самое: вставьте в него этот промпт.

Используйте только инструменты Aggrega и не создавайте папки самостоятельно. Если в папке рабочего пространства ещё нет папки `jaeger-tracing`, вызовите инструмент `scaffold` один раз, задав для `example` значение `jaeger-tracing`, без `dir`: он запишет пример в новую папку `jaeger-tracing`. Затем вызовите инструмент `build`, задав для `workspace_root` значение `jaeger-tracing`, для `release` — `release.yaml`, для `auto_pull` — true и для `write` — true. Сообщите, какие файлы записала сборка; они находятся в `jaeger-tracing/dist/`.

Что формируется

Сборка выдаёт сервер Jaeger в виде четырёх объектов Kubernetes:

  • StatefulSet — одноузловой процесс Jaeger со встроенным хранилищем трасс на постоянном томе, смонтированном в /badger, и конфигурацией, смонтированной в /etc/jaeger,
  • ConfigMap — конфигурация Jaeger v2 (приёмники OTLP, пакетный процессор и встроенное хранилище «ключ-значение», пишущее в /badger/key и /badger/data),
  • ClusterIP Service — открывает приёмник OTLP gRPC на порту 4317, приёмник OTLP HTTP на порту 4318 и интерфейс запросов на порту 16686,
  • headless Service — управляющий сервис, который требуется StatefulSet для стабильной идентичности каждой реплики.

Образ Jaeger закреплён за тегом своего релиза, поэтому рабочая нагрузка ссылается на закреплённый тег образа.