Chuyển tới nội dung chính

Kiểm Tra Log Lỗi Trang Web trên cPanel

Giới Thiệu​

Log lỗi là một công cụ vô cùng quan trọng giúp bạn chẩn đoán và khắc phục sự cố trên trang web của mình. Khi trang web gặp vấn đề như hiển thị lỗi trắng (white screen of death), lỗi 500 Internal Server Error, hoặc các chức năng không hoạt động, log lỗi sẽ ghi lại chi tiết về nguyên nhân gốc rễ. Trong môi trường cPanel, bạn có thể dễ dàng truy cập và kiểm tra các log này để nhanh chóng xác định vấn đề và tìm ra giải pháp. Việc hiểu cách đọc và phân tích log lỗi là kỹ năng thiết yếu cho bất kỳ quản trị viên website nào.

Bài hướng dẫn này sẽ chỉ cho bạn hai phương pháp chính để kiểm tra log lỗi trong cPanel: sử dụng công cụ "Errors" và truy cập trực tiếp các tệp error_log thông qua File Manager.

📋 Thời gian: 5 phút | Độ khó: Cơ bản

Yêu Cầu​

Để thực hiện theo hướng dẫn này, bạn cần:

  • Quyền truy cập vào tài khoản cPanel của hosting của bạn.
  • Một trình duyệt web.
  • Kiến thức cơ bản về cấu trúc thư mục website (ví dụ: public_html).

Các Bước Thực Hiện​

Có hai phương pháp chính để kiểm tra log lỗi trong cPanel, mỗi phương pháp có ưu điểm riêng.

Bước 1: Sử dụng Công Cụ "Errors" của cPanel​

Công cụ "Errors" trong cPanel là cách nhanh nhất để xem các lỗi gần đây nhất mà trang web của bạn đã tạo ra. Công cụ này thường hiển thị 300 lỗi gần nhất được ghi lại trên cấp độ máy chủ và PHP, cung cấp cái nhìn tổng quan về các vấn đề phổ biến.

  1. Đăng nhập vào cPanel: Mở trình duyệt và truy cập vào địa chỉ cPanel của bạn (thường là yourdomain.com/cpanel hoặc yourdomain.com:2083). Nhập tên người dùng và mật khẩu để đăng nhập.

  2. Tìm và Truy cập "Errors": Sau khi đăng nhập, cuộn xuống phần Metrics (Số liệu thống kê) hoặc sử dụng thanh tìm kiếm để tìm kiếm "Errors".

    # Đăng nhập vào cPanel
    # Tìm mục "Metrics" (Số liệu thống kê)
    # Nhấp vào biểu tượng "Errors" (Lỗi)

  3. Xem Log Lỗi:

    • Trang "Errors" sẽ hiển thị danh sách các lỗi theo thứ tự thời gian, từ mới nhất đến cũ nhất.
    • Mỗi mục lỗi thường bao gồm thời gian xảy ra, loại lỗi, mô tả lỗi và đường dẫn đến tệp gây ra lỗi.
    • ⚠️ Lưu ý: Công cụ này chỉ hiển thị một số lượng giới hạn lỗi (thường là 300). Nếu trang web của bạn tạo ra quá nhiều lỗi, các lỗi cũ hơn có thể bị đẩy ra khỏi danh sách.

    💡 Mẹo: Công cụ "Errors" rất hữu ích để nhanh chóng phát hiện các lỗi phổ biến như lỗi cú pháp PHP, thiếu tệp hoặc quyền truy cập.

Bước 2: Truy cập Tệp error_log qua File Manager​

Phương pháp này cung cấp cái nhìn toàn diện hơn về tất cả các lỗi đã được ghi lại, không giới hạn số lượng lỗi như công cụ "Errors". Các tệp error_log thường được tạo tự động trong thư mục nơi lỗi xảy ra.

  1. Đăng nhập vào cPanel và Mở File Manager:

    • Đăng nhập vào cPanel của bạn.
    • Trong phần Files (Tệp), nhấp vào biểu tượng File Manager.
    # Đăng nhập vào cPanel
    # Tìm mục "Files" (Tệp)
    # Nhấp vào biểu tượng "File Manager"

  2. Điều hướng đến Thư mục Website:

    • Trong File Manager, bạn sẽ thấy cấu trúc thư mục hosting của mình. Thư mục gốc của trang web chính thường là public_html.
    • Nếu lỗi xảy ra trên một tên miền phụ hoặc thư mục con cụ thể, bạn cần điều hướng đến thư mục đó (ví dụ: public_html/subdomain hoặc public_html/my-app).
    # Trong File Manager, điều hướng đến thư mục gốc của website (ví dụ: public_html)
    # Hoặc điều hướng đến thư mục cụ thể nơi bạn nghi ngờ lỗi xảy ra

  3. Tìm Tệp error_log:

    • Trong thư mục bạn đang xem, tìm kiếm các tệp có tên là error_log.
    • ⚠️ Lưu ý: Một trang web có thể có nhiều tệp error_log khác nhau, mỗi tệp nằm trong thư mục nơi lỗi cụ thể đó xảy ra. Ví dụ, một lỗi trong public_html/wp-content/themes/mytheme/ có thể tạo ra error_log ngay trong thư mục mytheme.
    • Các tệp error_log có thể có kích thước rất lớn nếu trang web gặp nhiều lỗi.

  4. Xem hoặc Tải xuống Tệp error_log:

    • Để xem nhanh: Nhấp chuột phải vào tệp error_log và chọn View (Xem). Một cửa sổ mới sẽ mở ra hiển thị nội dung của tệp.
    • Để phân tích chi tiết hơn: Nhấp chuột phải vào tệp error_log và chọn Download (Tải xuống). Sau đó, bạn có thể mở tệp bằng một trình soạn thảo văn bản mạnh mẽ hơn trên máy tính của mình (như VS Code, Sublime Text, Notepad++), điều này đặc biệt hữu ích với các tệp log lớn.
    # Tìm kiếm các tệp có tên "error_log" trong thư mục hiện tại
    # Nhấp chuột phải vào tệp "error_log"
    # Chọn "View" để xem nội dung trực tiếp trong trình duyệt
    # Hoặc chọn "Download" để tải về và phân tích trên máy tính

  5. Phân tích nđi dung Log:

    • Mỗi dòng trong error_log thường bắt đầu bằng ngày và giờ, theo sau là loại lỗi, mô tả chi tiết và đường dẫn tệp bị ảnh hưởng cùng với số dòng.
    • Hãy chú ý đến các thông báo lỗi như Parse error, Fatal error, Warning, Notice. Các lỗi Fatal error thường là nguyên nhân khiến trang web ngừng hoạt động.
    • Tìm kiếm các đường dẫn tệp để xác định vị trí chính xác của vấn đề (ví dụ: wp-content/plugins/your-plugin/your-file.php).

