Перейти до вмісту
AggregaAggrega
Обрати мову: Українська
Цю сторінку перекладено машинним способом. Читати оригінал англійською.

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 і Headless Service, що відкривають приймачі трас і HTTP API запитів, — одне самодостатнє робоче навантаження.
  • Термін зберігання, заданий розробником. Параметр retention_period розробника передається у вбудований compactor, який видаляє збережені блоки трас, щойно вони стають старшими за цей термін.
  • Експортований контракт приймання. Компонент експортує хост і порт свого приймача OTLP gRPC через топологію uses, тож виробник трас підключається до нього й надсилає туди спани.
  • Відтворювані образи. Recipe фіксує тег образу сервера Tempo з infra.engine_version, тож відрендерене робоче навантаження посилається на зафіксовану версію.

Створення прикладу

Цей приклад можна зібрати командами нижче або доручити збирання вашому ШІ-асистенту.

Запишіть приклад у нову теку, названу за ним:

Terminal window
aggrega scaffold --example tempo-tracing

Потім вона виводить команди, які слід виконати далі. Перша переходить у нову теку:

Terminal window
cd tempo-tracing

Збирання

Цей робочий простір не містить .aggrega-config.yaml, тож сутності стандартної бібліотеки розв’язуються з реєстру hub, hub.aggrega.ai, і прапорець каталогу не потрібен; --auto-pull під час збирання записує lock-файл, якого бракує свіжому клону:

Terminal window
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, тож робоче навантаження посилається на зафіксований тег образу.