413 Thực thể yêu cầu quá lớn – TooBigBody

Giám sát API

Cách chẩn đoán lỗi bằng tính năng Giám sát API:

1. Đăng nhập vào giao diện người dùng Apigee Edge với tư cách là một người dùng có vai trò thích hợp.

2. Chuyển sang tổ chức mà bạn muốn điều tra vấn đề

   
3. Chuyển đến trang Phân tích > Giám sát API > Điều tra.
4. Chọn khung thời gian cụ thể mà bạn quan sát thấy lỗi.
5. Bạn có thể chọn bộ lọc Proxy để thu hẹp mã lỗi.
6. Vẽ Mã lỗi dựa trên Thời gian.

7. Chọn một ô có Mã lỗi protocol.http.TooBigBody và Mã trạng thái 413như bên dưới:

   

8. Thông tin về mã lỗi protocol.http.TooBigBody hiển thị như sau:

   
9. Nhấp vào Xem nhật ký rồi mở rộng hàng cho yêu cầu không thành công. Sau đó, trong cửa sổ Logs (Nhật ký), hãy lưu ý thông tin chi tiết như sau :

   Không nén

   Tình huống 1: Yêu cầu tải trọng được gửi ở dạng không nén

   

   Trong cửa sổ Nhật ký, hãy lưu ý những thông tin chi tiết sau:

   • Mã trạng thái: 413
   • Nguồn lỗi: proxy
   • Mã lỗi: protocol.http.TooBigBody.
   • Độ dài yêu cầu(byte): 15360440 (~15 MB)

   Nếu Nguồn lỗi có giá trị proxy, thì Mã lỗi sẽ có giá trị protocol.http.TooBigBody và Độ dài yêu cầu lớn hơn 10 MB, thì tức là yêu cầu HTTP từ ứng dụng có kích thước tải trọng yêu cầu lớn hơn giới hạn được cho phép trong Apigee.

   Đã nén

   Tình huống 2: Yêu cầu tải trọng được gửi ở dạng nén

   

   Trong cửa sổ Logs (Nhật ký), hãy lưu ý những thông tin chi tiết sau:

   • Mã trạng thái: 413
   • Nguồn lỗi: proxy
   • Mã lỗi: protocol.http.TooBigBody.
   • Độ dài yêu cầu(byte): 15264 (~15kB)

   Nếu Nguồn lỗi có giá trị proxy, thì Mã lỗi sẽ có giá trị protocol.http.TooBigBody và Độ dài yêu cầu nhỏ hơn 10 MB, thì tức là yêu cầu HTTP từ ứng dụng có kích thước tải trọng yêu cầu thấp hơn giới hạn cho phép ở định dạng nén, nhưng kích thước tải trọng lớn hơn giới hạn cho phép khi được giải nén bằng Apigee.

Trace

Cách chẩn đoán lỗi bằng công cụ Theo dõi:

1. Bật tính năng phiên theo dõi và
   • Chờ lỗi 413 Request Entity Too Large xảy ra hoặc
   • Nếu bạn có thể tái hiện vấn đề đó, hãy thực hiện lệnh gọi API và tái hiện lỗi 413 Request Entity Too Large

2. Nhớ bật tuỳ chọn Hiển thị tất cả thông tin luồng.

   
3. Chọn một trong các yêu cầu không thành công rồi kiểm tra dấu vết.
4. Chuyển đến giai đoạn Đã nhận yêu cầu từ ứng dụng.

   Không nén

   Tình huống 1: Yêu cầu tải trọng được gửi ở dạng không nén

   

   Xin lưu ý những thông tin sau:

   • Mã hoá nội dung: không có
   • Content-Length: 15360204

   Đã nén

   Tình huống 2: Yêu cầu tải trọng được gửi ở dạng nén

   

   Xin lưu ý những thông tin sau:

   • Mã hoá nội dung: gzip
   • Content-Length: 14969
   • Loại nội dung: application/x-gzip
5. Di chuyển qua các giai đoạn trong quá trình theo dõi và xác định vị trí xảy ra lỗi.

6. Bạn thường sẽ thấy lỗi này trong một quy trình sau giai đoạn Yêu cầu nhận được từ ứng dụng như minh hoạ dưới đây:

   
7. Ghi lại giá trị của lỗi trong dấu vết. Dấu vết mẫu ở trên cho thấy:
   • lỗi: Body buffer overflow
   • error.class: com.apigee.errors.http.user.RequestTooLarge

8. Chuyển đến Response Sent to Client (Phản hồi được gửi tới ứng dụng khách) và ghi lại các giá trị của lỗi trong dấu vết. Dấu vết mẫu dưới đây cho thấy:

   • lỗi: 413 Request Entity Too Large
   • Nội dung lỗi: {"fault":{"faultstring":"Body buffer overflow","detail":{"errorcode":"protocol.http.TooBigBody"}}}
   
9. Chuyển đến Giai đoạn AX (Dữ liệu phân tích được ghi lại) trong dấu vết rồi nhấp vào đó.

10. Trong mục Chi tiết giai đoạn, hãy cuộn xuống mục Đọc biến.

    
11. Xác định giá trị của biến client.forward.content.length, cho biết rằng:
    • Kích thước thực tế của tải trọng yêu cầu khi nó được gửi ở định dạng không nén và
    • Kích thước của tải trọng yêu cầu khi giải nén bằng Apigee, khi tải trọng được gửi ở định dạng nén. Giá trị này sẽ luôn bằng với giá trị giới hạn cho phép (10 MB) trong trường hợp này.

    Không nén

    Tình huống 1: Yêu cầu tải trọng ở dạng không nén

    

    Biến client.received.content.length: 15360204

    Đã nén

    Tình huống 2: Yêu cầu trọng tải ở định dạng nén

    

    Biến client.received.content.length: 10489856

