Skip to Content

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, traffic hoặc summary.
    • limit: 1–200 dòng, mặc định 50.
    • id: với traffic, mở chi tiết một request.
    • path: với traffic, lọc theo một phần đường dẫn.
    • status: 2xx, 3xx, 4xx hoặc 5xx.
    • source: handler, upstream, mock hoặc error.
    • since: số phút gần nhất, 1–10.080. Mặc định 60 với traffic, 1.440 với summary.
  • 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òng console.log / console.error từ 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 /api mộ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 trong app/upstream.ts), mock (dữ liệu giả), error. Truyền id để 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 trong since phú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èm quota: 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

Cập nhật