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
| File | Ruolo |
|---|---|
aggregate.yaml | Intento dello sviluppatore: un unico componente tracing (core/observability/jaeger). |
manifest.yaml | Mappa il tipo di componente sulla Recipe di sintesi di Jaeger (jaeger). |
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 è Jaeger; il Manifest dice come realizzarlo.
- Un backend di tracce a nodo singolo. La Recipe di sintesi renderizza Jaeger come un unico
StatefulSetcon un volume di dati, unaConfigMapche contiene la configurazione di Jaeger v2 e due oggettiService— unClusterIPche 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
ConfigMape 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:
aggrega scaffold --example jaeger-tracingPoi stampa i prossimi comandi da eseguire. Il primo ti porta nella nuova cartella:
cd jaeger-tracingBuild
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:
aggrega pull --release release.yamlaggrega build --release release.yamlGli 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/badgere 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/keye/badger/data), - un
ServiceClusterIP— che espone il ricevitore OTLP gRPC sulla porta 4317, il ricevitore OTLP HTTP sulla 4318 e la UI di query sulla 16686, - un
Serviceheadless — 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.