如何通过Python SDK在Azure IOT Central中填充事件创建时间

实现经验参考 #

1. 设备端时间生成与本地存储规则 #

• 事件生成时同步赋值eventCreateTime字段，优先取设备本地UTC时间，格式选用Unix时间戳或者ISO 8601标准格式即可，不用依赖网络授时，避免断网场景下时间字段缺失。
• 本地缓存选用和设备硬件匹配的轻量存储方案：嵌入式设备可分配专用Flash分区存储，网关类设备可直接用SQLite、本地JSON文件存储。缓存的每条数据需额外加上报状态标记（未上报/上报中/上报成功），避免重复上报或者数据丢失。

2. 断网续传逻辑 #

• 每次上报前做网络连通性检测，上报失败的事件直接归入未上报队列，按业务对实时性的要求设置重试间隔，通常30s~5min都属于合理范围。
• 网络恢复后按eventCreateTime正序（从早到晚）上报历史缓存数据，避免乱序导致平台侧数据时序混乱。
• 单条数据上报成功后立即清理本地对应缓存，或者标记为上报成功后定期批量清理，避免占用过多本地存储资源。

3. 平台侧配置适配 #

• 上报数据时明确将eventCreateTime作为事件实际发生时间的专属字段传递到平台，不要直接使用平台数据接收时间作为统计维度，你可以参考下方IoT Central界面，将自定义的eventCreateTime设置为平台数据统计的时间基准，就能保证仪表板展示时数据会按实际发生时间排序，不会因为上报延迟落到错误的时间区间。

内容的提问来源于stack exchange，提问作者Martyn Bell