2a96f4c6f9
后端： 1.阶段 6 agent / memory 服务化收口 - 新增 cmd/agent 独立进程入口，承载 agent zrpc server、agent outbox relay / consumer 和运行时依赖初始化 - 补齐 services/agent/rpc 的 Chat stream 与 conversation meta/list/timeline、schedule-preview、context-stats、schedule-state unary RPC - 新增 gateway/client/agent 与 shared/contracts/agent，将 /api/v1/agent chat 和非 chat 门面切到 agent zrpc - 收缩 gateway 本地 AgentService 装配，双 RPC 开关开启时不再初始化本地 agent 编排、LLM、RAG 和 memory reader fallback - 将 backend/memory 物理迁入 services/memory，私有实现收入 internal，保留 module/model/observe 作为 memory 服务门面 - 调整 memory outbox、memory reader 和 agent 记忆渲染链路的 import 与服务边界，cmd/memory 独占 memory worker / consumer - 关闭 gateway 侧 agent outbox worker 所有权，agent relay / consumer 由 cmd/agent 独占，gateway 仅保留 HTTP/SSE 门面与迁移期开关回退 - 更新阶段 6 文档，记录 agent / memory 当前切流点、smoke 结果，以及 backend/client 与 gateway/shared 的目录收口口径
110 lines
2.4 KiB
Go
110 lines
2.4 KiB
Go
package observe
|
|
|
|
import (
|
|
"context"
|
|
"fmt"
|
|
"log"
|
|
"sort"
|
|
"strings"
|
|
)
|
|
|
|
// Level 表示 memory 结构化观测事件等级。
|
|
type Level string
|
|
|
|
const (
|
|
LevelInfo Level = "info"
|
|
LevelWarn Level = "warn"
|
|
LevelError Level = "error"
|
|
)
|
|
|
|
// Event 描述一次 memory 模块内部结构化观测事件。
|
|
//
|
|
// 职责边界：
|
|
// 1. 只承载稳定字段，不绑定具体日志平台；
|
|
// 2. 组件与操作名尽量保持低基数，避免后续指标聚合失控；
|
|
// 3. 字段内容应偏“排障与治理”，不承载大段原始文本。
|
|
type Event struct {
|
|
Level Level
|
|
Component string
|
|
Operation string
|
|
Fields map[string]any
|
|
}
|
|
|
|
// Observer 是 memory 模块的最小观测接口。
|
|
type Observer interface {
|
|
Observe(ctx context.Context, event Event)
|
|
}
|
|
|
|
// ObserverFunc 允许用函数快速适配 Observer。
|
|
type ObserverFunc func(ctx context.Context, event Event)
|
|
|
|
func (f ObserverFunc) Observe(ctx context.Context, event Event) {
|
|
if f == nil {
|
|
return
|
|
}
|
|
f(ctx, event)
|
|
}
|
|
|
|
// NewNopObserver 返回空实现，保证观测能力不会反向阻塞主链路。
|
|
func NewNopObserver() Observer {
|
|
return ObserverFunc(func(context.Context, Event) {})
|
|
}
|
|
|
|
// NewLoggerObserver 返回标准日志实现，当前阶段默认打到后端进程日志。
|
|
func NewLoggerObserver(logger *log.Logger) Observer {
|
|
if logger == nil {
|
|
logger = log.Default()
|
|
}
|
|
return &loggerObserver{logger: logger}
|
|
}
|
|
|
|
type loggerObserver struct {
|
|
logger *log.Logger
|
|
}
|
|
|
|
func (o *loggerObserver) Observe(ctx context.Context, event Event) {
|
|
if o == nil || o.logger == nil {
|
|
return
|
|
}
|
|
|
|
level := strings.TrimSpace(string(event.Level))
|
|
if level == "" {
|
|
level = string(LevelInfo)
|
|
}
|
|
component := strings.TrimSpace(event.Component)
|
|
if component == "" {
|
|
component = "unknown"
|
|
}
|
|
operation := strings.TrimSpace(event.Operation)
|
|
if operation == "" {
|
|
operation = "unknown"
|
|
}
|
|
|
|
fields := FieldsFromContext(ctx)
|
|
for key, value := range event.Fields {
|
|
key = strings.TrimSpace(key)
|
|
if key == "" || !shouldKeepField(value) {
|
|
continue
|
|
}
|
|
fields[key] = value
|
|
}
|
|
|
|
parts := []string{
|
|
"memory",
|
|
fmt.Sprintf("level=%s", level),
|
|
fmt.Sprintf("component=%s", component),
|
|
fmt.Sprintf("operation=%s", operation),
|
|
}
|
|
|
|
keys := make([]string, 0, len(fields))
|
|
for key := range fields {
|
|
keys = append(keys, key)
|
|
}
|
|
sort.Strings(keys)
|
|
for _, key := range keys {
|
|
parts = append(parts, fmt.Sprintf("%s=%v", key, fields[key]))
|
|
}
|
|
|
|
o.logger.Print(strings.Join(parts, " "))
|
|
}
|