Nhật ký hoạt động
Activity Log hiển thị lưu lượng truy cập gần đây nhất của bạn theo thời gian thực. Sử dụng nhật ký này để debug từng lệnh gọi riêng lẻ, kiểm tra mã response và xác minh hoạt động của tích hợp mới.
Product
Trang mở ra với nút chuyển đổi Product: API cho các request bạn gửi đến các API endpoint, Proxy cho các tunnel mà công cụ của riêng bạn mở qua proxy.foura.ai. Cả hai luồng dữ liệu đều bao gồm một giờ qua và đều dùng chung bộ chọn giới hạn (limit). Lựa chọn chuyển đổi này được ghi nhớ và hỗ trợ liên kết sâu dưới dạng #activity/proxy.
Phần còn lại của trang này sẽ mô tả luồng API trước, sau đó đến luồng Proxy.
Những gì bạn sẽ thấy trên luồng API
Nhật ký hiển thị các request được thực hiện trong vòng một giờ qua, với request gần đây nhất ở trên cùng. Chín cột hiển thị toàn bộ hàng:
| Cột | Nội dung hiển thị |
|---|---|
| Time | Thời điểm request được thực hiện |
| Key | API key nào đã được sử dụng |
| Request | Bản thân lệnh gọi: ký hiệu endpoint có màu (Single, Proxy, Browser, hoặc Auto), HTTP method và domain đích. Sắp xếp theo domain. |
| Status | Hai giá trị trong một ô, phân tách bằng dấu gạch chéo: HTTP status của lệnh gọi đến FourA, sau đó là status mà máy chủ đích trả về. Dấu gạch ngang nghĩa là máy chủ đích không phản hồi. |
| Outcome | Phân loại request (Success, Client Error, Rate Limited, v.v.) |
| Duration | Tổng thời gian phản hồi tính bằng mili giây |
| Bytes | Dữ liệu truyền tải cả hai chiều trong một ô: mũi tên xuống cho payload của request, mũi tên lên cho response. Hàng sử dụng lưu lượng premium sẽ có dấu premium trên ô này, bao gồm cả trường hợp đã thử exit premium nhưng pool tiêu chuẩn trả lời; lưu lượng đó được tính vào lưu lượng premium của bạn. |
| Credits | Số credit đã dùng cho lệnh gọi (xem Response Headers) |
| Client IP | Địa chỉ đã thực hiện request. Các request gửi từ Playground hoặc MCP do FourA lưu trữ sẽ hiển thị FourA thay vì một địa chỉ. |
Nhấp vào bất kỳ tiêu đề cột nào để sắp xếp bảng theo cột đó; thứ tự chuyển đổi lần lượt là giảm dần, tăng dần, sau đó tắt sắp xếp. Nhấn Ctrl hoặc Cmd rồi nhấp để đặt lại về mặc định (mới nhất lên đầu).
Lọc
Bốn bộ điều khiển giúp thu hẹp nhật ký.
Theo Owner
Nếu bạn thuộc về ít nhất một tổ chức, menu thả xuống Owner sẽ xuất hiện đầu tiên: Everything, Personal, hoặc một trong các tổ chức của bạn. Việc thay đổi tùy chọn này sẽ tạo lại danh sách thả xuống key bên cạnh, nhờ đó key thuộc về owner trước đó không thể tồn tại sau khi chuyển đổi và âm thầm không trả về kết quả gì. Bộ điều khiển tương tự trên Overview, Metrics và API Keys cũng tuân theo lựa chọn của bạn. Xem Organizations.
Theo API Key
Sử dụng menu thả xuống API key để hiển thị các request từ một key. Chỉ những key bạn có quyền truy cập mới xuất hiện: key cá nhân của bạn và key của các tổ chức bạn tham gia.
Theo Endpoint
Khi Product được đặt là API, hãy lọc về một endpoint bằng các thẻ Single / Proxy Finder / Browser / Auto. Hữu ích khi bạn muốn debug riêng các lỗi chỉ xảy ra trên browser tách biệt khỏi các request đơn lẻ. Auto liệt kê các lệnh gọi Auto của bạn, mỗi lệnh một hàng.
Theo Limit
Nhật ký hoạt động mặc định hiển thị 50 mục. Sử dụng bộ chọn giới hạn để thay đổi số lượng mụ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 mục đều thuộc về một giờ qua. Để xem dữ liệu lịch sử, hãy dùng phần Metrics, nơi tổng hợp dữ liệu theo ngày và tuần.
Lời gọi Auto
Một hàng Auto tương ứng với một lời gọi. Dòng thứ hai cho biết số lần thử Auto đã thực hiện và số lần thành công, đồng thời Credits và Bytes là tổng của các lần thử đó. Trong vài giây sau khi lời gọi kết thúc, trạng thái sẽ hiển thị attempts settling…, sau đó hàng sẽ tự điền dữ liệu. Lời gọi bị từ chối trước khi Auto thử bất kỳ thao tác nào sẽ hiển thị no attempts recorded.
Mở hàng để xem bảng Attempts: Engine, Rung, Status, Outcome, Time, Bytes, Credits. Các lần thử được tính vào giới hạn Single, Proxy Finder và Browser của bạn, không tính vào số lượng request hoặc tỷ lệ thành công.
Mở một Request
Nhấp vào bất kỳ hàng nào để mở bảng chi tiết với bản xem trước đầy đủ của payload request và response. Bảng mở ra trên một lưới meta được tạo từ chính hàng đó, do đó nó vẫn hữu ích ngay cả sau khi payload được lưu trữ đã hết hạn: timestamp, key, HTTP status, app status, outcome, duration, credits, proxy và X-FourA-Request-Id của request.
Bên dưới lưới, mỗi lần chỉ hiển thị một ngăn, được chọn theo tab:
| Tab | Nội dung hiển thị |
|---|---|
| Request | JSON được định dạng đẹp mắt của chính xác phần body đã gửi |
| Response headers | Các header mà mục tiêu trả về, mỗi block cho một bước chuyển hướng (redirect hop). Khi mục tiêu chuyển hướng, tab sẽ hiển thị số lượng bước chuyển hướng. |
| Response body | Bản xem trước body đã lưu trữ, kèm theo nhãn truncated và binary khi áp dụng |
| Other fields | Bất kỳ thông tin nào khác mà engine trả về ngoài status, timings, proxy và headers. Bị ẩn khi không có dữ liệu bổ sung. |
Nút Copy dùng để sao chép nội dung của ngăn đang mở. Payload được lưu giữ trong 24 giờ, giới hạn tối đa 200 bản ghi gần nhất cho mỗi API key. Các hàng cũ hơn khoảng thời gian này sẽ chỉ hiển thị thông tin hàng mà không có payload.
Thông báo trong ngăn Body
Ngăn body sử dụng 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 for this request) |
Payload đã hết 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 rỗ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 đã lưu trữ 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à phát lại tới API trực tiếp, 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 bị vô hiệu hóa đối với các lời gọi Auto và đối với các payload không thể phát lại (các stub request quá kích thước và các route không phải API), kèm theo gợi ý giải thích lý do.
Nguồn cấp Proxy
Chuyển Product sang Proxy và nguồn cấp dữ liệu sẽ hiển thị mỗi hàng cho một tunnel, cũng tính từ giờ trước. Một tunnel là một kết nối do công cụ của bạn mở; nội dung gửi bên trong là lưu lượng mã hóa của riêng bạn, vì vậy hàng này mô tả kết nối đã đi đâu, điểm thoát như thế nào, mất bao lâu để mở và đã truyền bao nhiêu dữ liệu.
| Cột | Ý nghĩa |
|---|---|
| Time | Thời điểm tunnel kết thúc, kèm thời gian tương đối bên cạnh |
| Proxy user | Proxy user nào đã xử lý kết nối |
| Target | Host và port mà tunnel kết nối đến |
| Exit | Shared hoặc Premium, kèm quốc gia của điểm exit khi xác định được |
| Outcome | Success, Client Error, Service Error, Service Fail hoặc Rate Limited, kèm lý do theo thuật ngữ của bạn khi bị từ chối |
| Setup | Thời gian từ khi công cụ của bạn kết nối đến lúc tunnel được bàn giao |
| Duration | Thời gian tunnel duy trì mở |
| Bytes | Cả hai chiều trong một ô, kèm dấu hiệu premium khi điểm exit thuộc mạng premium |
| Client IP | Địa chỉ IP khởi tạo kết nối |
Không có các cột Status, Credits hoặc payload, và không có hộp thoại chi tiết. CONNECT không có status từ target và không có body để FourA lưu trữ.
Menu thả xuống Owner và bộ chọn giới hạn hoạt động tương tự. Thay cho menu khóa, menu thả xuống Proxy user giới hạn phạm vi nguồn cấp dữ liệu cho một thông tin xác thực. Mọi cột đều có thể sắp xếp.
Hàng hiển thị Rate Limited là giới hạn từ gói dịch vụ của bạn, không phải do target từ chối. Lý do sẽ chỉ rõ giới hạn nào: số tunnel đồng thời, số lần mở mỗi phút, lưu lượng đã dùng hết, gói premium không khả dụng hoặc port không nằm trong gói của bạn. Xem Proxy Port.
Sử dụng Request ID
Mọi phản hồi API đều chứa header X-Foura-Request-Id. Hãy ghi nhật ký header này ở phía bạn để có thể dán vào phiếu hỗ trợ nhằm chỉ định chính xác request trong Activity Log. ID này trùng với ID được dùng trong hộp thoại này và khớp với X-Foura-Request-Id do API trả về. Xem Response Headers để biết chi tiết.
Nội dung liên quan
- Metrics and Analytics: Dữ liệu hiệu suất tổng hợp qua các khoảng thời gian dài hơn, áp dụng cho cả hai sản phẩm
- Proxy Port: Sản phẩm mà nguồn cấp Proxy theo dõi và báo cáo
- Playground: Phát lại request từ Activity
- Response Headers: Nguồn gốc của request ID và credits
- API Endpoints: Cấu trúc request và response
- Organizations: Phạm vi áp dụng của bộ lọc Owner
- Troubleshooting: Các sự cố thường gặp và giải pháp