Xem log và theo dõi app

Mọi thứ nằm ở đâu?

Cần xem	Chỗ trên console
App có đang ổn không	Dải trạng thái đầu trang environment
Build log	“Logs” → “Build”
App log	“Logs” → “Runtime”
CPU, RAM, request, lỗi 5xx	“Logs” → “Số liệu”
Các lần deploy, rollback, restore	“Lần deploy”
Ai đã làm gì	Khung “Hoạt động” ở trang Tổng quan

Mọi role trong workspace, kể cả Viewer, đều xem được log và metrics.

Đọc trạng thái app

Dải đầu trang environment tóm tắt bằng một nhãn, kèm ba mục: Health check, Traffic, Backup. Console refresh mỗi 5 giây, chỉ báo “Mọi thứ ổn” khi cả ba đã xác nhận.

Nhãn	Nghĩa
“Mọi thứ ổn”	Health check đạt, bản mới nhất nhận toàn bộ traffic, backup đã restore thử thành công (nếu có database)
“Đang chạy”	Health check đạt, nhưng còn mục chưa xác nhận, ví dụ backup chưa restore thử lần nào
“Cần bạn xem”	Đang chuyển traffic sang bản mới, hoặc lần restore thử backup gần nhất fail
“Có sự cố”	App không qua health check, thao tác gần nhất fail, hoặc environment bị chặn
“Chưa xác nhận”	Chưa lấy được trạng thái mới, hoặc chưa có kết quả health check
“Chưa deploy”	Environment chưa có bản deploy nào

Trạng thái từng service trong bảng "Những gì đang chạy"

Service hiện	Nghĩa
“Khoẻ”	health_path trả mã 2xx
“Không qua health check”	health_path trả mã lỗi hoặc không nhận kết nối
“Chưa có kết quả health check”	Chưa hỏi được server
“Chưa kiểm tra được worker”	Worker chưa có health check riêng
“Chờ đội Embra kiểm tra”	Environment bị chặn sau sự cố, xem ENVIRONMENT_BLOCKED

Cách đặt health_path và điều kiện đạt khi deploy: xem Chuẩn bị app.

Xem log build

1. Mở “Logs” → “Build”.
2. Chọn build ở ô “Bản build” (mặc định là lần mới nhất).
3. Đọc log. Build đang chạy thì log hiện dần.

Build fail thì tra mã lỗi ở Mã lỗi và cách sửa. Build log giữ 30 ngày sau khi build kết thúc.

Xem log app trực tiếp

1. Mở “Logs” → “Runtime”.
2. Chọn service ở ô “Service” (web hoặc tên worker).
3. Chọn “Trực tiếp”. Dòng mới hiện ngay khi app in ra.

• Dòng APP do app ghi, dòng EMBRA là thông báo của platform.
• Filter theo chuỗi, nguồn, log level hoặc thời gian. “Tạm dừng cuộn” để đọc, “Theo dòng mới nhất” để chạy tiếp.
• Chỉ xem được bản đang chạy. Log bản cũ nằm ở chế độ “Lịch sử”.
• App chưa chạy thì tab hiện “Chưa có log của app” → bấm “Xem build log” để xem bước chuẩn bị.

Giới hạn	Mức
Dòng giữ trong browser	Tối đa 5.000. “Sao chép” và “Tải .txt” lấy các dòng đang hiển thị
Log stream mở cùng lúc	Tối đa 5 mỗi workspace. Mở thêm thì báo QUOTA_EXCEEDED; đóng bớt tab

Giờ trong log

Container chạy giờ UTC; muốn app in giờ Việt Nam thì đặt secret TZ = Asia/Ho_Chi_Minh. Giờ console ghi cạnh mỗi dòng là lúc Embra đọc dòng đó, không phải lúc app ghi.

Tìm trong lịch sử log

