AskaEth
0e1f163ef9
- 新增三个下行帧（纯新增，既有帧名/形状零改动）：observability_log / observability_trace /
observability_metrics，各带 ≤1s 节拍、无新数据不发帧、单帧上限（日志 200 / span 100）
- 帧壳 {type,data} 不带 sessionId；**不进 frameReachesAll 白名单** ⇒ fail-closed 只发 owner+admin
（变异验证两次：加进白名单 → viewer 用例必红）
- 推送开启条件＝owner/admin 凭据「读过一次」对应 REST（引导数据仍由该次读取返回），
连接全断即退订并停循环（无常驻 goroutine）；既有 REST 端点路径/RBAC/形状完全不变
- 前端：删除 logs/metrics/trace 三处 useAutoReload 轮询；新增 observabilityStream（引导+去重合并+窗口）
与 observabilityViews（三个面板 + WS 徽标），长列表统一走已落地的 VirtualList
- 复核：build/vet 绿 + gateway 全包测试绿（含真 bus→真 /ws/chat 三角色帧断言）+ `-race`；
前端 tsc 0 错 + vite build 成功
- 待登记契约：api-client 需新增「可观测实时推送」一节
135 lines
3.9 KiB
Go
135 lines
3.9 KiB
Go
package gateway
|
||
|
||
import (
|
||
"log/slog"
|
||
"net/http"
|
||
"strconv"
|
||
"strings"
|
||
"time"
|
||
|
||
apperr "git.yeij.top/AskaEth/Cyrene_v2/internal/errors"
|
||
"git.yeij.top/AskaEth/Cyrene_v2/internal/logger"
|
||
)
|
||
|
||
// 日志尾部端点的调参。编译期常量（项目规范 §10）。
|
||
const (
|
||
defaultLogLimit = 200
|
||
maxLogLimit = 1000
|
||
)
|
||
|
||
// AdminLogEntry 是 GET /api/v1/admin/observability/logs 中一个条目的
|
||
// 线上结构：{time,level,source,msg}。`time` 是
|
||
// RFC3339 UTC（与 trace/audit 一致）；`level` ∈ debug|info|warn|error；`source`
|
||
// 是记录的来源标签，记录未携带时为空。
|
||
type AdminLogEntry struct {
|
||
Time string `json:"time"`
|
||
Level string `json:"level"`
|
||
Source string `json:"source"`
|
||
Msg string `json:"msg"`
|
||
}
|
||
|
||
// SetLogBuffer 注入 GET /api/v1/admin/observability/logs 背后的
|
||
// 进程级日志环形缓冲。组合根在网关存在后调用它
|
||
// （logger 先于网关构建）；在那之前该
|
||
// 端点返回 501。并发调用是安全的。
|
||
func (s *Server) SetLogBuffer(buf *logger.RingBuffer) {
|
||
if s == nil || s.obs == nil {
|
||
return
|
||
}
|
||
s.obs.logBuf.Store(buf)
|
||
}
|
||
|
||
// logBuffer 返回已注入的日志环形缓冲，未注入时为 nil。
|
||
func (s *Server) logBuffer() *logger.RingBuffer {
|
||
if s == nil || s.obs == nil {
|
||
return nil
|
||
}
|
||
return s.obs.logBuf.Load()
|
||
}
|
||
|
||
// adminObservabilityLogs 返回最近的后端日志记录，最新
|
||
// 优先，可选按最低级别过滤（管理读）。它是面板日志
|
||
// 尾部背后的后端：记录来自 logger 自身的环形
|
||
// 缓冲，没有任何东西被重新渲染或编造。
|
||
//
|
||
// 读取同时充当实时推送的订阅握手（裁决 05.4.3 + 16.4.3-WS，见
|
||
// observability_push.go）：此后新日志由 observability_log 帧推来，
|
||
// 面板不再轮询，分级过滤改在本地进行（帧是广播的，无法按连接分级）。
|
||
func (s *Server) adminObservabilityLogs(w http.ResponseWriter, r *http.Request) {
|
||
s.watchObservability(r)
|
||
minLevel, filtered, ok := parseLogLevel(r.URL.Query().Get("level"))
|
||
if !ok {
|
||
writeError(w, &apperr.AppError{
|
||
Code: "invalid_level",
|
||
Message: "level 只能为 debug/info/warn/error 或留空",
|
||
HTTPCode: http.StatusBadRequest,
|
||
})
|
||
return
|
||
}
|
||
buf := s.logBuffer()
|
||
if buf == nil {
|
||
writeError(w, &apperr.AppError{
|
||
Code: "not_implemented",
|
||
Message: "日志环形缓冲未注入（组合根未挂载 logger.RingBuffer）",
|
||
HTTPCode: http.StatusNotImplemented,
|
||
})
|
||
return
|
||
}
|
||
limit := parseLogLimit(r)
|
||
entries := buf.Snapshot(0)
|
||
out := make([]AdminLogEntry, 0, min(len(entries), limit))
|
||
for _, e := range entries {
|
||
if filtered && logger.ParseLevel(e.Level) < minLevel {
|
||
continue
|
||
}
|
||
out = append(out, adminLogOf(e))
|
||
if len(out) == limit {
|
||
break
|
||
}
|
||
}
|
||
writeJSON(w, http.StatusOK, out)
|
||
}
|
||
|
||
// adminLogOf 把捕获的日志条目映射为驼峰式管理线上结构。
|
||
func adminLogOf(e logger.Entry) AdminLogEntry {
|
||
return AdminLogEntry{
|
||
Time: e.Time.UTC().Format(time.RFC3339),
|
||
Level: e.Level,
|
||
Source: e.Source,
|
||
Msg: e.Msg,
|
||
}
|
||
}
|
||
|
||
// parseLogLevel 解析 ?level= 过滤器。空值关闭过滤
|
||
// （filtered=false）；debug/info/warn/error 选中该级别及以上；其他任何
|
||
// 取值都以 ok=false 拒绝，使 handler 返回 400。
|
||
func parseLogLevel(raw string) (min slog.Level, filtered, ok bool) {
|
||
switch strings.ToLower(strings.TrimSpace(raw)) {
|
||
case "":
|
||
return 0, false, true
|
||
case "debug":
|
||
return slog.LevelDebug, true, true
|
||
case "info":
|
||
return slog.LevelInfo, true, true
|
||
case "warn":
|
||
return slog.LevelWarn, true, true
|
||
case "error":
|
||
return slog.LevelError, true, true
|
||
default:
|
||
return 0, false, false
|
||
}
|
||
}
|
||
|
||
// parseLogLimit 解析 ?limit= 查询参数，夹取到 [1, maxLogLimit] 并在
|
||
// 缺失或非法时选用 defaultLogLimit。
|
||
func parseLogLimit(r *http.Request) int {
|
||
n, err := strconv.Atoi(r.URL.Query().Get("limit"))
|
||
if err != nil || n <= 0 {
|
||
return defaultLogLimit
|
||
}
|
||
if n > maxLogLimit {
|
||
return maxLogLimit
|
||
}
|
||
return n
|
||
}
|