针对你遇到的「自定义模块日志正常但数据没传到远程监控、设备显示离线」的问题，结合你提到的MessageSchema推测，我整理了以下逐步排查的步骤：

一、先确认IoT Edge核心运行时的健康状态 #

设备显示离线，大概率是Edge基础组件出了问题，先从这里入手：

• 登录你的IoT Edge设备，执行命令 iotedge list，检查 edgeAgent 和 edgeHub 这两个核心模块的状态是否为 running。如果有模块异常退出，用 iotedge logs edgeAgent 或 iotedge logs edgeHub 查看具体报错，常见问题包括网络不通、IoT Hub设备凭证过期、模块镜像拉取失败。
• 测试设备到IoT Hub的网络连通性：执行 telnet <你的IoT Hub名称>.azure-devices.net 8883，如果能连通说明MQTT端口（Edge默认通信端口）正常，否则需要检查防火墙或网络代理设置。

二、校验遥测消息的MessageSchema格式 #

Azure远程监控对遥测消息的格式有严格要求，不符合Schema的消息会被丢弃或无法解析：

• 远程监控期望的标准遥测消息格式如下（必须包含 $metadata 和 $eventType 字段）：

{
  "temperature": 26.2,
  "pressure": 101.3,
  "$metadata": {
    "temperature": {
      "type": "double"
    },
    "pressure": {
      "type": "double"
    }
  },
  "$eventType": "Telemetry"
}

• 查看自定义模块的输出日志，确认你的消息是否完全符合这个结构。比如如果缺少 $eventType 字段，远程监控会识别不了这是遥测数据；$metadata 里的类型定义错误也会导致数据无法展示。

三、验证Edge模块的路由配置 #

即使模块能生成消息，路由错误也会导致数据无法到达IoT Hub：

• 登录Azure门户，进入你的IoT Edge设备详情页，查看模块孪生中的 routes 配置，确保存在从自定义模块到 $upstream 的路由规则，示例配置如下：

"routes": {
  "customModuleToHub": "FROM /messages/modules/你的自定义模块名称/outputs/* INTO $upstream"
}

• 执行 iotedge logs edgeHub，搜索关键字 Received message 和 Sent message to upstream，确认edgeHub是否成功接收并转发了自定义模块的消息。如果没有相关日志，说明路由配置有问题或者模块没有正确输出消息。

四、检查远程监控的设备映射与配置 #

设备在可用列表但离线，可能是映射或配置不匹配：

• 登录远程监控解决方案门户，进入设备页面，找到你的Edge设备，检查：
  • 设备的IoT Hub设备ID是否和远程监控中显示的设备ID完全一致，避免映射错误。
  • 设备的遥测类型是否和你发送的遥测字段匹配，如果没有配置对应的字段，即使收到数据也不会在仪表板展示。
• 确认远程监控的事件中心是否正常接收数据：可以在Azure门户查看对应事件中心的消息计数，判断是否有数据流入。

五、额外排查点 #

• 如果你的自定义模块是用Azure IoT SDK开发的，确认代码中是否正确初始化了ModuleClient，并将消息发送到了正确的输出端。比如C#中需要用 await moduleClient.SendEventAsync("output1", message); 这样的代码发送消息。
• 检查IoT Hub的消息路由，确认是否存在将遥测数据路由到远程监控对应的事件中心的规则（远程监控解决方案会自动创建这个路由，但如果手动修改过可能会丢失）。

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