Samla in och transportera mått

¹ För närvarande är det enklare att använda alternativ 1 för att direkt transportera mått till Log Analytics från IoT Edge-enheten som kräver minimal konfiguration. Det första alternativet är att föredra om inte ditt specifika scenario kräver alternativ 2-metoden så att IoT Edge-enheten endast kommunicerar med IoT Hub.

Mer information om IoT Edge och IoT Central finns i Anslut Azure IoT Edge-enheter till ett Azure IoT Central-program.

Modulen metrics-collector kräver Azure Resource Manager-ID för den IoT-hubb som IoT Edge-enheten tillhör. Ange det här ID:t som värdet för ResourceID-miljövariabeln .

Resurs-ID:t har följande format:

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

Du hittar resurs-ID:t på sidan Egenskaper för IoT-hubben i Azure-portalen.

Du kan också hämta ID:t med kommandot az resource show :

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

Modulen metrics-collector kräver Azure Resource Manager-ID för IoT Central-programmet som IoT Edge-enheten tillhör. Ange det här ID:t som värdet för ResourceID-miljövariabeln .

Resurs-ID:t har följande format:

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

Du hittar resurs-ID:t på sidan Egenskaper i IoT Central-programmet i Azure-portalen.

Du kan också hämta ID:t med kommandot az resource show :

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

Konfigurationsalternativet UploadTarget styr om mått skickas direkt till Azure Monitor eller till IoT Hub.

Om du anger UploadTarget till IoTMessage publiceras modulmåtten som IoT-meddelanden. Dessa meddelanden genereras som UTF8-kodad json från slutpunkten /messages/modules/<metrics collector module name>/outputs/metricOutput. Om modulen IoT Edge Metrics Collector till exempel heter IoTEdgeMetricsCollector är /messages/modules/IoTEdgeMetricsCollector/outputs/metricOutputslutpunkten . Formatet är följande:

[{
    "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"
    }
}]

Konfigurationsalternativet UploadTarget styr om mått skickas direkt till Azure Monitor eller till IoT Central.

Om du anger UploadTarget till IoTMessage publiceras modulmåtten som IoT-meddelanden. Dessa meddelanden genereras som UTF8-kodad json från slutpunkten /messages/modules/<metrics collector module name>/outputs/metricOutput. Om modulen IoT Edge Metrics Collector till exempel heter IoTEdgeMetricsCollector är /messages/modules/IoTEdgeMetricsCollector/outputs/metricOutputslutpunkten . Formatet är följande:

[{
    "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"
    }
}]

Ibland är det nödvändigt att mata in mått via IoT Hub i stället för att skicka dem direkt till Log Analytics. När du till exempel övervakar IoT Edge-enheter i en kapslad konfiguration där underordnade enheter endast har åtkomst till IoT Edge-hubben för sin överordnade enhet. Ett annat exempel är när du distribuerar en IoT Edge-enhet med utgående nätverksåtkomst endast till IoT Hub.

För att aktivera övervakning i det här scenariot kan modulen metrics-collector konfigureras för att skicka mått som meddelanden från enhet till moln (D2C) via edgeHub-modulen. Funktionen kan aktiveras genom att ställa in UploadTarget miljövariabeln på IoTMessage i insamlarens konfiguration.

Det här alternativet kräver extra installation, ett molnarbetsflöde, för att leverera måttmeddelanden som anländer till IoT Hub till Log Analytics-arbetsytan. Utan den här konfigurationen fungerar inte de andra delarna av integreringen, till exempel utvalda visualiseringar och aviseringar .

Exempel på molnarbetsflöde

Ett molnarbetsflöde som levererar måttmeddelanden från IoT Hub till Log Analytics är tillgängligt som en del av IoT Edge-loggnings- och övervakningsexemplet. Exemplet kan distribueras till befintliga molnresurser eller fungera som en referens för produktionsdistribution.

Ibland är det nödvändigt att mata in mått via IoT Central i stället för att skicka dem direkt till Log Analytics. När du till exempel övervakar IoT Edge-enheter i en kapslad konfiguration där underordnade enheter endast har åtkomst till IoT Edge-hubben för sin överordnade enhet. Ett annat exempel är när du distribuerar en IoT Edge-enhet med utgående nätverksåtkomst endast till IoT Central.

För att aktivera övervakning i det här scenariot kan modulen metrics-collector konfigureras för att skicka mått som meddelanden från enhet till moln (D2C) via edgeHub-modulen. Funktionen kan aktiveras genom att ställa in UploadTarget miljövariabeln på IoTMessage i insamlarens konfiguration.

Följande exempel på distributionsmanifestet visar konfigurationen:

{
  "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"
      }
    }
  }
}

Så här visar du måtten från din IoT Edge-enhet i ditt IoT Central-program:

• Lägg till standardgränssnittet för IoT Edge Metrics som ett ärvt gränssnitt i enhetsmallen:

  

• Använd telemetrivärdena som definierats i gränssnittet för att skapa alla instrumentpaneler som du behöver för att övervaka dina IoT Edge-enheter: