Tab Request logs của
Developer Hub hiển thị lưu lượng API /v1 của
tổ chức Quý vị: các số liệu thống kê tóm tắt trong 24 giờ qua —
số lượng yêu cầu, tỷ lệ lỗi và số yêu cầu bị giới hạn tốc độ — phía trên một
nhật ký có thể tìm kiếm về từng yêu cầu riêng lẻ.
Mỗi mục ghi lại những gì
Bảng nhật ký hiển thị thời gian, phương thức HTTP, đường dẫn, trạng thái phản hồi, quyết định chính sách, độ trễ và mã yêu cầu (request ID) của từng lệnh gọi. Khi mở một mục, Quý vị sẽ thấy đầy đủ chi tiết,
bao gồm tài khoản dịch vụ và khóa API đã thực hiện lệnh gọi, địa chỉ IP nguồn
và các quyền đang có hiệu lực.
Quyết định chính sách cho biết yêu cầu đã được xử lý như thế nào:
- Allowed — yêu cầu đã được xác thực và cấp quyền.
- Denied — yêu cầu bị từ chối, ví dụ do khóa thiếu quyền
cần thiết, đã hết hạn hoặc đã bị thu hồi.
- Rate limited — yêu cầu đã vượt quá hạn mức yêu cầu và bị từ chối
với
429. Xem giới hạn tốc độ.
Lọc và tìm kiếm
Thu hẹp nhật ký theo tài khoản dịch vụ, khóa API, phương thức HTTP, nhóm trạng thái
(2xx–5xx), quyết định chính sách, khoảng thời gian hoặc tiền tố đường dẫn (ví dụ
/v1/entities).
Theo dõi lỗi bằng request ID
Mọi phản hồi API đều có tiêu đề Request-Id, và nội dung của mọi lỗi
đều có cùng giá trị đó trong trường request_id. Hãy dán giá trị này vào ô tìm kiếm
nhật ký yêu cầu để chuyển thẳng đến mục tương ứng và xem chính xác
yêu cầu đã được xử lý như thế nào.
Khi một tích hợp báo lỗi, hãy yêu cầu cung cấp request_id từ
phản hồi lỗi. Đây là cách nhanh nhất để đi từ triệu chứng phía khách hàng đến
bản ghi đáng tin cậy về những gì đã xảy ra — và cũng là giá trị cần cung cấp khi Quý vị
liên hệ bộ phận hỗ trợ của Living Security.
Phát hiện sớm các vấn đề
- Tỷ lệ lỗi tăng thường có nghĩa là một khóa đã hết hạn, bị thu hồi hoặc mất
một quyền cần thiết — hãy lọc theo quyết định để tìm ra thông tin xác thực bị lỗi.
- Số yêu cầu bị giới hạn tốc độ tăng có nghĩa là một tác vụ đang chạy quá tải; xem
giới hạn tốc độ để biết các chiến lược điều hòa lưu lượng.
- Lưu lượng từ một tài khoản dịch vụ lẽ ra phải không hoạt động là dấu hiệu cần kiểm tra
xem thông tin xác thực của tài khoản đó có đang nằm ở nơi Quý vị nghĩ hay không — và cần
vô hiệu hóa tài khoản trong
khi điều tra.