Cần có gì trong báo cáo lỗi proxy

Cho bộ phận hỗ trợ biết bước thất bại và lỗi chính xác, thay vì chỉ nói «proxy không hoạt động». Báo cáo ngắn có thể dùng cấu trúc này:

Client and version:
Proxy protocol and port:
Attempt time and timezone:
Connection / overall timeout settings:
Last completed stage:
Exact error or numeric status:
Same target over an allowed direct route:
Same target through another comparable endpoint:

Mô tả giai đoạn là kết nối proxy, xác thực proxy, thiết lập đường hầm, TLS của đích hay phản hồi HTTP cuối cùng. Ví dụ, «proxy HTTP ở cổng 8080; TCP đã kết nối; CONNECT trả về 407; chưa có TLS của đích» xác định vấn đề mà không lộ thông tin đăng nhập. Với lỗi chứng chỉ, giữ loại lỗi và ngữ cảnh tên máy chủ mong đợi, che tên riêng khi cần.

Xem lại văn bản thực tế trước khi chia sẻ. Xóa userinfo của URL proxy, Proxy-Authorization, Authorization của đích, Cookie, Set-Cookie, giá trị truy vấn riêng tư và nội dung yêu cầu. Cookie phiên hoặc bearer token có thể cho quyền truy cập dù không giống mật khẩu. Cách che của công cụ có thể khác theo phiên bản và chế độ đầu ra; log chi tiết và dấu vết đầy đủ không nhất thiết che giống nhau.

Dùng dấu như REDACTED_PROXY_PASSWORD nhưng giữ tên tiêu đề, cấu trúc URL và lỗi dạng số nhìn thấy được. Đừng xóa toàn bộ trao đổi quanh lỗi. Chỉ chia sẻ điểm cuối riêng tư và chi tiết mạng trong kênh hỗ trợ phù hợp.

Nếu yêu cầu tối thiểu tới đích vô hại hoặc dịch vụ bạn kiểm soát tái hiện lỗi, hãy gửi nó thay cho dấu vết dữ liệu kinh doanh. Nếu lỗi chỉ xảy ra với đích gốc, hãy nói rõ: đổi đích làm thay đổi điều mà việc tái hiện chứng minh. Với proxy HTTP, yêu cầu curl có giới hạn thời gian có thể là ví dụ tối thiểu.