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 | Сопоставляет тип компонента с синтезированной сущностью Recipe для Tempo (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, поэтому рабочая нагрузка ссылается на зафиксированный тег образа.