# Xử lý lỗi upload S3 và dọn dẹp tệp

### Mục tiêu <a href="#mc-tiu" id="mc-tiu"></a>

Hướng dẫn Admin xử lý sự cố khi upload tệp lên S3 thất bại (CV, tài liệu…) từ MBW\.Admin.\
Kết hợp dọn dẹp tệp lỗi/tệp không dùng để đảm bảo hệ thống ổn định, tránh chiếm dung lượng S3 không cần thiết.

***

### Dành cho ai <a href="#dnh-cho-ai" id="dnh-cho-ai"></a>

Org Admin / Chủ site – chịu trách nhiệm chung về hoạt động hệ thống và lưu trữ.\
Admin hệ thống / IT / DevOps – người kiểm tra cấu hình S3, kết nối, quota, và dọn dẹp tệp khi cần.\
Admin nghiệp vụ (ATS, TRM…) – người tiếp nhận phản ánh từ người dùng về lỗi upload file, phối hợp với IT.

***

### Khi nào dùng <a href="#khi-no-dng" id="khi-no-dng"></a>

Người dùng báo không upload được tệp (CV, tài liệu…), hoặc upload xong nhưng không thấy file.\
Hệ thống hiển thị lỗi liên quan tới kết nối S3 khi xử lý file/backup (Ping S3 fail).\
Phát hiện tệp lỗi/không hoàn chỉnh hoặc tệp tạm không còn dùng nhưng vẫn chiếm dung lượng lớn trên S3.

***

### Hướng dẫn <a href="#hng-dn" id="hng-dn"></a>

#### 1. Xác định triệu chứng lỗi upload S3 <a href="#id-1-xc-nh-triu-chng-li-upload-s3" id="id-1-xc-nh-triu-chng-li-upload-s3"></a>

Thu thập thông tin từ người dùng:

* Lỗi xuất hiện khi upload:
  * Không upload được tệp (thông báo lỗi trên UI).
  * Upload xong nhưng không xem/tải lại được file.
* Thời điểm bắt đầu gặp lỗi: mới xuất hiện hay đã lâu.
* Loại tệp, dung lượng tệp (file quá lớn, định dạng lạ…).

Đồng thời kiểm tra:

* Có nhiều người dùng bị hay chỉ một người.
* Các tính năng khác (không dùng file) vẫn hoạt động bình thường.

#### 2. Kiểm tra cấu hình điểm lưu và kết nối S3 <a href="#id-2-kim-tra-cu-hnh-im-lu-v-kt-ni-s3" id="id-2-kim-tra-cu-hnh-im-lu-v-kt-ni-s3"></a>

Đăng nhập MBW\.Admin bằng tài khoản Org Admin/IT.\
Vào Cấu hình chung hệ thống (TAB Cấu hình chung).

Trong khối Sao lưu & Lưu trữ kiểm tra:

* Điểm lưu hiện tại là S3 (hoặc GCS/Local).
* Nếu đang dùng S3, nhấn Ping S3 để kiểm tra kết nối (“Test SMTP, Ping S3 hiển thị kết quả thành công/thất bại”).

Kết quả:

* Nếu Ping S3 thất bại → lỗi nhiều khả năng do kết nối/bucket/credentials.
* Nếu Ping S3 thành công → lỗi có thể ở mức ứng dụng (dung lượng, quyền, loại file).

Trong trường hợp Ping fail:

* IT/DevOps kiểm tra lại trên phía cloud:
  * Thông tin bucket, IAM permission, network, key/secret.
* Sau khi chỉnh sửa, Ping lại để đảm bảo kết nối ổn trước khi thử upload lại.

#### 3. Kiểm tra dung lượng và quota lưu trữ <a href="#id-3-kim-tra-dung-lng-v-quota-lu-tr" id="id-3-kim-tra-dung-lng-v-quota-lu-tr"></a>

Trong MBW\.Admin:

* Vào Dữ liệu, sao lưu và tệp/S3 → Thống kê dữ liệu để xem tổng dung lượng dữ liệu.
* Vào trang Quản lý tệp (nếu có) để xem:
  * Tổng dung lượng tệp.
  * Nhóm tệp nào chiếm nhiều dung lượng nhất.

Trong TAB Cấu hình chung:

* Kiểm tra cảnh báo quota (phần “Cảnh báo quota – khi dung lượng file xuống thấp hơn mức dùng, UI ngăn lưu và hiển thị còn số hiện tại”).

Nếu site gần hoặc vượt quota:

* Có thể xảy ra tình huống upload bị từ chối/bị ngăn lưu.
* Cần:
  * Dọn dẹp tệp cũ (xem bước 4).
  * Hoặc nâng gói/dung lượng nếu dữ liệu cần giữ lại.

#### 4. Dọn dẹp tệp lỗi và tệp không còn dùng <a href="#id-4-dn-dp-tp-li-v-tp-khng-cn-dng" id="id-4-dn-dp-tp-li-v-tp-khng-cn-dng"></a>

Sau khi đảm bảo kết nối S3 ổn hoặc trong quá trình xử lý dung lượng, Admin nên dọn dẹp:

* Tìm tệp nghi ngờ lỗi/không dùng trong Quản lý tệp:
  * File rất lớn, tạo gần thời điểm xảy ra lỗi.
  * File không gắn với bản ghi nào hợp lệ (nếu UI hiển thị liên kết).
* Xóa tệp:
  * Xóa mềm: chuyển file vào Thùng rác (Trash) – có thể khôi phục nếu xóa nhầm.
  * Sau một thời gian, nếu chắc chắn không cần, có thể xóa vĩnh viễn từ Thùng rác để giải phóng dung lượng.
* Đối với file backup:
  * Vào TAB Cấu hình chung → phần Backup Retention:
    * Cân nhắc giảm số ngày giữ backup (ví dụ từ 365 xuống 180/90) để tự động giảm dung lượng S3.
    * Lưu ý: giảm retention cần xác nhận hai lần theo mô tả (hệ thống hiển thị cảnh báo khi giảm số ngày giữ backup).

***

### Lưu ý <a href="#lu" id="lu"></a>

Không vội thay đổi điểm lưu (S3 → Local/GCS) chỉ để giải quyết lỗi upload; nên xử lý đúng gốc: kết nối, quyền, quota, loại file.

Dọn dẹp file phải tuân thủ chính sách lưu trữ dữ liệu và quy định pháp lý (CV, hồ sơ nhân sự, tài liệu khách hàng). Nên ưu tiên xóa mềm trước, chỉ xóa vĩnh viễn khi chắc chắn.

Sau khi xử lý lỗi S3, nên cho người dùng thử upload lại với file kích thước vừa phải, định dạng phổ biến (PDF/DOCX) để xác nhận hệ thống đã hoạt động bình thường.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mhiring.vn/mbase/mbw-admin/du-lieu-sao-luu-va-tep-s3/xu-ly-loi-upload-s3-va-don-dep-tep.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.