收集和传输指标

¹ 目前，使用方法 1直接将指标从 IoT Edge 设备传输到 Log Analytics 所需的设置步骤最少，因此操作也更简单。 除非特定方案要求使用 option 2 方法，否则首选第一个选项，以便IoT Edge设备仅与IoT 中心通信。

指标收集器模块需要 IoT Edge 设备所属的 IoT 中心的 Azure 资源管理器 ID。 将该 ID 作为 ResourceId 环境变量的值输入。 收藏员将其存放在普通 ResourceId 柱中，保留其弹壳。 查询工作区，并将 tolower() 应用于已存储和已选定的 ID，然后进行匹配。 本指南使用了资源匹配和查询范围中描述的直通模式。

资源 ID 使用以下格式： /subscriptions/<subscription id>/resourceGroups/<resource group name>/providers/Microsoft.Devices/IoTHubs/<iot hub name> 可以在 Azure 门户中 IoT 中心的 Properties 页中找到资源 ID。

或者，可以使用 az resource show 命令获取 ID：

az resource show -g <resource group> -n <hub name> --resource-type "Microsoft.Devices/IoTHubs"

指标收集器模块需要 IoT Edge 设备所属的 IoT Central 应用程序的 Azure 资源管理器 ID。 将该 ID 作为 ResourceId 环境变量的值输入。 收藏员将其存放在普通 ResourceId 柱中，保留其弹壳。 查询工作区，并将 tolower() 应用于已存储和已选定的 ID，然后进行匹配。 本指南使用了资源匹配和查询范围中描述的直通模式。

资源 ID 使用以下格式： /subscriptions/<subscription id>/resourceGroups/<resource group name>/providers/Microsoft.IoTCentral/IoTApps/<iot central app name> 可以在 Azure 门户中 IoT Central 应用程序的 Properties 页中找到资源 ID。

或者，可以使用 az resource show 命令获取 ID：

az resource show -g <resource group> -n <application name> --resource-type "Microsoft.IoTCentral/IoTApps"

“UploadTarget”配置选项用于控制是将指标直接发送到 Azure Monitor 还是 IoT 中心。

如果你把 UploadTarget 设置为 IotMessage，模块会将你的指标作为物联网消息发布。 终结点 /messages/modules/<metrics collector module name>/outputs/metricOutput 将这些消息作为 UTF8 编码的 JSON 发出。 例如，如果IoT Edge指标收集器模块命名为 IoTEdgeMetricsCollector，则终结点为 /messages/modules/IoTEdgeMetricsCollector/outputs/metricOutput。 未压缩消息格式如下：

[{
    "TimeGeneratedUtc": "<time generated>",
    "Name": "<prometheus metric name>",
    "Value": 1.0,
    "Labels": {
        "<label name>": "<label value>"
    }
}, {
    "TimeGeneratedUtc": "2020-07-28T20:00:43.2770247Z",
    "Name": "docker_container_disk_write_bytes",
    "Value": 0.0,
    "Labels": {
        "name": "AzureMonitorForIotEdgeModule"
    }
}]

“UploadTarget”配置选项用于控制是将指标直接发送到 Azure Monitor 还是 IoT Central。

如果你把 UploadTarget 设置为 IotMessage，模块会将你的指标作为物联网消息发布。 终结点 /messages/modules/<metrics collector module name>/outputs/metricOutput 将这些消息作为 UTF8 编码的 JSON 发出。 例如，如果IoT Edge指标收集器模块命名为 IoTEdgeMetricsCollector，则终结点为 /messages/modules/IoTEdgeMetricsCollector/outputs/metricOutput。 未压缩消息格式如下：

[{
    "TimeGeneratedUtc": "<time generated>",
    "Name": "<prometheus metric name>",
    "Value": 1.0,
    "Labels": {
        "<label name>": "<label value>"
    }
}, {
    "TimeGeneratedUtc": "2020-07-28T20:00:43.2770247Z",
    "Name": "docker_container_disk_write_bytes",
    "Value": 0.0,
    "Labels": {
        "name": "AzureMonitorForIotEdgeModule"
    }
}]

