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.

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ệpVai 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.yamlBả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 StatefulSet với một volume dữ liệu, cấu hình trong các ConfigMap, các Service công khai endpoint HTTP push-và-query, và một ServiceAccount — 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_period củ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ó:

Terminal window
aggrega scaffold --example loki-logging

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 loki-logging

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/. 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 ServiceAccount cho 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.