input_static_file_onetime 的核心语义可以概括为 "启动时刻快照":
- 启动时一次性发现文件:扫描匹配路径并将当时存在的文件列表固化到 checkpoint,后续新增文件不会被纳入本次采集目标。
- 只读取启动时刻的文件大小:每个文件记录
initial size,采集过程中即使文件被追加写入,本次也只读取到该位置为止,避免边采边写带来的不可控重复或漏采。 - 支持轮转定位:文件 fingerprint 包含 dev、inode、sig_hash、sig_size 等信息,其中 sig_hash/sig_size 取自文件开头最多 1024 字节签名;当文件路径因轮转变化时,会根据 dev+inode 在目录中重新查找并继续读取。
这种快照语义让一次性采集既可预测又可恢复,是其与持续采集最关键的差别。




