Nhật ký hoạt động

Nhật ký hoạt động (Activity Log) hiển thị các request API gần đây nhất của bạn theo thời gian thực. Hãy sử dụng công cụ này để debug các request riêng lẻ, kiểm tra mã response và xác minh rằng tích hợp của bạn đang hoạt động chính xác.

Những gì bạn sẽ thấy

Nhật ký hiển thị các request được thực hiện trong vòng một giờ qua, với các request mới nhất ở trên cùng. Mỗi bản ghi bao gồm:

Trường	Mô tả
Timestamp	Thời điểm request được thực hiện
Method	Phương thức HTTP được gửi đến mục tiêu (GET, POST, v.v.)
Route	Endpoint FourA nào đã được sử dụng (single, proxy hoặc browser)
Domain	Tên miền mục tiêu được trích xuất từ URL của request
Status	Mã HTTP status được trả về bởi mục tiêu
App Status	Trạng thái cấp ứng dụng được trả về trong response body
Outcome	Phân loại request (success, client_error, rate_limit, v.v.)
Duration	Tổng thời gian response tính bằng mili giây
Bytes In	Kích thước payload của request
Bytes Out	Kích thước payload của response
Key Name	API key nào đã được sử dụng
Client IP	Địa chỉ IP đã thực hiện request

Bộ lọc

Ba bộ điều khiển giúp thu hẹp phạm vi nhật ký.

Theo API Key

Sử dụng menu thả xuống API key để hiển thị các request từ một key cụ thể. Chỉ những key nằm trong phạm vi truy cập của bạn mới xuất hiện trong menu thả xuống.

Theo Sản phẩm

Lọc theo một endpoint bằng bộ chọn single / proxy / browser. Tính năng này hữu ích khi bạn muốn debug các lỗi chỉ xảy ra trên browser tách biệt với các request single.

Theo Giới hạn

Nhật ký hoạt động mặc định hiển thị 50 bản ghi. Sử dụng bộ chọn giới hạn để thay đổi số lượng bản ghi được hiển thị:

Giới hạn	Ghi chú
10	Quét nhanh
50	Mặc định
100	Chế độ xem mở rộng
200	Tối đa

Tất cả các bản ghi đều nằm trong vòng một giờ qua. Để xem dữ liệu lịch sử, hãy sử dụng phần Metrics, nơi tổng hợp dữ liệu theo ngày và tuần.

Mở một Request

Nhấp vào bất kỳ hàng nào để mở hộp thoại chi tiết với bản xem trước đầy đủ của request và response payload. Hộp thoại hiển thị:

Lưới meta: timestamp, key, HTTP status, app status, outcome, duration, và X-Foura-Request-Id của request.
Request: JSON định dạng đẹp (pretty-printed) của body chính xác đã gửi, kèm theo nút Copy.
Response: dải thông tin meta cùng với bản xem trước body, kèm theo các nhãn truncated và binary nếu áp dụng.

Payload được lưu trữ trong 24 giờ, giới hạn ở 200 bản ghi gần nhất cho mỗi API key. Các hàng cũ hơn thời gian đó sẽ chỉ hiển thị thông tin hàng mà không có hộp thoại chi tiết.

Thông báo trong khung Body

Khung body sử dụng các văn bản giữ chỗ khác nhau tùy thuộc vào điều gì đã xảy ra:

Thông báo	Ý nghĩa
`(no body — the request failed: <error>)`	Request gặp lỗi trước khi mục tiêu trả về body
`(no body captured)`	Payload đã quá hạn hoặc không được lưu trữ
`(empty body — the server returned 0 bytes)`	Mục tiêu đã trả về một response trống thực sự

Mở trong Playground

Hộp thoại chi tiết có nút Open in Playground. Nhấp vào nút này để tải cả request và response đã lưu trữ vào biểu mẫu Playground. Từ đó, bạn có thể tinh chỉnh các tham số và chạy lại (replay) với API thực tế, hoặc chỉ kiểm tra những gì được trả về mà không cần chạy lại request.

Nút này sẽ bị vô hiệu hóa đối với các payload không thể chạy lại (các đoạn request quá lớn và các route không phải API), kèm theo gợi ý giải thích lý do.

Sử dụng Request ID

Mỗi response API đều chứa một header X-Foura-Request-Id. Hãy ghi lại nhật ký này ở phía bạn, và bạn có thể dán nó vào phiếu hỗ trợ (support ticket) để chỉ ra chính xác request trong Nhật ký hoạt động (Activity Log). ID này trùng khớp với ID được sử dụng trong hộp thoại này và khớp với X-Foura-Request-Id do API trả về. Xem tài liệu tham khảo API Endpoints để biết thêm chi tiết.

Liên quan

Metrics and Analytics: Dữ liệu hiệu suất được tổng hợp qua các khoảng thời gian dài hơn
Playground: Chạy lại các request từ Nhật ký hoạt động (Activity)
API Endpoints: Cấu trúc request và response, bao gồm cả header request ID
Troubleshooting: Các vấn đề thường gặp và giải pháp

Cập nhật: 18 tháng 6, 2026