File size: 3,058 Bytes
e48a2d8
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
// Package debugcap 一次性取证落盘:把线上「只能靠猜」的形态抓成 JSONL。
//
// 定位方式:默认**完全不启用**(不设 WB2API_CAPTURE_DIR 就没有任何 IO、没有额外
// 分配)。设了目录之后,只有调用方显式命中的形态才会写一行——不是全量采样,
// 否则 26 万请求/天会直接把磁盘写满。
//
// 为什么要这个:网关只记元数据不存 body,而「模型说一句就停」这种形态无法从
// 元数据判断是上游行为、客户端 tool_choice、还是网关改写造成的。抓一次真实
// 请求的正文与出站形态,比在生产上反复试参数快得多,也可复现。
//
// 硬上限:每个 tag 最多 MaxLines 行、单行最长 maxLineBytes、整个捕获目录超过
// maxDirBytes 就停止(并记一条日志)。取证是诊断,不允许影响业务。
package debugcap

import (
	"encoding/json"
	"os"
	"path/filepath"
	"sync"
	"sync/atomic"
	"time"
)

var (
	mu       sync.Mutex
	lines    = map[string]int{}
	wrote    int64
	disabled atomic.Bool
)

// MaxLines 每个 tag 最多写多少行(够复现就行)。
const MaxLines = 40

const (
	maxLineBytes = 8 << 10  // 单行 8KB
	maxDirBytes  = 32 << 20 // 整个目录 32MB
)

// Enabled 报告取证是否启用(未设 WB2API_CAPTURE_DIR → false)。
func Enabled() bool { return os.Getenv("WB2API_CAPTURE_DIR") != "" && !disabled.Load() }

// Capture 把 rec 序列化后追加到 <dir>/<tag>.jsonl。任何失败都静默(取证不该
// 影响业务),并在超过上限时永久关闭。
func Capture(tag string, rec any) {
	dir := os.Getenv("WB2API_CAPTURE_DIR")
	if dir == "" || disabled.Load() {
		return
	}
	if tag == "" {
		tag = "misc"
	}
	mu.Lock()
	defer mu.Unlock()
	if lines[tag] >= MaxLines {
		return
	}
	if size := dirBytes(dir); size > maxDirBytes {
		disabled.Store(true)
		return
	}
	raw, err := json.Marshal(rec)
	if err != nil {
		return
	}
	if len(raw) > maxLineBytes {
		raw = raw[:maxLineBytes]
	}
	if err := os.MkdirAll(dir, 0o755); err != nil {
		return
	}
	f, err := os.OpenFile(filepath.Join(dir, tag+".jsonl"), os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0o644)
	if err != nil {
		return
	}
	defer f.Close()
	if _, err := f.Write(append(raw, '\n')); err != nil {
		return
	}
	lines[tag]++
	wrote++
}

// dirBytes 目录总大小(只看一层,够用了:所有文件都直接写在该目录下)。
func dirBytes(dir string) int64 {
	ents, err := os.ReadDir(dir)
	if err != nil {
		return 0
	}
	var total int64
	for _, e := range ents {
		if info, err := e.Info(); err == nil {
			total += info.Size()
		}
	}
	return total
}

// Wrote 返回已写行数(测试与日志用)。
func Wrote() int64 { return atomic.LoadInt64(&wrote) }

// Reset 清空计数与熔断(仅测试用)。
func Reset() {
	mu.Lock()
	defer mu.Unlock()
	lines = map[string]int{}
	wrote = 0
	disabled.Store(false)
}

// Now 统一时间格式(与 reqlog 一致,便于对齐)。
func Now() string { return time.Now().Format(time.RFC3339Nano) }