日志配置

PxeLab 日志系统的配置、轮转与排查。

日志级别

级别	说明	适用场景
`debug`	详细调试信息	开发调试、问题排查
`info`	正常运行信息（默认）	生产环境
`warn`	警告信息	需要关注但不影响运行
`error`	错误信息	需要修复的问题

配置项

在 config.yaml 的 log 部分配置：

yaml

log:
  level: info                    # 日志级别
  format: text                   # text / json
  file: ""                       # 日志文件路径（空=默认 ~/.pxelab/logs/pxelab.log）
  max_size_mb: 100                # 单文件最大体积 (MB)，0=不限制
  max_backups: 5                  # 保留轮转文件数，0=不限制
  max_age_days: 30                # 保留天数，0=不限制
  compress: true                  # gzip 压缩旧日志
  cleanup_interval: 24            # 清理检查间隔（小时），0=不自动清理

Web UI：设置 → 日志管理（轮转参数修改后需重启服务生效）

日志文件

默认路径：~/.pxelab/logs/pxelab.log
格式：文本（每行一条日志）
包含：时间戳、级别、服务名、消息
同时输出到 stderr（终端）与文件

日志轮转

PxeLab 内置日志轮转功能，支持：

按大小轮转：单文件超过 max_size_mb 时自动轮转
按天数保留：超过 max_age_days 天的日志自动清理
备份数限制：最多保留 max_backups 个轮转文件
gzip 压缩：compress: true 时自动压缩旧日志

Web UI 日志管理页可手动清理日志（按保留天数/备份数）。

日志排查

bash

# 实时查看日志
tail -f ~/.pxelab/logs/pxelab.log

# 按服务过滤
grep "DHCP" ~/.pxelab/logs/pxelab.log
grep "TFTP" ~/.pxelab/logs/pxelab.log
grep "HTTP" ~/.pxelab/logs/pxelab.log

# 按级别过滤
grep "ERROR" ~/.pxelab/logs/pxelab.log

# Web UI
# 侧边栏 → 监控 → 日志（实时 SSE 流）

服务指标

PxeLab 提供指标快照端点（JSON 格式，非 Prometheus 文本格式）：

GET /api/v1/metrics

返回 services 映射，每个服务包含：

通用指标：请求数、错误数、入/出字节、活跃连接、拒绝数、请求速率、错误速率、带宽、延迟（5 分钟窗口）
DHCP 附加：Offer/Ack/Nak/Decline/Discover 计数、活跃租约数、架构与平台分布
HTTP 附加：2xx/3xx/4xx/5xx 状态码计数、请求时长

注册了指标的服务：http、tftp、dns、dhcp、nfs、wol。

日志配置 ​

日志级别 ​

配置项 ​

日志文件 ​

日志轮转 ​

日志排查 ​