fsnotify无法采集耗时和i/o大小，因其仅通知事件类型且时间戳为用户态接收时间；真实性能数据需在业务i/o调用点手动打点并结合runtime/trace分析系统调用阻塞。
直接用 fsnotify 无法采集耗时和 I/O 大小
fsnotify 只通知事件类型（Create、Write、Remove），不提供任何性能数据。你从 fsnotify.Event 里拿不到：duration、bytes_written、syscall latency，甚至连事件发生的真实内核时间都不准确——它只是 Go runtime 收到通知的那一刻。
常见误用是把 fsnotify.Watcher 当成“自动埋点器”，结果日志里只有 "file /tmp/log.txt changed"，完全无法回答“这次写慢不慢”“是不是大文件导致”这类问题。
- 同一路径连续多次
Write可能被合并为一个Write事件，中间的耗时和字节数全丢 -
Event.Watch时间戳是用户态接收时间，不是write(2)系统调用返回时间 - 编辑器保存常触发
CHMOD+WRITE+CHMOD，若不做去重，指标会被噪声污染
手动打点：在 os.ReadFile/os.WriteFile 周围加 time.Since()
真正可落地的性能采集，必须落在你自己的 I/O 调用点上。不要绕开业务逻辑去监听，而要在 os.ReadFile、io.Copy、json.MarshalIndent 后写入等关键路径包裹计时。
- 用
start := time.Now()开始，dur := time.Since(start)结束，避免用time.Now().Sub()—— 前者更简洁且无精度损失 - 记录字段至少包含：
op（如"read"）、path、size_bytes（读取/写入字节数）、duration、err - 别在 hot path 上补调
os.Stat()查大小——它本身是 syscall，会污染测量结果；写操作直接用len(data)，读操作在os.ReadFile返回后取len(buf)
示例：
start := time.Now()
data, err := os.ReadFile("/etc/config.yaml")
dur := time.Since(start)
logger.Info("file read completed", "path", "/etc/config.yaml", "size_bytes", len(data), "duration_ms", dur.Milliseconds(), "err", err)
用 runtime/trace 抓真实系统调用阻塞
time.Since() 只告诉你“这段代码跑了多久”，但跑得慢是因为磁盘慢？page cache 未命中？goroutine 被调度延迟？还是锁竞争？这些得靠 runtime/trace。
-
trace.Start()必须在main()开头调用，且传入的文件路径要可写（如os.Create("trace.out")），否则静默失败 - 别在 HTTP handler 或 for 循环里反复启停 trace——它只能写一次，且启动有开销
- 运行后执行
go tool trace -http=":8080" trace.out，重点看「Syscall blocking」时间轴：如果单次write阻塞 >1ms，基本是磁盘或 NFS 延迟；若频繁短阻塞（
注意：runtime/trace 不替代日志，而是帮你确认“慢是不是真的卡在 I/O”——如果 trace 显示没 syscall blocking，那慢就出在 Go 层（比如没缓冲、marshal 太重）。
Prometheus 打标必须带业务维度，否则指标等于废数据
定义一个叫 file_io_duration_seconds 的直方图，但不加标签，等于只有一条线——你根本分不清是配置加载拖慢了服务，还是用户上传日志文件导致整体延迟飙升。
- 标签至少含三个维度：
op（"read"/"write"）、type（"config"/"log"/"upload"）、path_prefix（如"/etc/"、"/var/log/"） - 用
prometheus.NewHistogramVec()初始化，全局一次；每次采集调用.WithLabelValues("read", "config", "/etc/")获取子指标 - 必须在启动时调用
prometheus.MustRegister()，否则/metrics返回空；别在每次读写时 new 一个新指标实例——GC 和 map 查找开销会反向拖慢 I/O - name 字段只允许小写字母、数字、下划线、冒号；
Help字符串不能为空，否则MustNewHistogramVec直接 panic
复杂点在于：不同业务路径的 I/O 行为差异极大，监控必须能按场景切片。漏掉任一维度，排查时就要靠猜。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
