智能制造与工业软件 / 系统课时
给测点附上事件时间与质量标志
给测点附上事件时间与质量标志
同一笔温度读数可能在设备采样后数秒才到达网关,又因断网重传而延迟入库。如果只保存数值和入库时间,历史读数就可能被误当成实时状态。本课为测点保留三种时间、质量等级及时间来源,并验证时钟异常时怎样安全降级。
学习目标
- 区分源时间、网关接收时间与平台入库时间,并识别 OPC UA 时间戳的含义。
- 生成包含数值、单位、事件时间、时间来源和质量状态的统一记录。
- 用可运行示例识别时钟偏差,避免晚到数据覆盖实时状态。
三种时间分别记录什么
假设 Machine01 的温度在 2026-10-12T00:00:00.000Z 被数据源标记,网关在 00:00:03.200Z 收到,平台于 00:00:03.500Z 入库。它们不能互相覆盖。
| 字段 | 由谁赋值 | 回答的问题 |
|---|---|---|
sourceTime |
设备或上游数据源 | 数值或质量状态何时在源端被标记? |
gatewayReceivedAt |
边缘网关首次接收时 | 采集链路何时拿到它? |
storedAt |
平台持久化时 | 数据何时被写入存储? |
eventTime |
归一化规则选择 | 趋势及事件计算按哪个时间归档? |
OPC UA 的 SourceTimestamp 是数据源给值或状态赋的时间,不保证一定来自传感器内部时钟;ServerTimestamp 是 UA 服务器接收或确认该值有效的时间,不是网关接收时间。如需审计,可额外保存 opcServerTime。具体语义见 OPC UA Part 4。Modbus TCP 寄存器响应通常不带每个值的源时间,应把 sourceTime 设为 null,用网关完成读取时的 UTC 时间估算事件发生时间。

定义记录与质量判定
归一化记录至少包含 deviceId、pointId、value、unit、上述时间字段、eventTimeOrigin、sourceQuality、timeQuality 和 quality。所有时间使用带时区的 ISO 8601 格式,跨系统统一为 UTC;storedAt 必须由平台写入,不能由网关提前伪造。
| 状态 | 典型条件 | 处理方式 |
|---|---|---|
Good |
采集成功、值可信 | 可供普通趋势与报警使用 |
Uncertain |
上游标为不确定,或源时钟明显异常 | 保留记录并提示风险;报警策略单独决定是否采信 |
Bad |
通信失败、上游标为不可用 | 不把上一笔正常数值伪装成新测量值 |
质量分两层保存:sourceQuality 反映数值可用性,timeQuality 反映事件时间的可信程度。本课自定义的综合 quality 取较严重的等级(并非改写 OPC UA 原生状态码);同时保留具体原因,便于判断是探头故障还是时钟故障。对无源时间但轮询成功的 Modbus 值,允许数值为 Good,同时明确标记时间为网关估算值。
用 Python 生成统一测点记录
以下示例使用 Python 3.9+ 标准库。假设边缘适配器已经把 OPC UA StatusCode 的严重度映射为 Good、Uncertain 或 Bad,并且独立的时钟同步监测提供了 clockOffsetMs。这里把 2000 ms 设为演示告警阈值,实际工程应按采样周期和工艺要求调整。
from datetime import datetime, timezone
def parse_utc(value):
if value is None:
return None
dt = datetime.fromisoformat(value.replace("Z", "+00:00"))
if dt.utcoffset() is None:
raise ValueError("时间必须包含时区")
return dt.astimezone(timezone.utc)
def iso(dt):
return dt.isoformat(timespec="milliseconds").replace("+00:00", "Z")
def normalize(raw):
received = parse_utc(raw["gatewayReceivedAt"])
source = parse_utc(raw.get("sourceTime"))
offset = raw.get("clockOffsetMs")
# 时钟偏差来自独立监测,不能用接收时间减源时间代替。
if source is None:
time_quality, reason = "GatewayEstimated", "NO_SOURCE_TIME"
elif offset is None:
time_quality, reason = "Unverified", "CLOCK_UNVERIFIED"
elif abs(offset) > 2000:
time_quality, reason = "ClockSkew", "CLOCK_SKEW"
else:
time_quality, reason = "Trusted", "OK"
event = source if time_quality == "Trusted" else received
source_quality = raw["sourceQuality"]
if source_quality == "Bad":
quality = "Bad"
elif source_quality == "Uncertain" or time_quality in ("Unverified", "ClockSkew"):
quality = "Uncertain"
else:
quality = "Good"
return {
"deviceId": raw["deviceId"],
"pointId": raw["pointId"],
"value": None if source_quality == "Bad" else raw["value"],
"unit": raw["unit"],
"sourceTime": iso(source) if source else None,
"gatewayReceivedAt": iso(received),
"eventTime": iso(event),
"eventTimeOrigin": "SOURCE" if time_quality == "Trusted" else "GATEWAY",
"sourceQuality": source_quality,
"timeQuality": time_quality,
"quality": quality,
"qualityReason": reason,
}
raw = {
"deviceId": "Machine01",
"pointId": "temperature",
"value": 76.5,
"unit": "°C",
"sourceTime": "2026-10-12T00:00:00.000Z",
"gatewayReceivedAt": "2026-10-12T00:00:03.200Z",
"sourceQuality": "Good",
"clockOffsetMs": 2600,
}
record = normalize(raw)
# 仅模拟平台在落库时盖章,不属于网关采集操作。
record["storedAt"] = "2026-10-12T00:00:03.500Z"
print(record["eventTimeOrigin"], record["eventTime"])
print(record["quality"], record["timeQuality"], record["qualityReason"])
print("sourceTime=" + str(record["sourceTime"]))
print("storedAt=" + record["storedAt"])预期输出:
GATEWAY 2026-10-12T00:00:03.200Z
Uncertain ClockSkew CLOCK_SKEW
sourceTime=2026-10-12T00:00:00.000Z
storedAt=2026-10-12T00:00:03.500Z数值虽然来自标为 Good 的数据源,但独立监测发现源时钟偏差 2600 ms,因此 eventTime 退回网关首次接收时间,并把综合质量降为 Uncertain。原始 sourceTime 仍保留用于审计,不能直接覆盖它。
识别时钟问题与晚到数据
网关和平台应通过 NTP 同步;有更严格时间精度需求的现场,可评估设备支持的 PTP。gatewayReceivedAt - sourceTime 不是纯时钟偏差,其中还包含设备采集、网络排队和传输耗时。应以独立时钟偏差监测为判断依据,再联合链路延迟排查。
建议先用以下规则做测试验收,阈值属于本实验示例而非协议标准:
- 将
clockOffsetMs改为100:预期eventTimeOrigin=SOURCE、timeQuality=Trusted、quality=Good。 - 将
sourceTime改为None,模拟无源时间的 Modbus 读数:预期eventTimeOrigin=GATEWAY、timeQuality=GatewayEstimated;若读取成功,数值质量仍可为Good。 - 将
sourceQuality改为Bad:预期value=None且quality=Bad,不可把旧值当作新值参与报警。 - 模拟断网十分钟后补传:保留首次采集时的
gatewayReceivedAt和原始eventTime,平台只更新本次storedAt;不得在重试时给历史读数重新盖采样时间。
实时看板按每个测点的事件时间和质量决定是否更新“当前值”,历史趋势按 eventTime 入桶;不能仅按最新入库的一行覆盖当前状态。若源系统能提供递增序号,还应保存序号处理重传去重。这样才能同时追溯“何时测到”“何时收到”“何时入库”,并解释异常读数为何被拒用或降级。