12. Bảng sau đây giải thích lý do Apigee được Apigee trả về lỗi 413 trong 2 trường hợp này dựa trên giá trị của biến client.received.content.length:

    Trường hợp	Giá trị của client.forward.content.length	Lý do không thành công
    Yêu cầu tải trọng ở định dạng không nén	Khoảng 15 MB	Kích thước > giới hạn cho phép là 10 MB.
    Tải trọng yêu cầu ở định dạng nén	Khoảng 10 MB	Đã vượt quá giới hạn kích thước khi giải nén

NGINX

Cách chẩn đoán lỗi bằng nhật ký truy cập NGINX:

1. Nếu là người dùng Đám mây riêng tư, bạn có thể dùng nhật ký truy cập NGINX để xác định thông tin chính về lỗi HTTP 413.

2. Kiểm tra nhật ký truy cập NGINX:

   /opt/apigee/var/log/edge-router/nginx/ORG~ENV.PORT#_access_log

3. Tìm kiếm xem có lỗi 413 nào trong một khoảng thời gian cụ thể hay không (nếu vấn đề đã xảy ra trong quá khứ) hoặc có yêu cầu nào vẫn không thành công với 413 hay không.
4. Nếu bạn tìm thấy bất kỳ lỗi 413 nào trong đó X-Apigee-fault-code khớp giá trị của X-Apigee-fault-code , thì hãy xác định giá trị của X-Apigee-fault-code

   Không nén

   Tình huống 1 : Yêu cầu kích thước tải trọng ở định dạng không nén

   

   Mục mẫu ở trên từ nhật ký truy cập NGINX có các giá trị sau đây cho X-Apigee-fault-code và X-Apigee-fault-code

   Tiêu đề phản hồi	Giá trị
   X-Apigee-fault-code	protocol.http.TooBigBody
   X-Apigee-fault-sourc	policy

   Lưu ý Độ dài yêu cầu: 15360440 (14,6 MB > giới hạn cho phép)

   Đã nén

   Tình huống 2 : Yêu cầu kích thước tải trọng ở định dạng nén

   

   Mục mẫu ở trên từ nhật ký truy cập NGINX có các giá trị sau đây cho X-Apigee-fault-code và X-Apigee-fault-code

   Tiêu đề phản hồi	Giá trị
   X-Apigee-fault-code	protocol.http.TooBigBody
   X-Apigee-fault-source	policy

   Lưu ý Độ dài yêu cầu: 15264 (14,9 K < giới hạn cho phép)

   Trong trường hợp này, Apigee Edge trả về 413 mặc dù Yêu cầu dài hơn thấp hơn giới hạn cho phép vì có thể yêu cầu đã được gửi ở định dạng nén và kích thước của tải trọng vượt quá giới hạn khi giải nén của Apigee Edge.

Cố định kích thước

Lựa chọn 1 [Nên dùng]: Khắc phục lỗi ứng dụng khách không gửi kích thước tải trọng lớn hơn giới hạn cho phép

1. Phân tích lý do khiến ứng dụng cụ thể gửi yêu cầu / kích thước tải trọng vượt quá giới hạn cho phép như xác định trong phần Giới hạn.

2. Nếu điều này là không mong muốn, hãy sửa đổi ứng dụng khách của bạn để ứng dụng gửi yêu cầu / kích thước tải trọng nhỏ hơn giới hạn cho phép.

   Trong ví dụ thảo luận ở trên, bạn có thể khắc phục vấn đề này bằng cách truyền một tệp có kích thước nhỏ hơn, giả sử tải trọng test5mbfile (với kích thước là 5 MB) như minh hoạ dưới đây:

   curl https://<host>/testtoobigbody -k -X POST -F file=@test5mbfile -v
   

3. Nếu điều này là mong muốn và bạn muốn gửi một yêu cầu/trọng tải nhiều hơn giới hạn cho phép, hãy chuyển đến các lựa chọn tiếp theo.

Mẫu URL đã ký

Lựa chọn 2 [Nên dùng]: Sử dụng mẫu URL đã ký trong Apigee Javachú thích cho ứng dụng

Đối với các tải trọng lớn hơn 10 MB, Apigee khuyến nghị sử dụng mẫu URL đã ký trong Apigee JavaAnnotation, được minh hoạ trong ví dụ về Edge Annotation: Signed URL Generator trên GitHub.

Phát trực tiếp

Lựa chọn 3 : Sử dụng tính năng phát trực tuyến

Nếu proxy API của bạn cần xử lý các yêu cầu và/hoặc phản hồi rất lớn, bạn có thể bật tính năng truyền trực tuyến trong Apigee.

CwC

Lựa chọn 4 : Sử dụng thuộc tính CwC để tăng hạn mức vùng đệm

Bạn chỉ nên sử dụng tuỳ chọn này khi không thể sử dụng bất kỳ tuỳ chọn đề xuất nào vì có thể có vấn đề về hiệu suất nếu tăng kích thước mặc định.

Apigee cung cấp một thuộc tính CwC cho phép tăng giới hạn kích thước tải trọng cho yêu cầu và phản hồi. Để biết thông tin chi tiết, hãy tham khảo bài viết Đặt giới hạn kích thước thông báo trên Bộ định tuyến hoặc Trình xử lý thư