Tempo — máy chủ truy vết phân tán trên Kubernetes
Ví dụ này biên dịch một stack nhỏ nhưng thực tế — một máy chủ truy vết phân tán Grafana Tempo
— từ một Aggregate do Developer viết sang Kubernetes thông qua tổng hợp Workload
trên image chính thức grafana/tempo, ở dạng một tệp nhị phân duy nhất.
Tempo là một backend lưu trữ trace: nó nhận các span qua giao thức OpenTelemetry (và các định dạng truyền tải truy vết khác), lưu chúng vào một kho đối tượng trace, và trả lời các truy vấn tra cứu và tìm kiếm trace qua HTTP API của nó. Ở dạng một tệp nhị phân duy nhất, mọi hệ thống con của Tempo — distributor, ingester, querier, compactor — chạy bên trong một tiến trình dựa trên một kho trace 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 các span tới bộ nhận OTLP của Tempo; một máy chủ dashboard đọc lại chúng qua API truy vấn.
Các tệp
| Tệp | Vai trò |
|---|---|
aggregate.yaml | Ý định của Developer: một component tracing duy nhất (core/observability/tempo) lưu giữ trace trong bảy ngày. |
manifest.yaml | Ánh xạ loại component sang Recipe Tempo được tổng hợp (tempo). |
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 duy nhất. Một Aggregate duy nhất là nguồn chân lý cho việc Tempo là gì; Manifest cho biết cách hiện thực hóa nó.
- Một trace backend dạng single-binary. Recipe được tổng hợp kết xuất Tempo thành một
StatefulSetvới một volume dữ liệu cho mỗi replica, mộtConfigMapchứa cấu hình Tempo, và mộtClusterIPvàHeadlessServicecung cấp các trace receiver và HTTP query API — một workload đơn lẻ, tự chứa đầy đủ. - Thời gian lưu giữ do developer đặt.
retention_periodcủa developer được truyền vào compactor chạy trong tiến trình, thành phần này xóa các khối trace đã lưu khi chúng cũ hơn khoảng thời gian đó. - 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 tạo. Recipe cố định tag image của máy chủ Tempo từ
infra.engine_versionđể workload được kết xuất tham chiếu tới 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 tempo-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 tempo-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; --auto-pull ghi trong lúc build lockfile mà một bản clone mới còn thiếu:
aggrega build --release release.yaml --auto-pullCác artifact được kết xuất nằm trong dist/. Target được tổng hợp không cần tải chart
bên ngoài — Recipe kết xuất trực tiếp image chính thức thành một StatefulSet,
các Service và một volume dữ liệu.
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ỉ 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 có thư mục `tempo-tracing`, hãy gọi công cụ `scaffold` một lần với `example` đặt thành `tempo-tracing` và không có `dir`: công cụ này ghi ví dụ vào một thư mục `tempo-tracing` mới. Sau đó gọi công cụ `build` với `workspace_root` đặt thành `tempo-tracing`, `release` đặt thành `release.yaml`, `auto_pull` đặt thành true và `write` đặt thành true. Hãy cho tôi biết lần build đã ghi những tệp nào; chúng nằm dưới `tempo-tracing/dist/`.Những gì được kết xuất
Bản build xuất máy chủ Tempo thành bốn đối tượng Kubernetes:
- một
StatefulSet— tiến trình Tempo dạng tệp nhị phân duy nhất, với kho trace nằm trên một persistent volume riêng cho mỗi bản sao, - một
ConfigMap— cấu hình Tempo, - 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à HTTP API truy vấn trên cổng 3200, - một
Headless Service— danh tính mạng ổn định của StatefulSet, công khai cùng các cổng đó.
Tag image Tempo được cố định từ infra.engine_version, nên workload tham chiếu tới một tag image đã ghim.