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