Tempo — server di tracing distribuito per Kubernetes
Questo esempio compila uno stack piccolo e reale — un server di tracing distribuito Grafana Tempo — a partire da un unico Aggregate scritto dallo sviluppatore per Kubernetes tramite la sintesi del Workload sull’immagine ufficiale grafana/tempo, nella sua forma a binario singolo.
Tempo è un backend di tracce: riceve span tramite il protocollo OpenTelemetry (e altri formati di trasmissione per il tracing), li archivia in un object store delle tracce e risponde alle query di consultazione e di ricerca delle tracce tramite la sua API HTTP. Nella forma a binario singolo ogni sottosistema di Tempo — distributor, ingester, querier, compactor — viene eseguito all’interno di un unico processo supportato da uno store locale delle tracce, quindi l’intero server è un unico carico di lavoro con stato. Un’applicazione strumentata invia gli span al ricevitore OTLP di Tempo; un server di dashboard li rilegge tramite l’API di query.
File
| File | Ruolo |
|---|---|
aggregate.yaml | Intento dello sviluppatore: un unico componente tracing (core/observability/tempo) che conserva le tracce per sette giorni. |
manifest.yaml | Mappa il tipo di componente sulla Recipe di Tempo sintetizzata (tempo). |
release.yaml | Documento dell’operatore per la destinazione Kubernetes: le risorse di calcolo del server e la dimensione del volume dello store delle tracce. |
Che cosa dimostra
- Un’unica superficie di authoring. Un unico Aggregate è la fonte di verità su che cosa è Tempo; il Manifest dice come realizzarlo.
- Un backend di tracce a binario singolo. La Recipe sintetizzata renderizza Tempo come un unico
StatefulSetcon un volume di dati per ciascuna replica, unaConfigMapche contiene la configurazione di Tempo, e unServiceClusterIPe unoHeadlessche espongono i ricevitori delle tracce e l’API di query HTTP — un unico carico di lavoro autonomo. - Conservazione impostata dallo sviluppatore. Il
retention_perioddello sviluppatore confluisce nel compactor interno al processo, che elimina i blocchi di tracce archiviati una volta superata quell’età. - Un contratto di ingestione esportato. Il componente esporta l’host e la porta del suo ricevitore OTLP gRPC tramite la topologia
uses, così un produttore di tracce si connette a esso e vi invia gli span. - Immagini riproducibili. La Recipe fissa il tag dell’immagine del server Tempo da
infra.engine_version, così il carico di lavoro renderizzato fa riferimento a una versione fissata.
Generare l’esempio
Puoi eseguire la build di questo esempio con i comandi qui sotto, oppure farla eseguire al tuo assistente IA.
Scrivi l’esempio in una nuova cartella che porta il suo nome:
aggrega scaffold --example tempo-tracingPoi stampa i prossimi comandi da eseguire. Il primo ti porta nella nuova cartella:
cd tempo-tracingBuild
Questo workspace non contiene alcun .aggrega-config.yaml, quindi le entità della libreria standard vengono risolte dal registry dell’hub, hub.aggrega.ai, e non serve alcun flag di catalogo; --auto-pull scrive durante il build il lockfile che manca a un clone appena creato:
aggrega build --release release.yaml --auto-pullGli artefatti renderizzati finiscono sotto dist/. Il target sintetizzato non richiede il recupero di alcun chart esterno — la Recipe renderizza l’immagine ufficiale direttamente in uno StatefulSet, in Service e in un volume di dati.
Con un assistente AI
Un assistente IA configurato con gli strumenti di Aggrega può fare lo stesso: incolla questo prompt nell’assistente.
Usa solo gli strumenti di Aggrega e non creare tu alcuna cartella. Se la cartella dell’area di lavoro non contiene ancora una cartella `tempo-tracing`, chiama una volta lo strumento `scaffold` con `example` impostato su `tempo-tracing` e senza `dir`: scrive l’esempio in una nuova cartella `tempo-tracing`. Poi chiama lo strumento `build` con `workspace_root` impostato su `tempo-tracing`, `release` impostato su `release.yaml`, `auto_pull` impostato su true e `write` impostato su true. Dimmi quali file ha scritto la build; si trovano sotto `tempo-tracing/dist/`.Che cosa viene renderizzato
La build emette il server Tempo come quattro oggetti Kubernetes:
- uno
StatefulSet— il processo Tempo a binario singolo, con il suo store delle tracce su un volume persistente per ciascuna replica, - una
ConfigMap— la configurazione di Tempo, - un
ClusterIP Service— che espone il ricevitore OTLP gRPC sulla porta 4317, il ricevitore OTLP HTTP sulla 4318 e l’API di query HTTP sulla 3200, - un
Headless Service— l’identità di rete stabile dello StatefulSet, che espone le stesse porte.
Il tag dell’immagine di Tempo è fissato da infra.engine_version, così il carico di lavoro fa riferimento a un tag di immagine fissato.