Chủ Nhật, 04/10/2026, 17:00 (GMT+0)

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

Thumbnail Blog
Quay lại Trang chủ Blog
Trên trang này

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ợ.

Giao diện Headlamp với sidebar, ô tìm kiếm và bộ lọc namespace
Sidebar điều hướng, ô tìm kiếm và bộ lọc Namespaces. Nguồn: Alok Shankar, dev.to

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  →  Container

Mở 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 của Headlamp

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.

Trang chi tiết Pod trong Headlamp
Trang chi tiết Pod và thanh công cụ thao tác. Nguồn: Alok Shankar, dev.to

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

Biểu tượng Show Logs trên trang chi tiết Pod
Biểu tượng Show Logs. Nguồn: Alok Shankar, dev.to

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.
Trình xem log của Headlamp
Trình xem log: Container, Lines, Previous, Timestamps, Follow. Nguồn: Alok Shankar, dev.to

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.

Nút tải log xuống trong Headlamp
Nút tải log xuống. Nguồn: Alok Shankar, dev.to

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ó).

Nút Terminal/Exec trên trang chi tiết Pod
Biểu tượng Terminal / Exec. Nguồn: Alok Shankar, dev.to
Phiên terminal trong Headlamp
Thực thi lệnh bên trong container. Nguồn: Alok Shankar, dev.to 

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 EventsNguyên nhân có thể gặpHướng kiểm tra
FailedSchedulingKhông đủ resource (CPU/memory), taint/affinity không phù hợpKiểm tra requests, Node, taint/toleration, affinity
ErrImagePull / ImagePullBackOffKhông tải được imageKiểm tra tên/tag image, quyền truy cập registry, imagePullSecrets
FailedMountKhông mount được volume hoặc thiếu đối tượng cấu hìnhKiểm tra PVC, ConfigMap, Secret
UnhealthyProbe thất bại hoặc ứng dụng chưa sẵn sàngKiểm tra cấu hình probe và log
BackOff (CrashLoopBackOff)Container liên tục thoát và được khởi động lạiXem 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  →  Service

Pod 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?

Headlampkubectl
Giám sát resource qua giao diện trực quanThao tác qua dòng lệnh
Thuận tiện xem chi tiết resource, log, EventsLinh 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àyPhù hợp viết script và tự động hoá
Các thao tác được cung cấp trên giao diệnToà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ó.

Tài liệu tham khảo