有时需要通过 IoT 中心引入指标，而不是将其直接发送到 Log Analytics。 例如，监视嵌套配置中的 IoT Edge 设备时（其中子设备只能访问其父设备的 IoT Edge 中心）。 另一个示例是仅将具有出站网络访问权限的 IoT Edge 设备部署到 IoT 中心。

若要在此方案中启用监视，请将指标收集器模块配置为通过 edgeHub 模块将指标作为设备到云（D2C）消息发送。 通过在收集器UploadTarget中将环境变量设置为IotMessage启用该功能。

此选项需要额外的设置（云工作流设置）才能将到达 IoT 中心的指标消息传递到 Log Analytics 工作区。 如果没有此设置，集成的其他部分（如 特选可视化效果 和 警报 ）不起作用。

有时，需要通过 IoT Central 引入指标，而不是将其直接发送到Log Analytics。 例如，监视嵌套配置中的 IoT Edge 设备时（其中子设备只能访问其父设备的 IoT Edge 中心）。 另一个示例是将仅具有出站网络访问权限的 IoT Edge 设备部署到 IoT Central。

若要在此方案中启用监视，请将指标收集器模块配置为通过 edgeHub 模块将指标作为设备到云（D2C）消息发送。 通过在收集器UploadTarget中将环境变量设置为IotMessage启用该功能。

以下示例展示了收集器和布线的配置。 将其合并到你的部署清单中，并保留完整的系统模块配置：

{
  "modulesContent": {
    "$edgeAgent": {
      "properties.desired": {
        "schemaVersion": "1.0",
        "runtime": {
          "type": "docker",
          "settings": {
            "minDockerVersion": "v1.25",
            "loggingOptions": "",
            "registryCredentials": {}
          }
        },
        "systemModules": {
          "edgeAgent": {
          },
          "edgeHub": {
          }
        },
        "modules": {
          "SimulatedTemperatureSensor": {
          },
          "AzureMonitorForIotEdgeModule": {
            "settings": {
                "image": "mcr.microsoft.com/azureiotedge-metrics-collector:2.0.0",
                "createOptions": "{\"HostConfig\":{\"LogConfig\":{\"Type\":\"json-file\",\"Config\":{\"max-size\":\"4m\",\"max-file\":\"7\"}}}}"
            },
            "type": "docker",
            "env": {
              "UploadTarget": {
                "value": "IotMessage"
              },
              "ResourceId": {
                "value": "/subscriptions/{your subscription id}/resourceGroups/{your resource group}/providers/Microsoft.IoTCentral/IoTApps/{your app name}"
              },
              "MetricsEndpointsCSV": {
                "value": "http://edgeHub:9600/metrics,http://edgeAgent:9600/metrics"
              },
              "ScrapeFrequencyInSecs": {
                "value": "30"
              },
              "AllowedMetrics": {
                "value": ""
              },
              "BlockedMetrics": {
                "value": ""
              },
              "CompressForUpload": {
                "value": "false"
              },
              "TransformForIoTCentral": {
                "value": "true"
              }
            },
            "status": "running",
            "restartPolicy": "always",
            "version": "1.0"
          }
        }
      }
    },
    "$edgeHub": {
      "properties.desired": {
        "schemaVersion": "1.0",
        "routes": {
          "temperatureupload": "FROM /messages/modules/SimulatedTemperatureSensor/outputs/temperatureOutput INTO $upstream",
          "metricupload": "FROM /messages/modules/AzureMonitorForIotEdgeModule/outputs/metricOutput INTO $upstream"
        },
        "storeAndForwardConfiguration": {
          "timeToLiveSecs": 7200
        }
      }
    },
    "SimulatedTemperatureSensor": {
    },
    "AzureMonitorForIotEdgeModule": {}
  }
}

在 IoT Central 应用程序中查看 IoT Edge 设备中的指标：

• 将IoT Edge指标标准接口作为继承接口添加到设备模板：

  

• 使用接口中定义的遥测值来生成监视IoT Edge设备所需的任何仪表板：