收集及傳輸計量

¹ 目前，使用 選項 1 直接從 IoT Edge 裝置將計量傳輸至 Log Analytics，是需要最少設定的簡單路徑。 除非您的特定案例需要選項 2 方法，否則會優先使用第一個選項，讓 IoT Edge 裝置只與 IoT 中樞 通訊。

若要深入瞭解IoT Edge和IoT Central，請參閱將 Azure IoT Edge 裝置 連線 至 Azure IoT Central 應用程式。

計量收集器模組需要IoT Edge裝置所屬IoT中樞的 Azure Resource Manager 識別符。 提供此標識碼作為 ResourceID 環境變數的值。

資源識別碼採用下列格式：

/subscriptions/<subscription id>/resourceGroups/<resource group name>/providers/Microsoft.Devices/IoTHubs/<iot hub name>

您可以在 Azure 入口網站 IoT 中樞的 [屬性] 頁面中找到資源識別碼。

或者，您可以使用 az resource show 命令來擷取標識碼：

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

計量收集器模組需要IoT Edge裝置所屬IoT Central 應用程式的 Azure Resource Manager 識別符。 提供此標識碼作為 ResourceID 環境變數的值。

資源識別碼採用下列格式：

/subscriptions/<subscription id>/resourceGroups/<resource group name>/providers/Microsoft.IoTCentral/IoTApps/<iot central app name>

您可以在 Azure 入口網站 中 IoT Central 應用程式的 [屬性] 頁面中找到資源識別碼。

或者，您可以使用 az resource show 命令來擷取標識碼：

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

UploadTarget 組態選項可控制計量是直接傳送至 Azure 監視器還是 IoT 中樞。

如果您將 UploadTarget 設定為 IoTMessage，則模組計量會發布為 IoT 訊息。 這些訊息會從端點 /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": <decimal value>,
    "Label": {
        "<label name>": "<label value>"
    }
}, {
    "TimeGeneratedUtc": "2020-07-28T20:00:43.2770247Z",
    "Name": "docker_container_disk_write_bytes",
    "Value": 0.0,
    "Label": {
        "name": "AzureMonitorForIotEdgeModule"
    }
}]

UploadTarget 組態選項可控制計量是否直接傳送至 Azure 監視器或 IoT Central。

如果您將 UploadTarget 設定為 IoTMessage，則模組計量會發布為 IoT 訊息。 這些訊息會從端點 /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": <decimal value>,
    "Label": {
        "<label name>": "<label value>"
    }
}, {
    "TimeGeneratedUtc": "2020-07-28T20:00:43.2770247Z",
    "Name": "docker_container_disk_write_bytes",
    "Value": 0.0,
    "Label": {
        "name": "AzureMonitorForIotEdgeModule"
    }
}]

有時候，必須透過 IoT 中樞 內嵌計量，而不是將計量直接傳送至 Log Analytics。 例如，在巢狀設定中監視IoT Edge裝置時，子裝置只能存取其父裝置的IoT Edge中樞。 另一個範例是部署只有輸出網路存取權的IoT Edge裝置 IoT 中樞。

若要在此案例中啟用監視功能，您可以將 metrics-collector 模組設定為透過edgeHub模組將計量傳送為裝置到雲端 （D2C） 訊息。 將收集器組態中的環境變數設定UploadTarget為 IoTMessage ，即可開啟此功能。

此選項需要額外的設定雲端工作流程，才能將抵達 IoT 中樞的計量訊息傳遞給Log Analytics工作區。 若未設定此設定，整合的其他部分，例如 策劃的視覺效果 和 警示 將無法運作。

範例雲端工作流程

雲端工作流程會將計量訊息從 IoT 中樞 傳遞至Log Analytics，作為IoT Edge記錄和監視範例的一部分。 此範例可以部署到現有的雲端資源，或做為生產部署參考。

有時候，必須透過IoT Central內嵌計量，而不是將計量直接傳送至Log Analytics。 例如，在巢狀設定中監視IoT Edge裝置時，子裝置只能存取其父裝置的IoT Edge中樞。 另一個範例是僅將輸出網路存取權部署至IoT Central的IoT Edge裝置。

若要在此案例中啟用監視功能，您可以將 metrics-collector 模組設定為透過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:1.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}/IOTC/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": {
      "properties.desired": {
        "schemaVersion": "1.0",
        "scrapeFrequencySecs": 30,
        "metricsFormat": "Json",
        "syncTarget": "IoTHub"
      }
    }
  }
}

若要在 IoT Central 應用程式中檢視來自 IoT Edge 裝置的計量：

• 將 IoT Edge 計量標準介面新增為繼承的介面 至您的 裝置範本：

  

• 使用 介面中定義的遙測值來建置您需要監視 IoT Edge 裝置的任何 儀錶板 ：