Bỏ qua để đến nội dung
AggregaAggrega
Chọn ngôn ngữ: Tiếng Việt
Trang này được dịch bằng máy. Đọc bản gốc tiếng Anh.

Jaeger — backend truy vết một nút trên Kubernetes

Ví dụ này biên dịch một stack nhỏ, có thật — một backend truy vết phân tán Jaeger ở dạng một nút — từ một Aggregate duy nhất do Developer viết sang Kubernetes, được tổng hợp trực tiếp từ image Jaeger chính thức mà không cần chart upstream.

Jaeger là một backend trace: nó nhận các span qua giao thức OpenTelemetry, lưu chúng trong một kho key-value nhúng cục bộ, và trả lời các truy vấn tra cứu và tìm kiếm trace qua UI truy vấn của nó. Ở dạng một nút, bộ nhận OTLP, bộ ghi lưu trữ và dịch vụ truy vấn đều chạy trong một tiến trình dựa trên một kho lưu trên đĩa cục bộ, nên toàn bộ máy chủ là một workload có trạng thái. Một ứng dụng được đo đạc đẩy span tới bộ nhận OTLP của Jaeger; người vận hành đọc lại chúng từ UI.

Các tệp

TệpVai trò
aggregate.yamlÝ định của Developer: một component tracing duy nhất (core/observability/jaeger).
manifest.yamlÁnh xạ kiểu component sang Recipe tổng hợp Jaeger (jaeger).
release.yamlBản ghi của người vận hành cho đích Kubernetes: tài nguyên tính toán của máy chủ và kích thước volume lưu trace.

Ví dụ này minh họa điều gì

  • Một bề mặt soạn thảo. Một Aggregate duy nhất là nguồn sự thật cho việc Jaeger là gì; Manifest cho biết cách hiện thực hóa nó.
  • Một backend trace một nút. Recipe tổng hợp kết xuất Jaeger thành một StatefulSet với một volume dữ liệu, một ConfigMap chứa cấu hình Jaeger v2, và hai đối tượng Service — một ClusterIP công khai các bộ nhận và UI, và một Service headless quản lý cho StatefulSet.
  • Cấu hình được cung cấp dưới dạng tệp. Jaeger v2 là một bản phân phối OpenTelemetry Collector được cấu hình bằng một tệp YAML. Recipe xuất cấu hình đó thành một ConfigMap và mount nó vào container tại /etc/jaeger, và container đọc nó bằng --config /etc/jaeger/config.yaml.
  • Trace bền vững. Kho key-value nhúng ghi vào volume bền vững tại /badger, nên dữ liệu trace vẫn tồn tại sau khi khởi động lại.
  • Một hợp đồng tiếp nhận được xuất ra. Component xuất host và port của bộ nhận OTLP gRPC qua topology uses, để một nguồn tạo trace kết nối tới nó và đẩy span vào đó.
  • Image có thể tái lập. Recipe ghim image máy chủ Jaeger vào một tag có thể phân giải, để workload được kết xuất tham chiếu một phiên bản đã ghim.

Tạo ví dụ

Bạn có thể build ví dụ này bằng các lệnh bên dưới, hoặc để trợ lý AI của bạn build giúp bạn.

Ghi ví dụ vào một thư mục mới đặt theo tên của nó:

Terminal window
aggrega scaffold --example jaeger-tracing

Sau đó nó in ra các lệnh cần chạy tiếp theo. Lệnh đầu tiên chuyển vào thư mục mới:

Terminal window
cd jaeger-tracing

Build

Workspace này không có .aggrega-config.yaml, nên các thực thể thư viện chuẩn được phân giải từ registry hub, hub.aggrega.ai, và không cần cờ catalog:

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

Các artifact được kết xuất nằm trong dist/. Đích Kubernetes kết xuất manifest thuần ở chế độ ngoại tuyến — không cần kéo chart.

Với trợ lý AI

Một trợ lý AI được thiết lập với các công cụ của Aggrega cũng có thể làm như vậy: hãy dán prompt này vào trợ lý.

Chỉ sử dụng các công cụ của Aggrega và không tự tạo thư mục nào. Nếu thư mục không gian làm việc chưa chứa thư mục `jaeger-tracing`, hãy gọi công cụ `scaffold` một lần với `example` được đặt thành `jaeger-tracing` và không có `dir`: công cụ này ghi ví dụ vào một thư mục `jaeger-tracing` mới. Sau đó gọi công cụ `build` với `workspace_root` được đặt thành `jaeger-tracing`, `release` được đặt thành `release.yaml`, `auto_pull` được đặt thành true và `write` được đặt thành true. Hãy cho tôi biết bản build đã ghi những tệp nào; chúng nằm trong `jaeger-tracing/dist/`.

Những gì được kết xuất

Bản build xuất máy chủ Jaeger thành bốn đối tượng Kubernetes:

  • một StatefulSet — tiến trình Jaeger một nút, với kho trace nhúng trên một volume bền vững được mount tại /badger và cấu hình được mount tại /etc/jaeger,
  • một ConfigMap — cấu hình Jaeger v2 (các bộ nhận OTLP, bộ xử lý batch, và kho key-value nhúng ghi vào /badger/key và /badger/data),
  • một ClusterIP Service — công khai bộ nhận OTLP gRPC trên cổng 4317, bộ nhận OTLP HTTP trên cổng 4318, và UI truy vấn trên cổng 16686,
  • một Service headless — Service quản lý mà StatefulSet yêu cầu để có danh tính ổn định cho từng bản sao.

Image Jaeger được ghim vào tag phát hành của nó, nên workload tham chiếu một image tag đã ghim.