logs
Công cụ logs cho agent xem request gần đây, dòng console của backend, nhật ký lưu lượng của app và bảng số liệu tổng hợp, để tìm lỗi và chạy thử luồng sau khi deploy.
Log có từ lần deploy đầu. Project chưa deploy trả danh sách trống kèm ghi chú, không phải lỗi.
logs
- Tham số:
project.type:traces(mặc định),logs,traffichoặcsummary.limit: 1–200 dòng, mặc định 50.id: vớitraffic, mở chi tiết một request.path: vớitraffic, lọc theo một phần đường dẫn.status:2xx,3xx,4xxhoặc5xx.source:handler,upstream,mockhoặcerror.since: số phút gần nhất, 1–10.080. Mặc định 60 vớitraffic, 1.440 vớisummary.
- Khi nào gọi: sau deploy, để xem từng luồng có chạy đúng không; khi người dùng báo lỗi; khi viết mock từ phản hồi thật của hệ thống ngoài.
Bốn loại
traces: request HTTP gần đây với mã trạng thái, thời gian và lỗi. Lượt chạy cron hiện làCRON <path>.logs: dòngconsole.log/console.errortừ handler và cron. Có thể trễ khoảng 10 giây.traffic: nhật ký request riêng của app, giữ 3 tháng. Mỗi request/apimột dòng, mới nhất trước, có nguồn trả lời:handler(code của app),upstream(hệ thống ngoài trongapp/upstream.ts),mock(dữ liệu giả),error. Truyềnidđể xem header và body của một request (đã che phần nhạy cảm, tối đa 6 KB).summary: tình trạng app trongsincephút: tổng request, số lỗi 4xx và 5xx, thời gian phản hồi p50 / p95, route nhiều request nhất, lỗi gặp nhiều nhất kèm body mẫu, so với kỳ trước. Kèmquota: mức đã dùng so với hạn mức của gói.
logs({ project, type: "summary" }) → có lỗi 5xx không
logs({ project, type: "traffic", status: "5xx" }) → request nào lỗi
logs({ project, type: "traffic", id: 1842 }) → header và body của request đóHandler ném lỗi không lường trước thì app trả 500 với { "error": "INTERNAL", "message": "Máy chủ gặp lỗi, vui lòng thử lại sau." }, không lộ thông báo gốc hay stack. Chi tiết nằm trong logs (dòng [handler error] …).
Bước tiếp theo
- Nhật ký và lưu lượng: xem cùng dữ liệu trong dashboard.
- Hạn mức theo gói: hạn mức mà
quotaso sánh. - Gọi API bên ngoài:
upstreamvàmock.
Cập nhật