日志解析基础：日志文件格式、时间戳与消息ID识别

SECS/GEM 日志是设备行为与通信过程的“黑匣子”。要快速定位 GEM 功能故障，首先必须掌握日志的三种常见载体格式、时间戳的解析规则以及消息 ID（Stream/Function）的识别方法。本章将围绕这三个基础要素展开，为后续的日志分析实战打下坚实根基。

2.1 日志文件格式：.log、.txt、.csv

半导体设备产生的日志文件通常以三种格式存储。不同格式适用于不同的分析场景，下表对比了它们的核心差异：

以下是一个典型的 .log 格式日志片段：

2025-03-21 14:32:18.456 [INFO]  [EQP-01]  Rx: S1F13 W
2025-03-21 14:32:18.457 [INFO]  [EQP-01]  Tx: S1F14 W
2025-03-21 14:32:18.458 [DEBUG] [EQP-01]  S1F14 Data: {0x01, 0x02, 0x03}
2025-03-21 14:32:18.460 [WARN]  [EQP-01]  S6F11 Timeout: 10s

对应的 .csv 格式结构化表示：

Timestamp,Level,Module,Message
2025-03-21 14:32:18.456,INFO,EQP-01,Rx: S1F13 W
2025-03-21 14:32:18.457,INFO,EQP-01,Tx: S1F14 W
2025-03-21 14:32:18.458,DEBUG,EQP-01,S1F14 Data: {0x01, 0x02, 0x03}
2025-03-21 14:32:18.460,WARN,EQP-01,S6F11 Timeout: 10s

2.2 时间戳格式：精度与对齐

时间戳是日志分析的时间轴基准。SECS/GEM 日志中常见的时间戳格式有以下三种：

• 标准 ISO 8601 格式： 2025-03-21 14:32:18.456，精度到毫秒，适用于大多数现代设备。
• 紧凑数字格式： 20250321143218，无分隔符，适用于嵌入式系统或低带宽记录。
• 相对时间戳： [+0.123s] 或 T+10.456，从某个起始点开始计时，适用于协议栈内部调试。

时间戳解析的关键步骤：

1. 识别格式： 根据日志头部或配置文档确定时间戳的模板。
2. 提取字段： 使用正则表达式捕获年、月、日、时、分、秒、毫秒。
3. 归一化处理： 将所有时间戳转换为 Unix 时间戳（毫秒级），便于计算时间差。

Python 解析示例：

import re
from datetime import datetime

log_line = "2025-03-21 14:32:18.456 [INFO] Rx: S1F13 W"
pattern = r"(\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}\.\d{3})"
match = re.search(pattern, log_line)
if match:
    ts_str = match.group(1)
    dt = datetime.strptime(ts_str, "%Y-%m-%d %H:%M:%S.%f")
    unix_ms = int(dt.timestamp() * 1000)
    print(f"Unix 毫秒时间戳: {unix_ms}")

2.3 消息ID识别：Stream/Function

SECS/GEM 协议中，每条消息都由一个 Stream (S) 和 Function (F) 唯一标识，格式为 S<n>F<m>。Stream 表示消息的类别，Function 表示具体的操作。正确识别 S/F 是理解日志语义的第一步。

常见 Stream 分类：

日志中消息 ID 的典型出现位置：

• 行首标识： Rx: S1F13 W 或 Tx: S6F11，其中 Rx 表示接收，Tx 表示发送。
• 数据块头部： 在二进制或十六进制转储中，前两个字节通常表示 Stream 和 Function。
• 消息摘要字段： 部分日志会在末尾附加 [S1F13] 标签。

2.4 综合解析示例：从日志行提取关键字段

将上述三个基础要素综合起来，一条完整的日志行可以分解为以下结构：

[时间戳] [级别] [模块] [方向] [消息ID] [数据/状态]

示例：
2025-03-21 14:32:18.456 [INFO] [EQP-01] Rx: S1F13 W
|-- 时间戳 ---------| |级别| |模块--| |方向| |消息ID| |标志|

解析步骤总结：

1. 定位时间戳： 使用正则提取前 23 个字符（ISO 格式）。
2. 提取级别与模块： 方括号内的内容，通常为 INFO/DEBUG/WARN/ERROR 及设备名称。
3. 识别方向与消息ID： Rx: 或 Tx: 后紧跟 S<n>F<m>。
4. 记录标志位： 如 W (Wait)、H (High Speed)、R (Reply Required)。