Tempo — servidor de trazado distribuido para Kubernetes
Este ejemplo compila un stack pequeño y real — un servidor de trazado distribuido Grafana Tempo — a partir de un único Aggregate escrito por el desarrollador para Kubernetes mediante la síntesis de Workload sobre la imagen oficial grafana/tempo, en su forma de binario único.
Tempo es un backend de trazas: recibe spans mediante el protocolo OpenTelemetry (y otros formatos de transmisión de trazado), los almacena en un almacén de objetos de trazas y responde a las consultas de búsqueda y recuperación de trazas mediante su API HTTP. En la forma de binario único, cada subsistema de Tempo — distributor, ingester, querier, compactor — se ejecuta dentro de un único proceso respaldado por un almacén de trazas local, así que todo el servidor es una única carga de trabajo con estado. Una aplicación instrumentada envía spans al receptor OTLP de Tempo; un servidor de paneles los vuelve a leer mediante la API de consulta.
Archivos
| Archivo | Rol |
|---|---|
aggregate.yaml | Intención del desarrollador: un único componente tracing (core/observability/tempo) que conserva las trazas durante siete días. |
manifest.yaml | Asigna el tipo de componente a la Recipe de Tempo sintetizada (tempo). |
release.yaml | Documento del operador para el destino Kubernetes: el cómputo del servidor y el tamaño del volumen del almacén de trazas. |
Lo que demuestra
- Una única superficie de autoría. Un único Aggregate es la fuente de verdad sobre qué es Tempo; el Manifest dice cómo realizarlo.
- Un backend de trazas de binario único. La Recipe sintetizada renderiza Tempo como un único
StatefulSetcon un volumen de datos por réplica, unConfigMapque lleva la configuración de Tempo, y unServiceClusterIPy otroHeadlessque exponen los receptores de trazas y la API de consulta HTTP — una única carga de trabajo autónoma. - Retención fijada por el desarrollador. El
retention_perioddel desarrollador llega al compactor interno del proceso, que elimina los bloques de trazas almacenados una vez que superan esa antigüedad. - Un contrato de ingesta exportado. El componente exporta el host y el puerto de su receptor OTLP gRPC mediante la topología
uses, así que un productor de trazas se conecta a él y le envía spans. - Imágenes reproducibles. La Recipe fija la etiqueta de la imagen del servidor Tempo a partir de
infra.engine_version, así que la carga de trabajo renderizada hace referencia a una versión fijada.
Generar el ejemplo
Puedes compilar este ejemplo con los comandos de abajo, o hacer que tu asistente de IA lo compile por ti.
Escribe el ejemplo en una carpeta nueva con su nombre:
aggrega scaffold --example tempo-tracingDespués imprime los comandos que hay que ejecutar a continuación. El primero entra en la carpeta nueva:
cd tempo-tracingCompilación
Este workspace no lleva ningún .aggrega-config.yaml, así que las entidades de la biblioteca estándar se resuelven desde el registro del hub, hub.aggrega.ai, y no se necesita ningún flag de catálogo; --auto-pull escribe durante la compilación el lockfile que le falta a un clon recién creado:
aggrega build --release release.yaml --auto-pullLos artefactos renderizados quedan en dist/. El destino sintetizado no necesita obtener ningún chart externo — la Recipe renderiza la imagen oficial directamente en un StatefulSet, Services y un volumen de datos.
Con un asistente de IA
Un asistente de IA configurado con las herramientas de Aggrega puede hacer lo mismo: pégale este prompt.
Usa solo las herramientas de Aggrega y no crees ninguna carpeta por tu cuenta. Si la carpeta del espacio de trabajo aún no contiene una carpeta `tempo-tracing`, llama una vez a la herramienta `scaffold` con `example` establecido en `tempo-tracing` y sin `dir`: escribe el ejemplo en una nueva carpeta `tempo-tracing`. Luego llama a la herramienta `build` con `workspace_root` establecido en `tempo-tracing`, `release` establecido en `release.yaml`, `auto_pull` establecido en true y `write` establecido en true. Dime qué archivos escribió la compilación; están en `tempo-tracing/dist/`.Qué se renderiza
La compilación emite el servidor Tempo como cuatro objetos de Kubernetes:
- un
StatefulSet— el proceso de Tempo de binario único, con su almacén de trazas en un volumen persistente por réplica, - un
ConfigMap— la configuración de Tempo, - un
ClusterIP Service— que expone el receptor OTLP gRPC en el 4317, el receptor OTLP HTTP en el 4318 y la API de consulta HTTP en el 3200, - un
Headless Service— la identidad de red estable del StatefulSet, que expone los mismos puertos.
La etiqueta de la imagen de Tempo se fija a partir de infra.engine_version, así que la carga de trabajo hace referencia a una etiqueta de imagen fijada.