Salta ai contenuti
AggregaAggrega
Seleziona lingua: Italiano
Questa pagina è stata tradotta automaticamente. Leggi l’originale in inglese.

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

FileRuolo
aggregate.yamlIntento dello sviluppatore: un unico componente tracing (core/observability/tempo) che conserva le tracce per sette giorni.
manifest.yamlMappa il tipo di componente sulla Recipe di Tempo sintetizzata (tempo).
release.yamlDocumento 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 StatefulSet con un volume di dati per ciascuna replica, una ConfigMap che contiene la configurazione di Tempo, e un Service ClusterIP e uno Headless che espongono i ricevitori delle tracce e l’API di query HTTP — un unico carico di lavoro autonomo.
  • Conservazione impostata dallo sviluppatore. Il retention_period dello 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:

Terminal window
aggrega scaffold --example tempo-tracing

Poi stampa i prossimi comandi da eseguire. Il primo ti porta nella nuova cartella:

Terminal window
cd tempo-tracing

Build

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:

Terminal window
aggrega build --release release.yaml --auto-pull

Gli 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.