Katyusha's blog

1
// Package schema 定义统一的结构化诊断输出。
2
//
3
// 字段严格对齐赛题"结构化输出完整性(15分)"与"证据链一致性(8分)"要求：
4
// 异常类型、关联对象、关键指标、异常时间窗口、疑似根因、证据链、建议性结论。
5
// 同一结构可序列化为 JSON / YAML / Markdown，便于机器解析与评委复核。
6
package schema
7

8
// RelatedObject 关联对象：可为进程/线程，也可为块设备/文件路径（按场景取用）。
9
type RelatedObject struct {
10
  Pid    uint32 `json:"pid,omitempty" yaml:"pid,omitempty"`
11
  Tid    uint32 `json:"tid,omitempty" yaml:"tid,omitempty"`
12
  Comm   string `json:"comm,omitempty" yaml:"comm,omitempty"`
13
  Device string `json:"device,omitempty" yaml:"device,omitempty"`
14
}
15

16
// TimeWindow 异常时间窗口（RFC3339）。
17
type TimeWindow struct {
18
  Start string `json:"start" yaml:"start"`
19
  End   string `json:"end" yaml:"end"`
20
}
21

22
// Evidence 证据链中的单条证据：可回溯到具体指标 / 调用栈 / 事件。
23
type Evidence struct {
24
  Type      string      `json:"type" yaml:"type"`                             // metric | stack | event | log
25
  Name      string      `json:"name" yaml:"name"`                             // 证据名
26
  Value     interface{} `json:"value,omitempty" yaml:"value,omitempty"`       // 观测值
27
  Threshold interface{} `json:"threshold,omitempty" yaml:"threshold,omitempty"` // 触发阈值（若有）
28
  Func      string      `json:"func,omitempty" yaml:"func,omitempty"`         // 热点函数（stack 类）
29
  Desc      string      `json:"desc,omitempty" yaml:"desc,omitempty"`         // 说明
30
}
31

32
// AnomalyReport 一次异常的完整结构化诊断结果。
33
type AnomalyReport struct {
34
  AnomalyType        string                 `json:"anomaly_type" yaml:"anomaly_type"`
35
  RelatedObject      RelatedObject          `json:"related_object" yaml:"related_object"`
36
  KeyMetrics         map[string]interface{} `json:"key_metrics" yaml:"key_metrics"`
37
  TimeWindow         TimeWindow             `json:"time_window" yaml:"time_window"`
38
  SuspectedRootCause string                 `json:"suspected_root_cause" yaml:"suspected_root_cause"`
39
  Confidence         float64                `json:"confidence" yaml:"confidence"`
40
  EvidenceChain      []Evidence             `json:"evidence_chain" yaml:"evidence_chain"`
41
  Suggestion         string                 `json:"suggestion" yaml:"suggestion"`
42
}