#监控与日志

#系统状态

「仪表盘」展示系统资源、网络收发、平均请求耗时和用户、比赛、提交等统计，查看需要 admin:system:status 权限。部分统计暂不可用时，可稍后刷新；持续异常则检查应用日志和对应服务的状态。

#任务队列

在「任务队列」切换历史记录和实时队列，查看排队、正在执行、重试及已结束的任务，需要 admin:task:read 权限。批量操作部分失败时，可结合逐项结果中的原因和任务日志排查。

#定时任务

在后台「定时任务」页面可查看任务的执行次数和最近成功、失败时间，调整运行间隔，以及设置是否在服务器启动时立即执行一次。启动执行设置仅在下一次启动时生效，保存配置不会立即运行任务。详见定时任务。

#Prometheus 指标

平台在 /metrics 端点暴露 Prometheus 格式的指标数据。

#访问控制

通过 gin.metrics.whitelist 配置允许访问的 IP：

gin:
  metrics:
    whitelist:
      - 127.0.0.1
      - 10.0.0.0/8    # Prometheus 所在网段

未在白名单内的 IP 访问 /metrics 会返回 403 Forbidden。

#PProf 诊断

需要进一步定位 CPU 或内存异常时，运维人员可通过 /debug/pprof/* 获取性能诊断数据。请只允许可信运维来源访问。

通过 gin.pprof.whitelist 配置允许访问的 IP 或 CIDR：

gin:
  pprof:
    whitelist:
      - 127.0.0.1
      - 10.0.0.0/8    # 运维或跳板机网段

未在白名单内的 IP 访问 /debug/pprof/* 会返回 403 Forbidden。

#指标内容

• HTTP 请求数和延迟（按路由、方法、状态码分类）
• Asynq 任务队列深度和处理速率
• 作弊检测计数
• 活跃靶机数量

#日志系统

管理后台「日志」可在线查看平台近期运行记录；也可通过 Kubernetes 查看应用容器日志。

#日志级别

后台日志页可按级别筛选。排障时先查看错误和警告，再结合相邻时间的详细记录。数据库日志级别通过 gorm.log.level 设置，任务日志级别通过 asynq.log.level 设置。

#日志持久化

后台只保留有限的近期日志。需要赛后审计或长期检索时，请接入集群日志采集和归档服务。

#在线查看日志

查看后台日志需要 admin:log:read 权限，无需登录服务器。加载失败时可使用刷新重新读取。

#访问日志

访问日志包含请求方法、路径、状态码和耗时，可用于定位失败请求和响应较慢的操作。

#排除噪声路径

通过 gin.log.whitelist 排除不需要记录的路径：

gin:
  log:
    whitelist:
      - /metrics
      - /platform/*filepath

#文件管理

在「文件」页面查看和管理平台文件，需要 admin:file:list 权限，包括：

• 题目附件（attachment.zip、generator.zip）
• 流量捕获文件（.pcap）
• 选手 Writeup（PDF/DOC/DOCX）

支持在线下载（admin:file:read）和删除（admin:file:delete）。

#系统运行时设置

在「系统管理」修改并保存运行配置。查看、修改和后台重启分别需要 admin:system:read、admin:system:update、admin:system:restart 权限。

PostgreSQL/GORM、Redis、数据目录、Gin 监听地址和监听端口在页面中只读，只能通过部署配置修改。

共享 PVC k8s.shared_volume_claim 同样是部署参数，修改后需要重新创建平台 Pod。后台「重启」用于重新加载在线设置，不会重新读取磁盘配置文件。各项设置的生效方式见配置说明。