Bỏ qua đến nội dung chính

Automated debugging

📖 Nội dung bài học

Tóm tắt

Claude không chỉ dùng để viết code trong trình soạn thảo của bạn. Nó còn có thể giám sát các ứng dụng đang chạy thực tế (production) và tự động sửa lỗi ngay khi chúng phát sinh. Điều này tạo ra một quy trình gỡ lỗi tự động (automated debugging workflow) mạnh mẽ, giúp phát hiện và giải quyết vấn đề trước khi chúng ảnh hưởng đến người dùng.

Vấn đề: Lỗi chỉ xuất hiện trên Production

Một trong những kịch bản gỡ lỗi gây ức chế nhất là khi ứng dụng chạy hoàn hảo ở môi trường development nhưng lại thất bại trên production. Bạn có thể đã kiểm thử mọi thứ cục bộ, triển khai một cách tự tin, để rồi phát hiện ra một số tính năng không hoạt động trên môi trường thực tế.

Hãy xem xét một ứng dụng chatbot đơn giản hoạt động mượt mà khi test local. Bạn có thể đặt câu hỏi, tạo bảng tính với dữ liệu giả định, và mọi thứ phản hồi đúng như mong đợi. Nhưng khi bạn triển khai chính mã nguồn đó lên AWS Amplify và chạy các bài test tương tự, việc tạo bảng tính thất bại trong im lặng - yêu cầu vẫn được gửi đi, nhưng không có dữ liệu nào xuất hiện.

Cách tiếp cận gỡ lỗi truyền thống

Thông thường, bạn sẽ cần phải:

  • Lùng sục trong CloudWatch logs để tìm thông báo lỗi
  • Phân tích các chi tiết lỗi phức tạp và stack traces
  • Gỡ lỗi thủ công để tìm hiểu tại sao code lại chạy khác biệt trên production
  • Sửa lỗi và triển khai lại (redeploy)

Quá trình này rất tốn thời gian, đặc biệt là khi đối mặt với những thông báo lỗi mơ hồ như "The provided model identifier is invalid" nằm sâu trong hàng đống log.

Tự động phát hiện và sửa lỗi

Thay vì gỡ lỗi thủ công, bạn có thể tạo một GitHub Action chạy tự động hàng ngày để giám sát môi trường production. Quy trình này ủy thác toàn bộ việc gỡ lỗi cho Claude.

Đây là cách quy trình tự động vận hành:

  1. Thiết lập (Setup): GitHub Action kiểm tra (check out) repository, cài đặt các dependency và thiết lập Claude.
  2. Phân tích Log: Sử dụng AWS CLI để lấy CloudWatch logs trong 24 giờ qua.
  3. Xử lý lỗi: Claude phân tích logs, loại bỏ các lỗi trùng lặp và xác định các lỗi duy nhất.
  4. Triển khai bản sửa lỗi (Fix Implementation): Claude cố gắng sửa từng lỗi bằng cách chỉnh sửa mã nguồn tương ứng.
  5. Tạo Pull Request: Commit các bản sửa lỗi và tự động mở một pull request để bạn xem xét.

Ví dụ thực tế

Trong ví dụ về chatbot, Claude phát hiện ra rằng môi trường production đang sử dụng một mã định danh mô hình (model identifier) không hợp lệ. Lỗi xảy ra do một lỗi đánh máy trong model ID vốn chỉ được tham chiếu trong cấu hình production.

Claude đã xác định được vấn đề, tìm ra định dạng model ID chính xác và cập nhật file cấu hình. Bản sửa lỗi sau đó được commit kèm theo giải thích rõ ràng về những gì đã sai và cách nó được giải quyết.

Lợi ích của gỡ lỗi tự động

  • Giám sát chủ động: Phát hiện lỗi trước khi bạn kịp nhận ra chúng tồn tại.
  • Tiết kiệm thời gian: Loại bỏ các phiên tìm kiếm log và gỡ lỗi thủ công.
  • Tài liệu rõ ràng: Mỗi bản sửa lỗi đều đi kèm với giải thích chi tiết.
  • Quy trình xem xét: Pull requests cho phép bạn xác minh các bản sửa lỗi trước khi merge.
  • Cải thiện liên tục: Chạy tự động để bắt kịp các vấn đề mới phát sinh.

Các lưu ý khi triển khai

Khi thiết lập quy trình gỡ lỗi tự động:

  • Cấu hình quyền AWS phù hợp để truy cập CloudWatch.
  • Đặt giới hạn hợp lý cho số lượng lỗi được xử lý để nằm trong context window.
  • Thêm logic để loại bỏ các lỗi tương tự nhau (deduplicate).
  • Đảm bảo quy trình có quyền ghi (write permissions) vào repository để tạo pull requests.
  • Cân nhắc chạy quy trình vào các giờ thấp điểm.

Cách tiếp cận tự động này chuyển đổi việc gỡ lỗi từ một quá trình thủ công, mang tính đối phó thành một hệ thống tự động, chủ động, giúp ứng dụng của bạn vận hành trơn tru với sự can thiệp tối thiểu.

🔁 Bài học liên quan

📚 Nguồn & ghi nhận

Bài học có hữu ích không?

Góp ý / Báo lỗiPhát hiện sai sót hoặc có ý tưởng cải thiện?