$msec 变量仅支持毫秒级精度，小数点后三位固定表示毫秒，其底层依赖系统时钟和 gettimeofday() 等毫秒级 API，且在请求接入瞬间冻结，设计目标是轻量稳定的毫秒锚点；官方确认精度上限为1毫秒，无法原生支持微秒。
$msec 变量本身不支持微秒级精度，它提供的是毫秒级时间戳（如 1718923456.789），小数点后三位固定代表毫秒，不是微秒。试图用 $msec 直接实现微秒级记录，在 Nginx 原生能力范围内不可行。
为什么 $msec 无法达到微秒精度
• $msec 是 Nginx 内置变量，值为 Unix 时间戳的秒数 + 毫秒小数部分，底层依赖系统时钟和 gettimeofday() 或 clock_gettime(CLOCK_MONOTONIC) 的毫秒级分辨率
• 它在请求接入**瞬间生成并冻结**，不随后续处理变化，设计目标就是轻量、稳定、可对齐的毫秒锚点
• Nginx 官方文档与实测均确认其精度上限为 1 毫秒；若需更高分辨率，必须引入外部机制或替代方案
若需微秒级日志，可考虑的替代路径
• 在应用层埋点：由后端服务（如 Go/Python/Java）调用高精度 API（如 Python 的 time.time_ns()、Go 的 time.Now().UnixMicro()）生成微秒时间戳，并写入响应头或日志字段
• 使用自定义 Nginx 模块：基于 C 开发模块，调用 clock_gettime(CLOCK_MONOTONIC_RAW, &ts) 获取纳秒级时间，再截取微秒部分注入日志变量
• 结合 $request_time 进行插值估算（仅限分析场景）：$request_time 本身精度可达毫秒（如 0.023456），虽不能直接提升 $msec，但可用于构建更细粒度的耗时分布模型，例如将 23ms 耗时按逻辑阶段拆解为微秒级区间假设
实际高性能分析中的推荐做法
• 以 $msec 为统一时间轴基准：所有服务、代理、客户端同步透传 X-Request-Start: t=$msec，确保跨系统时间对齐误差 ≤1ms
• 补充微秒级增量信息：后端在响应中返回 X-Process-Time-Micro: 123456（表示从接收请求到发出响应的微秒耗时），与 $msec 相加即可推得近似微秒级结束时间
• 日志格式示例：
log_format ultra '$msec|$request_time|$upstream_http_x_process_time_micro|...';
这样既保持 Nginx 日志链路轻量可靠，又为下游分析系统（如 Grafana + Loki）提供足够分辨力
不复杂但容易忽略：真正影响高性能分析效果的，往往不是单点精度极限，而是全链路时间参考系的一致性。$msec 正是这个一致性最坚实的基础。
