[Part 3] Thực hành với Headlamp: Kiểm tra trạng thái và quản lý Kubernetes resources

Sau khi cài đặt và kết nối cluster ở Part 2, câu hỏi tiếp theo là: “Tôi mở Headlamp lên. Bây giờ dùng nó như thế nào?” Bài viết tập trung vào các tình huống kiểm tra thường gặp. Những thao tác thay đổi resource chỉ nên thực hiện khi có đủ quyền và tuân thủ quy trình vận hành của cluster.
Làm quen với giao diện Headlamp
Các khu vực chính trên giao diện:
- Cluster: chọn cluster đang làm việc ở trang Home hoặc trên sidebar.
- Namespace: bộ lọc namespace phía trên danh sách resource.
- Điều hướng: sidebar nhóm resource theo Workloads, Network, Storage, Configuration, Cluster.
- Danh sách resource: click vào tên để mở trang chi tiết.
- Tìm kiếm: ô Search trên thanh công cụ để tìm nhanh resource.
Các resource hiển thị phụ thuộc quyền truy cập của người dùng và loại resource được Headlamp hỗ trợ.

Giám sát tổng quan Kubernetes cluster
Cluster → Nodes → Namespaces → WorkloadsĐi theo thứ tự này để trả lời các câu hỏi cơ bản:
- Cluster có những Node nào? Node ở trạng thái Ready hay NotReady?
- Có những Namespace nào?
- Các workload được triển khai ra sao? Trang Workloads có các biểu đồ tóm tắt số đối tượng theo từng loại (Pods, Deployments, StatefulSets, DaemonSets...), như ảnh ở trên.
- Pod nào đang gặp vấn đề về trạng thái hoặc số lần khởi động lại?
Kiểm tra workload và Deployment
Tình huống: ứng dụng vẫn chạy nhưng người dùng phản ánh dịch vụ có vấn đề. Người vận hành kiểm tra lần lượt:
Deployment → ReplicaSet → Pod → ContainerMở Workloads → Deployments, chọn Deployment của ứng dụng và kiểm tra:
- Desired / Available replicas: số replica mong muốn so với số replica sẵn sàng.
- Trạng thái Pod và số lần khởi động lại (Restarts).
- Requests/limits: CPU và memory khai báo trong cấu hình.
- Mức sử dụng thực tế: metrics CPU/memory, chỉ hiển thị khi cluster có nguồn metrics tương thích như metrics-server.
- Cấu hình: image, biến môi trường, ConfigMap/Secret được tham chiếu, xem trong YAML.
Cần phân biệt requests/limits (giá trị khai báo) với mức sử dụng thực tế (đo được từ metrics).
Dùng Map View
Map View giúp hình dung quan hệ giữa các resource được hỗ trợ trên cùng một màn hình.

Map View biểu diễn quan hệ giữa các resource, nhóm theo namespace. Nguồn: headlamp.dev
Lưu ý: Deployment sở hữu ReplicaSet và Pod theo quan hệ ownership, còn Service chọn Pod thông qua selector chứ không phải resource con của Deployment. Khi đọc sơ đồ, cần phân biệt hai loại quan hệ này.
Kiểm tra Pod và log
Tình huống: một Pod có trạng thái bất thường. Không cần chuyển ngay sang terminal, có thể mở trực tiếp Pod để xem thông tin và log.
Bước 1: Mở Workloads → Pods, chọn Pod cần kiểm tra. Trang chi tiết hiển thị trạng thái Pod và container, số lần khởi động lại, label, Node đang chạy và Events liên quan.

Bước 2: Chọn biểu tượng Show Logs trên thanh công cụ của Pod.

Bước 3: Chọn container và số dòng cần xem, sau đó sử dụng các tuỳ chọn:
- Follow: theo dõi log mới phát sinh trong lúc đang xem.
- Previous: xem log của lần chạy trước của container (khi container đã khởi động lại và dữ liệu còn khả dụng).
- Timestamps: hiển thị thời điểm của từng dòng log.

Bước 4: Tải log xuống bằng nút Download để đính kèm vào ticket hoặc gửi cho developer.

Các chức năng trên phục vụ xem log trực tiếp từ container; Headlamp không phải hệ thống log tập trung có lưu trữ dài hạn và truy vấn lịch sử (như Loki, Elasticsearch).
Thực thi lệnh trong container
Khi cần kiểm tra sâu hơn bên trong container, chọn biểu tượng Terminal / Exec. Thao tác này yêu cầu quyền create trên pods/exec, và chỉ dùng được khi container có shell (image dạng distroless thường không có).


