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ệp | Vai 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.yaml | Bả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
StatefulSetvới một volume dữ liệu, mộtConfigMapchứa cấu hình Jaeger v2, và hai đối tượngService— mộtClusterIPcô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
ConfigMapvà 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ó:
aggrega scaffold --example jaeger-tracingSau đó 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:
cd jaeger-tracingBuild
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:
aggrega pull --release release.yamlaggrega build --release release.yamlCá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/badgervà 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/keyvà/badger/data), - một
ClusterIPService— 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
Serviceheadless — 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.