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

Jaeger — backend di tracing a nodo singolo per Kubernetes

Questo esempio compila uno stack piccolo e reale — un backend di tracing distribuito Jaeger nella sua struttura a nodo singolo — a partire da un unico Aggregate scritto dallo sviluppatore per Kubernetes, sintetizzato direttamente dall’immagine ufficiale di Jaeger senza alcun chart upstream.

Jaeger è un backend di tracce: riceve span tramite il protocollo OpenTelemetry, li archivia in uno store chiave-valore locale incorporato e risponde alle query di consultazione e di ricerca delle tracce tramite la sua UI di query. Nella struttura a nodo singolo il ricevitore OTLP, lo scrittore dello storage e il servizio di query vengono eseguiti tutti all’interno di un unico processo supportato da uno store locale su disco, quindi l’intero server è un unico carico di lavoro con stato. Un’applicazione strumentata invia gli span al ricevitore OTLP di Jaeger; un operatore li rilegge dalla UI.

File

FileRuolo
aggregate.yamlIntento dello sviluppatore: un unico componente tracing (core/observability/jaeger).
manifest.yamlMappa il tipo di componente sulla Recipe di sintesi di Jaeger (jaeger).
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 è Jaeger; il Manifest dice come realizzarlo.
  • Un backend di tracce a nodo singolo. La Recipe di sintesi renderizza Jaeger come un unico StatefulSet con un volume di dati, una ConfigMap che contiene la configurazione di Jaeger v2 e due oggetti Service — un ClusterIP che espone i ricevitori e la UI, e un Service headless di governo per lo StatefulSet.
  • Configurazione fornita come file. Jaeger v2 è una distribuzione di OpenTelemetry Collector configurata da un file YAML. La Recipe emette quella configurazione come ConfigMap e la monta nel container in /etc/jaeger, e il container la legge con --config /etc/jaeger/config.yaml.
  • Tracce persistenti. Lo store chiave-valore incorporato scrive sul volume persistente in /badger, così i dati delle tracce sopravvivono ai riavvii.
  • 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 l’immagine del server Jaeger a un tag risolvibile, 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 jaeger-tracing

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

Terminal window
cd jaeger-tracing

Build

Questo workspace non contiene alcun .aggrega-config.yaml, quindi le entità della libreria standard si risolvono dal registry dell’hub, hub.aggrega.ai, e non serve alcun flag di catalogo:

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

Gli artefatti renderizzati finiscono sotto dist/. Il target Kubernetes renderizza manifest semplici offline — non è richiesto alcun pull di chart.

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 del workspace non contiene ancora una cartella `jaeger-tracing`, chiama una volta lo strumento `scaffold` con `example` impostato su `jaeger-tracing` e senza `dir`: scrive l’esempio in una nuova cartella `jaeger-tracing`. Poi chiama lo strumento `build` con `workspace_root` impostato su `jaeger-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 in `jaeger-tracing/dist/`.

Che cosa viene renderizzato

Il build emette il server Jaeger come quattro oggetti Kubernetes:

  • uno StatefulSet — il processo Jaeger a nodo singolo, con il suo store delle tracce incorporato su un volume persistente montato in /badger e la configurazione montata in /etc/jaeger,
  • una ConfigMap — la configurazione di Jaeger v2 (i ricevitori OTLP, il processore batch e lo store chiave-valore incorporato che scrive in /badger/key e /badger/data),
  • un Service ClusterIP — che espone il ricevitore OTLP gRPC sulla porta 4317, il ricevitore OTLP HTTP sulla 4318 e la UI di query sulla 16686,
  • un Service headless — il Service di governo che lo StatefulSet richiede per un’identità stabile di ciascuna replica.

L’immagine di Jaeger è fissata al suo tag di release, così il carico di lavoro fa riferimento a un tag di immagine fissato.