Troubleshooting​

  • Không thấy lỗi nào trong công cụ "Errors" nhưng trang web vẫn gặp sự cố:

    • Lỗi có thể đã xảy ra từ lâu và không còn nằm trong 300 lỗi gần nhất mà công cụ này hiển thị.
    • Lỗi đang xảy ra ở một thư mục cụ thể và được ghi vào tệp error_log riêng trong thư mục đó, không được công cụ "Errors" tổng hợp.
    • Website có thể đang gặp lỗi không phải do PHP hoặc server (ví dụ: lỗi JavaScript phía client), mà công cụ này không theo dõi. Hãy kiểm tra console trình duyệt (F12) để tìm lỗi JavaScript.
    • Đảm bảo rằng log_errors được bật trong cấu hình PHP của bạn. Bạn có thể kiđm tra qua Select PHP Version trong cPanel.

  • Tệp error_log quá lớn và khó đọc:

    • Tải xuống tệp và mở bằng một trình soạn thảo văn bản chuyên dụng có khả năng xử lý tệp lớn (ví dụ: VS Code, Sublime Text).
    • Sử dụng chức năng tìm kiếm (Ctrl+F hoặc Cmd+F) trong trình soạn thảo để tìm kiếm các từ khóa như "Fatal error", "Parse error", hoặc ngày giờ cụ thể.
    • Nếu tệp quá lớn do lỗi lặp đi lặp lại, hãy thử xóa tệp (sau khi đã xem xét và sao lưu) để tạo một tệp log mới, sạch hơn. ✅ Điều này sẽ giúp bạn theo dõi các lỗi mới dễ dàng hơn.

  • Tệp error_log không tồn tại hoặc không được cập nhật:

    • Đảm bảo rằng lỗi thực sự đang xảy ra.
    • Kiểm tra quyền truy cập của thư mục. Máy chủ cần có quyền ghi vào thư mục để tạo hoặc cập nhật tệp error_log. Quyền 755 cho thư mục và 644 cho tệp thường là an toàn.
    • Kiểm tra cấu hình PHP của bạn: đảm bảo log_errors được bật và error_reporting được đặt ở mức phù hợp để ghi lại các loại lỗi bạn muốn theo dõi.

Kết Luận​

Kiểm tra log lỗi trong cPanel là một kỹ năng không thể thiếu để duy trì sự ổn định và hiệu suất của trang web. Dù bạn sử dụng công cụ "Errors" để có cái nhìn tổng quan nhanh chóng hay đào sâu vào các tệp error_log thông qua File Manager, việc hiểu được ý nghĩa của các thông báo lỗi sẽ giúp bạn xác định và khắc phục vấn đề một cách nhanh chóng.

Best practices:

  • Kiểm tra log thường xuyên: Đặc biệt sau khi thực hiện các thay đổi lớn cho trang web (cài đặt plugin/theme mới, cập nhật mã nguồn).
  • Khắc phục lỗi ngay khi phát hiện: Đừng để các lỗi nhỏ tích tụ, chúng có thể gây ra vấn đề lớn hơn sau này.
  • Xóa hoặc lưu trữ log cũ: Sau khi đã khắc phục lỗi, bạn có thể xóa tệp error_log hoặc di chuyển chúng đến một thư mục lưu trữ để giữ cho các tệp log hiện tại dễ quản lý và không chiếm quá nhiều dung lượng.
  • Hiểu các loại lỗi: Nắm vững sự khác biệt giữa Fatal Error, Parse Error, Warning, và Notice để ưu tiên khắc phục các vấn đề nghiêm trọng trước.

Bằng cách áp dụng các bước và mẹo này, bạn sẽ có thể quản lý và gỡ lỗi trang web của mình trên cPanel một cách hiệu quả hơn.

Xem thêm: