Jaeger — однонодовий бекенд трасування в Kubernetes
Цей приклад компілює невеликий реальний стек — бекенд розподіленого трасування Jaeger
в однонодовій конфігурації — з одного Aggregate, написаного розробником, у
Kubernetes, синтезуючи його безпосередньо з офіційного образу Jaeger без
upstream-чарта.
Jaeger — це бекенд трас: він отримує спани за протоколом OpenTelemetry, зберігає їх у локальному вбудованому сховищі «ключ-значення» й відповідає на запити пошуку трас через свій UI запитів. В однонодовій конфігурації приймач OTLP, записувач сховища й сервіс запитів працюють в одному процесі з локальним сховищем на диску, тож увесь сервер — це одне робоче навантаження зі станом. Інструментований застосунок надсилає спани до приймача OTLP у Jaeger; оператор читає їх через UI.
Файли
| Файл | Роль |
|---|---|
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, що відкриває приймачі та UI, і 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 і UI запитів на 16686,- headless
Service— керівний сервіс, потрібний StatefulSet для стабільної ідентичності кожної репліки.
Образ Jaeger зафіксовано на тезі його релізу, тож робоче навантаження посилається на зафіксований тег образу.