Tempo — Kubernetes dağıtık izleme sunucusu
Bu örnek, küçük ama gerçek bir yığını — bir Grafana Tempo dağıtık izleme
sunucusunu — Developer tarafından yazılmış tek bir Aggregate’ten, resmi grafana/tempo imajı üzerinde Workload
sentezi yoluyla, tek ikili dosya biçiminde Kubernetes’e derler.
Tempo bir iz arka ucudur: span’leri OpenTelemetry protokolü (ve diğer izleme iletim biçimleri) üzerinden alır, bunları bir iz nesne deposunda saklar ve HTTP API’si üzerinden iz arama ve sorgu isteklerini yanıtlar. Tek ikili dosya biçiminde Tempo’nun her alt sistemi — distributor, ingester, querier, compactor — yerel bir iz deposuyla desteklenen tek bir süreç içinde çalışır; böylece sunucunun tamamı durum bilgili tek bir iş yüküdür. İzleme eklenmiş bir uygulama span’leri Tempo’nun OTLP alıcısına gönderir; bir panolar sunucusu da bunları sorgu API’si üzerinden geri okur.
Dosyalar
| Dosya | Rol |
|---|---|
aggregate.yaml | Developer niyeti: izleri yedi gün saklayan tek bir tracing bileşeni (core/observability/tempo). |
manifest.yaml | Bileşen türünü sentezlenen Tempo Recipe’ine (tempo) eşler. |
release.yaml | Kubernetes hedefi için operatör kaydı: sunucu hesaplama kaynakları ve iz deposu birim boyutu. |
Neyi gösteriyor
- Tek yazım yüzeyi. Tempo’nun ne olduğunun doğruluk kaynağı tek bir Aggregate’tir; Manifest ise onun nasıl gerçekleştirileceğini söyler.
- Tek ikili dosyalı bir iz arka ucu. Sentezlenen Recipe, Tempo’yu replika başına bir veri birimine sahip tek bir
StatefulSet, Tempo yapılandırmasını taşıyan tek birConfigMapve iz alıcılarını ve HTTP sorgu API’sini açığa çıkaran birClusterIPveHeadlessServiceolarak oluşturur — kendi kendine yeten tek bir iş yükü. - Developer tarafından belirlenen saklama süresi. Geliştiricinin
retention_perioddeğeri, süreç içi compactor’a aktarılır; compactor da saklanan iz bloklarını bu süreyi aştıklarında siler. - Dışa aktarılan bir alım sözleşmesi. Bileşen, OTLP gRPC
alıcısının ana bilgisayar adını ve portunu
usestopolojisi üzerinden dışa aktarır; böylece bir iz üreticisi ona bağlanır ve span’leri oraya gönderir. - Yeniden üretilebilir imajlar. Recipe, Tempo sunucu imaj etiketini
infra.engine_versiondeğerinden sabitler; böylece oluşturulan iş yükü sabitlenmiş bir sürüme başvurur.
Örneği oluşturun
Bu örneği aşağıdaki komutlarla derleyebilir ya da yapay zekâ asistanınıza sizin için derletebilirsiniz.
Örneği, adını taşıyan yeni bir klasöre yazın:
aggrega scaffold --example tempo-tracingArdından sırada çalıştırılacak komutları yazdırır. İlki yeni klasöre geçer:
cd tempo-tracingDerleme
Bu çalışma alanında .aggrega-config.yaml bulunmaz; bu nedenle standart kütüphane varlıkları hub kayıt defteri hub.aggrega.ai üzerinden çözümlenir ve katalog bayrağına gerek yoktur; --auto-pull, yeni bir klonda eksik olan kilit dosyasını derleme sırasında yazar:
aggrega build --release release.yaml --auto-pullOluşturulan yapıtlar dist/ altına yerleşir. Sentezlenen hedef harici bir
chart indirmesine ihtiyaç duymaz — Recipe resmi imajı doğrudan bir StatefulSet’e,
Service’lere ve bir veri birimine dönüştürür.
Bir yapay zekâ asistanıyla
Aggrega araçlarıyla kurulmuş bir yapay zekâ asistanı da aynısını yapabilir: bu istemi ona yapıştırın.
Yalnızca Aggrega araçlarını kullanın ve kendiniz hiçbir klasör oluşturmayın. Çalışma alanı klasöründe henüz bir `tempo-tracing` klasörü yoksa `scaffold` aracını `example` değeri `tempo-tracing` olarak ayarlanmış ve `dir` olmadan bir kez çağırın: örneği yeni bir `tempo-tracing` klasörüne yazar. Ardından `build` aracını `workspace_root` değeri `tempo-tracing`, `release` değeri `release.yaml`, `auto_pull` değeri true ve `write` değeri true olacak şekilde çağırın. Derlemenin hangi dosyaları yazdığını bana söyleyin; bunlar `tempo-tracing/dist/` altındadır.Neler oluşturulur
Derleme, Tempo sunucusunu dört Kubernetes nesnesi olarak üretir:
- bir
StatefulSet— iz deposu replika başına kalıcı bir birimde bulunan tek ikili dosyalı Tempo süreci, - bir
ConfigMap— Tempo yapılandırması, - bir
ClusterIP Service— OTLP gRPC alıcısını 4317’de, OTLP HTTP alıcısını 4318’de ve HTTP sorgu API’sini 3200’de açığa çıkarır, - bir
Headless Service— StatefulSet’in kararlı ağ kimliği; aynı portları açığa çıkarır.
Tempo imaj etiketi infra.engine_version değerinden sabitlenir; böylece iş yükü sabitlenmiş bir imaj etiketine başvurur.