智能制造与工业软件 / 系统课时

给测点附上事件时间与质量标志

给测点附上事件时间与质量标志

同一笔温度读数可能在设备采样后数秒才到达网关,又因断网重传而延迟入库。如果只保存数值和入库时间,历史读数就可能被误当成实时状态。本课为测点保留三种时间、质量等级及时间来源,并验证时钟异常时怎样安全降级。

学习目标

  • 区分源时间、网关接收时间与平台入库时间,并识别 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 设为演示告警阈值,实际工程应按采样周期和工艺要求调整。

python
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"])

预期输出:

text
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 不是纯时钟偏差,其中还包含设备采集、网络排队和传输耗时。应以独立时钟偏差监测为判断依据,再联合链路延迟排查。

建议先用以下规则做测试验收,阈值属于本实验示例而非协议标准:

  1. 将 clockOffsetMs 改为 100:预期 eventTimeOrigin=SOURCE、timeQuality=Trusted、quality=Good。
  2. 将 sourceTime 改为 None,模拟无源时间的 Modbus 读数:预期 eventTimeOrigin=GATEWAY、timeQuality=GatewayEstimated;若读取成功,数值质量仍可为 Good。
  3. 将 sourceQuality 改为 Bad:预期 value=None 且 quality=Bad,不可把旧值当作新值参与报警。
  4. 模拟断网十分钟后补传:保留首次采集时的 gatewayReceivedAt 和原始 eventTime,平台只更新本次 storedAt;不得在重试时给历史读数重新盖采样时间。

实时看板按每个测点的事件时间和质量决定是否更新“当前值”,历史趋势按 eventTime 入桶;不能仅按最新入库的一行覆盖当前状态。若源系统能提供递增序号,还应保存序号处理重传去重。这样才能同时追溯“何时测到”“何时收到”“何时入库”,并解释异常读数为何被拒用或降级。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

给测点附上事件时间与质量标志

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通