1. Chuẩn bị

  • Cụm Kubernetes
  • Đã cài đặt tool Helm v3

2. Cài đặt trên Rancher

Bước 1: Tại giao diện Rancher > Home > click chuột vào cụm K8s muốn cài k8s-agent-metrics:

Bước 2: Chọn namespace sẽ cài k8s-agent-metrics trên đó:

Bước 3: Chọn App > Chart > Chọn repo idg-system > Gõ tên chart k8s-agent-metrics > Click chuột vào chart đã tìm.

Bước 4: Mặc định chọn Chart version mới nhất, sau đó chọn Install để cài đặt.

Bước 5: Kiểm tra namspace tại hai vị trí 1 và 2 đã khớp > Chọn Next

Bước 6: Tại Option Resource Limit:

  • CPU Limit: Điền giới hạn CPU cho các pod của Agent.
  • Memory Limit: Điền giới hạn Memory cho các pod của Agent.
  • Agent Replicas: Điền số lượng bản sao cho các pod của Agent.

Bước 7: Tại Option Agent Config:

  • Remote Write Endpoint: Điền enpoint của dịch vụ APM (metrics) được cấp trên giao diện Console.
  • Remote Write Token: Điền token của dịch vụ APM (metrics)
  • Sau khi điền đầy đủ thông tin chọn Install

Bước 8: Sau khi cài đặt thành công sẽ thấy trạng thái của k8s-agent-metrics như hình:

3. Cài đặt dùng Helm chart

Download helm chart k8s-agent-metrics từ chart repo:

helm pull oci://ecr.idg.vnpt.vn/ecr-idg/grafana/alloy --version 1.10.1 
tar -xvzf alloy-1.10.1.tgz
cd alloy/config
vi example.alloy

Tiếp đó, chỉnh sửa cấu hình Alloy để lấy metrics, logs, trace từ dịch vụ mong muốn:

4. Kiểm tra

4.1 Kiểm tra dịch vụ

Kiểm tra pod Agent running:

 kubectl -n <namespace> get pod 

VD: Pod Agent cho dịch vụ K8s trên namespace test-ingress:

 kubectl -n test-ingress get pod 

4.2 Kiểm tra tích hợp

Tham khảo hướng dẫn tích hợp dashboard, kiểm tra trên dashboard để xác nhận metrics Kubernetes đã hiển thị: