日志监控

提供前端错误追踪、用户行为分析、API 调用监控、PV/UV 统计等日志监控能力。

概述

日志监控系统支持多项目管理，每个项目可以独立配置和查看数据。提供了完整的 SDK 供前端集成，支持通过项目 ID 或 App Token 进行认证。

核心能力

1. 项目管理

• 项目列表（分页展示）
• 项目新增、编辑、删除
• 项目详情查看
• 项目统计数据展示

2. 数据监控

监控类型	说明
错误日志（Bug）	JS 运行时错误捕获
用户行为（Action）	用户操作行为记录
API 调用	接口请求/响应日志
PV 统计	页面访问量
UV 统计	独立访客数
BV 统计	浏览器访问统计
事件统计	自定义事件

3. 前端 SDK

通过 <script> 标签引入：

<script
  src="https://cdn.verysites.com/verybugs/better-monitor/better-monitor.min.js"
  crossorigin="anonymous"
  data-project-id="your-project-id"
  data-api="1"
></script>

4. App Token 机制

• JWT 生成 Token，不设过期时间
• 支持 Token 更新
• 用于 SDK 认证

相关文件

• src/services/bugs/ — 监控业务逻辑
• src/controllers/bugs/ — 监控接口控制器
• src/routes/bugs/ — 监控路由
• src/utils/BugUtils.mts — Token 生成和验证工具
• src/utils/LogUtils.mts — Winston 日志工具
• apps/monitor/ — 监控管理前端应用
• schedules/jobBugsStatistics.mts — 定时统计任务
• schedules/jobBugsAlert.mts — 异常报警任务