Kiểm tra Events để tìm nguyên nhân
Khi Pod không hoạt động như mong đợi, Events là một trong những nguồn đầu tiên nên kiểm tra:
Pod không Running → Xem Events → Xác định dấu hiệu lỗi → Kết hợp log, cấu hình → Hướng xử lý| Dấu hiệu trong Events | Nguyên nhân có thể gặp | Hướng kiểm tra |
|---|---|---|
| FailedScheduling | Không đủ resource (CPU/memory), taint/affinity không phù hợp | Kiểm tra requests, Node, taint/toleration, affinity |
| ErrImagePull / ImagePullBackOff | Không tải được image | Kiểm tra tên/tag image, quyền truy cập registry, imagePullSecrets |
| FailedMount | Không mount được volume hoặc thiếu đối tượng cấu hình | Kiểm tra PVC, ConfigMap, Secret |
| Unhealthy | Probe thất bại hoặc ứng dụng chưa sẵn sàng | Kiểm tra cấu hình probe và log |
| BackOff (CrashLoopBackOff) | Container liên tục thoát và được khởi động lại | Xem log lần chạy trước (Previous), cấu hình, các phụ thuộc |
Events cung cấp manh mối nhưng không phải lúc nào cũng chỉ ra nguyên nhân gốc, và có thể hết hạn sau một khoảng thời gian (mặc định khoảng 1 giờ). Cần kết hợp với log, trạng thái và cấu hình resource. Events hiển thị trên trang chi tiết của từng resource và trong mục Cluster → Events.
Kiểm tra Service và kết nối ứng dụng
Deployment → Pod → ServicePod chạy bình thường nhưng ứng dụng vẫn không truy cập được? Mở Network → Services, chọn Service của ứng dụng và kiểm tra:
- Port / Target port: cổng của Service ánh xạ đúng tới cổng container đang lắng nghe.
- Selector: khớp với label của Pod.
- Endpoints: có địa chỉ Pod; nếu trống, thường do selector không khớp hoặc Pod chưa Ready.
- Ingress và NetworkPolicy: cấu hình định tuyến và chính sách mạng có thể ảnh hưởng đến luồng truy cập.
Cấu hình đúng trên giao diện chưa chứng minh kết nối thực tế hoạt động; khi cần, kiểm thử truy cập từ đúng nguồn (ví dụ từ một Pod khác hoặc từ phía người dùng).
Thực hiện các thao tác quản lý resource
Tuỳ phiên bản, loại resource và quyền được cấp, thanh công cụ trên trang chi tiết cung cấp các thao tác:
- Edit: chỉnh sửa resource qua trình soạn thảo YAML.
- Scale: thay đổi số replica, áp dụng cho workload hỗ trợ scale như Deployment, StatefulSet.
- Restart: khởi động lại workload hỗ trợ thao tác này (như Deployment, StatefulSet, DaemonSet).
- Delete: xoá resource.
- Create / Apply: nút dấu cộng cho phép dán hoặc tải lên manifest YAML để tạo resource.
Lưu ý: các thao tác thay đổi resource cần tuân thủ RBAC và quy trình vận hành của cluster. Với cluster được quản lý bằng GitOps (Argo CD, Flux), thay đổi trực tiếp trên giao diện có thể bị hệ thống đồng bộ ghi đè; khi đó nên cập nhật cấu hình trong Git.
Khi nào vẫn nên dùng kubectl?
| Headlamp | kubectl |
|---|---|
| Giám sát resource qua giao diện trực quan | Thao tác qua dòng lệnh |
| Thuận tiện xem chi tiết resource, log, Events | Linh hoạt với các lệnh chuyên biệt |
| Phù hợp các thao tác tương tác hằng ngày | Phù hợp viết script và tự động hoá |
| Các thao tác được cung cấp trên giao diện | Toàn bộ thao tác theo Kubernetes API và quyền truy cập |
Headlamp và kubectl có thể sử dụng song song. Headlamp bổ sung giao diện trực quan; kubectl vẫn cần thiết cho troubleshooting chuyên sâu, viết script và tự động hoá.
Kết luận series
- Nhẹ: Cài ngay trên laptop.
- Đơn giản: Kết nối cluster hiện có thông qua kubeconfig.
- Trực quan: Giám sát trạng thái và quản lý resource phổ biến.
Với nhu cầu kiểm tra trạng thái, log, Events và thực hiện các thao tác quản lý resource thường ngày, Headlamp là một giao diện trực quan bổ sung tốt bên cạnh kubectl, hệ thống monitoring và các công cụ vận hành hiện có.



