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.

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ệpVai 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.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 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 StatefulSet với một volume dữ liệu cho mỗi replica, một ConfigMap chứa cấu hình Tempo, và một ClusterIP và Headless Service cung 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_period củ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ó:

Terminal window
aggrega scaffold --example tempo-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 tempo-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; --auto-pull ghi trong lúc build lockfile mà một bản clone mới còn thiếu:

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

Cá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.