1. Ở “Logs” → “Runtime”, chọn “Lịch sử”.
2. Nhập chuỗi cần tìm (exact match, không phải regex).
3. Chọn khoảng thời gian, từ “30 phút qua” tới “30 ngày qua” → “Tìm”.

• Lịch sử gồm log của các bản đã chạy trước, và request log ở edge (chọn nguồn “Request (edge)”).
• Mỗi lần tìm trả tối đa 500 dòng mới nhất. Còn dòng cũ hơn thì thu hẹp khoảng thời gian hoặc thêm chuỗi tìm.
• Số ngày giữ tuỳ gói, tối đa 30 ngày; console ghi số ngày của gói bạn. Chọn khoảng dài hơn thì báo QUOTA_EXCEEDED.
• Thấy Máy chủ này chưa bật lịch sử log (TEMPORARILY_UNAVAILABLE): server của bạn chưa bật lịch sử log, dùng chế độ “Trực tiếp”.

Xem metrics

1. Mở “Logs” → “Số liệu”.
2. Ở “Xem cho”, chọn “Toàn environment (HTTP)”, một service, hoặc Postgres.
3. Chọn khoảng thời gian: 1 giờ, 6 giờ, 24 giờ, 7, 14 hoặc 30 ngày.

Biểu đồ	Đo gì
Request mỗi giây, Tỉ lệ lỗi 5xx, Độ trễ p95	Request qua edge, cho toàn environment
CPU (core), Bộ nhớ	Từng service, kèm giới hạn của service
Dung lượng Postgres đã dùng	Database của environment

Biểu đồ có mốc deploy, rollback, restore, migration, và đếm số lần app restart hoặc out-of-memory (OOM). Metrics giữ bao lâu tuỳ gói, tối đa 30 ngày.

Xem lịch sử deploy

Mở “Lần deploy”: build, deploy, rollback và restore data, lấy từ 100 thao tác gần nhất. Filter bằng “Tất cả”, “Deploy”, “Lỗi”, “Chờ duyệt”. Bấm một dòng để xem chi tiết.

Ý nghĩa từng trạng thái

Trạng thái	Nghĩa
“Chờ duyệt”	Plan chờ Owner hoặc Admin approve
“Đang chạy thử migration”, “Đang chạy migration”	Đang rehearsal trên bản copy, hoặc đang chạy trên production
“Đang khởi động”, “Đang chuyển traffic”	Bản mới đang lên
“Đã nhận traffic, đang theo dõi”	Bản mới đã nhận traffic, Embra đang theo dõi thêm
“Deploy thành công”, “Hoàn tất”	Xong
“Thất bại”, “Đã huỷ”, “Đã từ chối”	Dừng lại; bản cũ vẫn chạy nếu lỗi trước khi chuyển traffic
“Cần đội Embra hỗ trợ”	Không rõ kết quả, xem RECOVERY_REQUIRED
“Cần xác minh dữ liệu”	Không rõ migration đã chạy chưa, xem MIGRATION_UNKNOWN

Dải “Lịch sử & khôi phục” ở đầu trang vẽ các lần deploy trong tối đa 48 giờ gần nhất, cạnh khoảng data restore được. Xem Rollback và khôi phục backup.

Thông báo khi app lỗi

Embra chưa gửi email hay tin nhắn khi build, deploy hoặc app lỗi. Theo dõi trên console, hoặc dùng embra wait và embra events trong script.

Dùng CLI

Lệnh tương ứng (cài CLI):

embra logs --env <project>/<env> --follow
embra logs --env <project>/<env> --process <worker-name>
embra logs --env <project>/<env> --since 2h --grep "timeout"
embra logs --build <op_id>
embra metrics --env <project>/<env> --range 7d
embra events --env <project>/<env>

embra logs --since tìm trong lịch sử log, mặc định 200 dòng, tối đa 1000 (--limit).

Xem thêm

• Deploy từ GitHub
• Chuẩn bị app: health check
• Rollback và khôi phục backup
• Mã lỗi và cách sửa