Tài liệu › Agent

Chẩn đoán và log

Xem trạng thái agent trên dashboard, đọc log trên máy, và gửi gói chẩn đoán cho hỗ trợ.

Trên dashboard

Trang agent hiện: phiên bản, hệ điều hành, lần báo cáo gần nhất, cấu hình đang áp dụng, lỗi gần nhất của từng nơi cài và từng kho. Nút Chạy ngay yêu cầu agent làm một chu kỳ ngay thay vì chờ.

Agent không báo cáo quá 2 chu kỳ + 1 giờ được coi là mất liên lạc: Tổng quan và kênh cảnh báo thông báo.

Log trên máy

Hệ điều hànhVị trí
WindowsC:\ProgramData\certman-agent\agent.log; Get-Service certman-agent
Linuxjournalctl -u certman-agent -f

Tăng chi tiết bằng -debug (hoặc "debug": true trong agent.json). Log không ghi token, khóa hay mật khẩu.

Gói chẩn đoán

Quản trị viên Metta (SaaS) có thể yêu cầu agent gửi gói chẩn đoán: phiên bản, cấu hình đã che bí mật, kết quả kiểm tra kết nối tới CA và kho, log gần đây. Agent chỉ gửi khi bạn cho phép trên dashboard; gói được giữ 7 ngày.

Lỗi thường gặp

Thông báoXử lý
agent token không hợp lệToken đã đổi hoặc agent bị thu hồi: dán token mới, khởi động lại
máy … chưa được agent cho phép nhận chứng chỉThêm máy vào allowed_hosts
thư mục … ngoài danh sách cho phépThêm thư mục vào allowed_dirs
lệnh … không nằm trong allowed_commandsThêm đúng lệnh (khớp chính xác)
Agent báo cáo nhưng không thấy chứng chỉKiểm tra thư mục tìm kiếm trong cấu hình agent và quyền đọc file
Cập nhật 10/10/2026Bài này có hữu ích?