You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
1.7 KiB
1.7 KiB
管理面板系统日志
/admin/system-logs 为管理员提供 Virt Cloud 运行日志和错误日志的只读查询页面。页面通过 /api/v1/admin/system-logs 调用宿主机的 journalctl,并支持服务、级别、关键词、时间范围和结果条数筛选。
日志读取范围固定为以下服务单元:
virt-cloud-engine.servicevirt-cloud-worker.servicevirt-cloud-lifecycle.servicevirt-cloud-policy-worker@1.servicevirt-cloud-policy-worker@2.servicevirt-cloud-update.servicelibvirtd.servicevirtqemud.servicevirtlogd.servicevirtlockd.service
接口使用参数数组启动 /usr/bin/journalctl(系统没有该路径时使用 /bin/journalctl),不会经过 shell,也不接受任意 unit、命令或文件路径。单次最多读取 200 条,使用 journal cursor 加载更早记录;消息长度和游标都有限制。日志内容可能包含运行时上下文,因此接口仅对管理员开放,并设置 private, no-store。
PHP-FPM 或 Web 服务账号需要具备读取 systemd journal 的权限。部署后如果页面提示无权读取日志,应将该账号加入目标系统的 systemd-journal 组并重启 PHP-FPM;不要为了此页面授予 root 权限。
接口读取的是运行 PHP 面板的本机 journal。若引擎部署在独立宿主机,页面不会假装已经读取远程宿主机日志;远程宿主机的 libvirt 错误仍需在该宿主机执行 journalctl,或后续增加经过引擎认证的只读日志代理。
页面的时间输入使用面板 PHP 时区,传给 journalctl 时转换为 Unix 时间戳。错误级别对应 journald 的 priority 0..3,警告为 4,其余级别分别对应 5、6、7。