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 за разрешаемым тегом, поэтому отрисованная рабочая нагрузка ссылается на закреплённую версию.
Создание примера
Этот пример можно собрать командами ниже или поручить сборку вашему ИИ-ассистенту.
Запишите пример в новую папку, названную по его имени:
aggrega scaffold --example jaeger-tracingЗатем она выводит команды, которые нужно выполнить дальше. Первая переходит в новую папку:
cd jaeger-tracingСборка
В этом рабочем пространстве нет .aggrega-config.yaml, поэтому сущности стандартной библиотеки разрешаются из реестра hub, hub.aggrega.ai, и флаг каталога не нужен:
aggrega pull --release release.yamlaggrega 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),ClusterIPService— открывает приёмник OTLP gRPC на порту 4317, приёмник OTLP HTTP на порту 4318 и интерфейс запросов на порту 16686,- headless
Service— управляющий сервис, который требуется StatefulSet для стабильной идентичности каждой реплики.
Образ Jaeger закреплён за тегом своего релиза, поэтому рабочая нагрузка ссылается на закреплённый тег образа.