Tempo — сервер розподіленого трасування для Kubernetes
Цей приклад компілює невеликий реальний стек — сервер розподіленого трасування Grafana Tempo —
з одного Aggregate, написаного розробником, у Kubernetes через синтез Workload
на основі офіційного образу grafana/tempo у його однобінарній формі.
Tempo — це бекенд трас: він отримує спани за протоколом OpenTelemetry (та в інших форматах передавання трас), зберігає їх в об’єктному сховищі трас і відповідає на запити пошуку трас через свій HTTP API. В однобінарній формі кожна підсистема Tempo — distributor, ingester, querier, compactor — працює в одному процесі з локальним сховищем трас, тож увесь сервер є одним робочим навантаженням зі станом. Інструментований застосунок надсилає спани на OTLP-приймач Tempo, а сервер дашбордів зчитує їх через API запитів.
Файли
| Файл | Роль |
|---|---|
aggregate.yaml | Намір розробника: один компонент tracing (core/observability/tempo), що зберігає траси сім днів. |
manifest.yaml | Зіставляє тип компонента із синтезованим Tempo Recipe (tempo). |
release.yaml | Запис оператора для цілі Kubernetes: обчислювальні ресурси сервера й розмір тому сховища трас. |
Що демонструє приклад
- Одна поверхня авторингу. Єдиний Aggregate є джерелом істини щодо того, що таке Tempo; Manifest визначає, як це реалізувати.
- Однобінарний бекенд трас. Синтезований Recipe рендерить Tempo як один
StatefulSetз томом даних для кожної репліки, одинConfigMapз конфігурацією Tempo, а такожClusterIPіHeadlessService, що відкривають приймачі трас і HTTP API запитів, — одне самодостатнє робоче навантаження. - Термін зберігання, заданий розробником. Параметр
retention_periodрозробника передається у вбудований compactor, який видаляє збережені блоки трас, щойно вони стають старшими за цей термін. - Експортований контракт приймання. Компонент експортує хост і порт свого приймача
OTLP gRPC через топологію
uses, тож виробник трас підключається до нього й надсилає туди спани. - Відтворювані образи. Recipe фіксує тег образу сервера Tempo з
infra.engine_version, тож відрендерене робоче навантаження посилається на зафіксовану версію.
Створення прикладу
Цей приклад можна зібрати командами нижче або доручити збирання вашому ШІ-асистенту.
Запишіть приклад у нову теку, названу за ним:
aggrega scaffold --example tempo-tracingПотім вона виводить команди, які слід виконати далі. Перша переходить у нову теку:
cd tempo-tracingЗбирання
Цей робочий простір не містить .aggrega-config.yaml, тож сутності стандартної бібліотеки розв’язуються з реєстру hub, hub.aggrega.ai, і прапорець каталогу не потрібен; --auto-pull під час збирання записує lock-файл, якого бракує свіжому клону:
aggrega build --release release.yaml --auto-pullВідрендерені артефакти потрапляють у dist/. Синтезованій цілі не потрібне завантаження
зовнішнього чарту — Recipe рендерить офіційний образ безпосередньо у StatefulSet,
Services і том даних.
З ШІ-асистентом
ШІ-асистент, налаштований з інструментами Aggrega, може зробити те саме: вставте йому цей промпт.
Використовуйте лише інструменти Aggrega і не створюйте жодної папки самостійно. Якщо папка робочої області ще не містить папки `tempo-tracing`, викличте один раз інструмент `scaffold` з параметром `example` зі значенням `tempo-tracing` і без `dir`: він запише приклад у нову папку `tempo-tracing`. Потім викличте інструмент `build` з параметрами `workspace_root` — `tempo-tracing`, `release` — `release.yaml`, `auto_pull` — true і `write` — true. Скажіть мені, які файли записала збірка; вони розташовані в `tempo-tracing/dist/`.Що рендериться
Збирання видає сервер Tempo у вигляді чотирьох об’єктів Kubernetes:
StatefulSet— однобінарний процес Tempo зі сховищем трас на постійному томі для кожної репліки,ConfigMap— конфігурація Tempo,ClusterIP Service— відкриває OTLP gRPC-приймач на 4317, OTLP HTTP-приймач на 4318 і HTTP API запитів на 3200,Headless Service— стабільна мережева ідентичність StatefulSet, що відкриває ті самі порти.
Тег образу Tempo фіксується з infra.engine_version, тож робоче навантаження посилається на зафіксований тег образу.