Loki — máy chủ tổng hợp log trên Kubernetes
Ví dụ này biên dịch một stack nhỏ, thực tế — một máy chủ tổng hợp log Grafana Loki
— từ một Aggregate do Developer viết sang Kubernetes, dựa trên
Helm chart Grafana Loki chính thức ở dạng single-binary.
Loki là một backend log: nó nhận các luồng log qua HTTP push API, đánh chỉ mục chúng theo nhãn thay vì theo nội dung toàn văn, lưu chúng trong một kho đối tượng chunk, và trả lời các yêu cầu truy vấn log và truy vấn theo khoảng thời gian qua cùng HTTP API đó. Ở dạng single-binary, mọi hệ thống con của Loki — distributor, ingester, querier, compactor — chạy trong một tiến trình dựa trên một kho chunk cục bộ, nên toàn bộ máy chủ là một workload có trạng thái. Một công cụ vận chuyển log đẩy các luồng tới Loki; một máy chủ dashboard đọc chúng lại qua query API.
Các tệp
| Tệp | Vai trò |
|---|---|
aggregate.yaml | Ý định của Developer: một component logging duy nhất (core/observability/loki) lưu giữ log trong bảy ngày. |
manifest.yaml | Ánh xạ kiểu component tới Recipe có nguồn của Loki (loki). |
release.yaml | Bản ghi của Operator cho đích Kubernetes: tài nguyên tính toán của máy chủ và kích thước volume của kho chunk. |
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 về Loki là gì; Manifest cho biết cách hiện thực hóa nó.
- Một backend log single-binary. Recipe có nguồn kết xuất Loki thành một
StatefulSetvới một volume dữ liệu, cấu hình trong cácConfigMap, cácServicecông khai endpoint HTTP push-và-query, và mộtServiceAccount— một workload duy nhất, tự chứa, với các đường mở rộng phân tán và các dịch vụ phụ trợ đi kèm được tắt đi. - Thời gian lưu giữ do developer đặt.
retention_periodcủa developer được truyền vào compactor trong tiến trình, thành phần này xóa các luồng log đã lưu khi chúng cũ hơn giá trị đó. - Một hợp đồng tiếp nhận được xuất ra. Component xuất host và cổng dịch vụ
trong cluster của nó qua topology
uses, nên một công cụ vận chuyển log kết nối tới nó và đẩy các luồng vào đó. - Image có thể tái lập. Recipe ghim image máy chủ Loki và image sidecar tải lại cấu hình vào các tag có thể phân giải, để workload được kết xuất tham chiếu các 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 loki-loggingSau đó 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 loki-loggingBuild
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/. Bản build phân giải chart upstream theo
tham chiếu OCI khi chạy aggrega pull và ghim nó trong một lockfile.
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 `loki-logging`, hãy gọi công cụ `scaffold` một lần với `example` được đặt thành `loki-logging` và không có `dir`: công cụ này ghi ví dụ vào một thư mục `loki-logging` mới. Sau đó gọi công cụ `build` với `workspace_root` được đặt thành `loki-logging`, `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 `loki-logging/dist/`.Những gì được kết xuất
Bản build xuất máy chủ Loki thành một tập đối tượng Kubernetes duy nhất, tự chứa:
- một
StatefulSet— tiến trình Loki single-binary, với kho chunk trên một persistent volume, - các
ConfigMap— cấu hình Loki và cấu hình runtime, - các
Service— công khai endpoint HTTP push-và-query trên cổng 3100, - một
ServiceAccountcho workload, cùng các binding quyền truy cập của nó.
Không có workload read/write/backend phân tán, subchart kho đối tượng, cache hay operator nào được kết xuất — kết quả là một workload Loki duy nhất. Image máy chủ Loki và image sidecar tải lại cấu hình được ghim vào các tag release của chúng, nên workload tham chiếu các image đã ghim.