50 lines
1.5 KiB
Plaintext
50 lines
1.5 KiB
Plaintext
---
|
||
description: "日志与错误监控规范 — Hyperf Monolog/Vue 3 错误处理/Swoole 监控/告警策略"
|
||
globs:
|
||
- "Case-Database-Backend/app/**/*.php"
|
||
- "Case-Database-Backend/config/autoload/logger.php"
|
||
- "Case-Database-Frontend-user/src/**/*.ts"
|
||
- "Case-Database-Frontend-user/src/**/*.vue"
|
||
- "Case-Database-Frontend-admin/src/**/*.ts"
|
||
- "Case-Database-Frontend-admin/src/**/*.vue"
|
||
alwaysApply: false
|
||
---
|
||
|
||
# 📊 Logging & Error Monitoring Standards (Core)
|
||
|
||
## 日志基线
|
||
|
||
- 统一结构化日志（JSON）
|
||
- 日志级别分层：debug/info/warn/error
|
||
- 关键字段统一：trace_id、user_id、module、action、latency
|
||
- 严禁记录密钥、密码、完整 token
|
||
|
||
## 错误处理基线
|
||
|
||
- 前端：全局错误边界 + 请求错误统一处理
|
||
- 后端：统一异常映射，区分业务异常与系统异常
|
||
- 所有 error 需带上下文，便于定位与追踪
|
||
|
||
## 指标与告警
|
||
|
||
- 最小指标：QPS、错误率、P95/P99 延迟、队列堆积
|
||
- 告警分级：P1（立即处理）/P2（当日处理）/P3（观察）
|
||
- 告警必须可行动：包含服务、时间窗、建议操作
|
||
|
||
## 运维可观测性
|
||
|
||
- 关键链路可追踪（trace/span）
|
||
- 部署后监控窗口至少覆盖 30 分钟
|
||
- 事故复盘沉淀到 runbook
|
||
|
||
## 验证清单
|
||
|
||
- [ ] 日志结构字段统一
|
||
- [ ] 错误有分类与可检索上下文
|
||
- [ ] 核心指标可视化并配置告警
|
||
- [ ] 发布后监控与回滚流程可执行
|
||
|
||
## Tier 3 深度参考
|
||
|
||
- `.cursor/rules/references/024-monitoring-deep.md` — 完整监控规范与配置示例
|