Nhật ký và lưu lượng
Mục Vận hành cho thấy app đã deploy chạy ra sao, gồm số liệu tổng, từng request gọi API, log của handler và cron. Agent đọc cùng dữ liệu đó bằng công cụ logs.
Log và lưu lượng bắt đầu có từ lần deploy đầu. Trước đó các mục con báo app chưa deploy.
Trong dashboard
Mở project, chọn Vận hành ở thanh bên. Mục này có các mục con:
- Số liệu: tổng số request, lỗi 4xx và 5xx, thời gian phản hồi p50 và p95, route nhiều request nhất, lỗi gặp nhiều nhất kèm phản hồi mẫu. Chọn khoảng 1 giờ, 24 giờ hoặc 7 ngày. Biểu đồ đánh dấu các lần deploy, nên bạn thấy ngay lỗi tăng sau bản nào.
- Lỗi: các lỗi 5xx lặp lại trong 24 giờ qua, gom theo thông báo lỗi và route, kèm dòng log của đúng request đó. Đây là chỗ đầu tiên nên mở khi người dùng báo app hỏng.
- Lưu lượng: từng request tới
/apivới phương thức, path, trạng thái, thời gian và nguồn trả lời. Lọc theo path, trạng thái và nguồn. Bấm một dòng để xem header và body của request lẫn response; header nhạy cảm nhưAuthorizationbị che. Nút Sao chép cURL cho lệnh gọi lại đúng request đó. - Logs: dòng in ra từ
console.log,console.warnvàconsole.errortrong handler và cron. Log có thể đến trễ khoảng 10 giây. Bật Tự làm mới để theo dõi liên tục, gõ chữ để lọc. - Cron: các việc định kỳ đã đăng ký, lịch chạy và lịch sử từng lần chạy. Xem Việc định kỳ.
- Việc nền: các lần chạy của file
*.job.ts, kèm lỗi và số lần thử lại.
Cột nguồn trong Lưu lượng cho biết ai trả lời request:
handler code trong app/ của bạn
upstream hệ thống có sẵn mà app chuyển tiếp tới (app/upstream.ts)
mock dữ liệu giả lập cho phần hệ thống ngoài chưa xong
error request trả lỗi 5xxLưu lượng được giữ 3 tháng.
Khi handler ném lỗi
Handler ném lỗi bất ngờ thì app trả 500 với body { error: "INTERNAL", message: "Máy chủ gặp lỗi, vui lòng thử lại sau." }, không kèm thông báo lỗi gốc hay stack, để người dùng không thấy chi tiết bên trong. Chi tiết nằm ở Lỗi, Logs và ở dòng request đó trong Lưu lượng. Lỗi bạn chủ động ném bằng fail(status, message, code) thì đến tay người dùng nguyên văn.
Ghi thêm log ở chỗ nghi ngờ bằng console.log rồi deploy lại:
import { createOrder } from "./repository";
export default (c, { user, body }) => {
console.log("tạo đơn", { user: user.id, productId: body.productId });
return createOrder(user, body);
};Qua agent
Bảo agent: “Xem app có lỗi gì trong 24 giờ qua.” Agent gọi logs với một trong bốn kiểu:
summary: số liệu tổng trongsincephút (mặc định 1.440, tức 24 giờ), kèm mức dùng so với hạn mức của gói.traffic: danh sách request, lọc bằngpath,status(2xxtới5xx),sourcevàsince(mặc định 60 phút, tối đa 10.080). Truyềnidđể đọc một request đầy đủ.traces: các lần gọi HTTP và chạy cron, kèm trạng thái, thời gian và lỗi.logs: dòng log từconsole.
limit chọn số dòng, từ 1 tới 200, mặc định 50. Agent dùng response thật trong traffic để viết dữ liệu giả lập và kịch bản kiểm thử.
Cần biết
- Lưu lượng ghi body đã che thông tin nhạy cảm; body quá dài bị cắt.
- Request do cron gọi không bị giới hạn tốc độ, nhưng vẫn hiện trong log.
- Request vượt hạn mức của gói nhận
429hoặc503và có trong Lưu lượng. Xem Hạn mức theo gói.
Bước tiếp theo
- Rollback và checkpoint — quay lại bản cũ khi bản mới gây lỗi.
- Công cụ
logs— đủ tham số và dạng kết quả agent nhận được. - Hạn mức theo gói — request mỗi phút, CPU và số lời gọi ra ngoài của từng gói.