İçeriğe geç
AggregaAggrega
Dil seçin: Türkçe
Bu sayfa makine çevirisiyle çevrilmiştir. İngilizce orijinalini okuyun.

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

DosyaRol
aggregate.yamlDeveloper niyeti: izleri yedi gün saklayan tek bir tracing bileşeni (core/observability/tempo).
manifest.yamlBileşen türünü sentezlenen Tempo Recipe’ine (tempo) eşler.
release.yamlKubernetes 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 bir ConfigMap ve iz alıcılarını ve HTTP sorgu API’sini açığa çıkaran bir ClusterIP ve Headless Service olarak oluşturur — kendi kendine yeten tek bir iş yükü.
  • Developer tarafından belirlenen saklama süresi. Geliştiricinin retention_period değ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 uses topolojisi ü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_version değ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:

Terminal window
aggrega scaffold --example tempo-tracing

Ardından sırada çalıştırılacak komutları yazdırır. İlki yeni klasöre geçer:

Terminal window
cd tempo-tracing

Derleme

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:

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

Oluş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.