Metrische gegevens verzamelen en transporten

¹ Op dit moment is het eenvoudiger om metrische gegevens rechtstreeks te transporteren naar Log Analytics vanaf het IoT Edge-apparaat. Hiervoor is minimale installatie vereist. De eerste optie heeft de voorkeur, tenzij voor uw specifieke scenario de benadering van optie 2 is vereist, zodat het IoT Edge-apparaat alleen communiceert met IoT Hub.

Zie Verbinding maken Azure IoT Edge-apparaten naar een Azure IoT Central-toepassing voor meer informatie over IoT Edge en IoT Central.

De module met metrische gegevensverzamelaar vereist de Azure Resource Manager-id van de IoT-hub waartoe het IoT Edge-apparaat behoort. Geef deze id op als de waarde van de ResourceID-omgevingsvariabele .

De resource-id heeft de volgende indeling:

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

U vindt de resource-id op de pagina Eigenschappen van de IoT-hub in Azure Portal.

Of u haalt de id op met de opdracht az resource show :

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

Voor de module met metrische gegevensverzamelaar is de Azure Resource Manager-id vereist van de IoT Central-toepassing waartoe het IoT Edge-apparaat behoort. Geef deze id op als de waarde van de ResourceID-omgevingsvariabele .

De resource-id heeft de volgende indeling:

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

U vindt de resource-id op de pagina Eigenschappen van de IoT Central-toepassing in Azure Portal.

Of u haalt de id op met de opdracht az resource show :

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

Met de configuratieoptie UploadTarget bepaalt u of metrische gegevens rechtstreeks naar Azure Monitor of naar IoT Hub worden verzonden.

Als u UploadTarget instelt op IoTMessage, worden de metrische gegevens van uw module gepubliceerd als IoT-berichten. Deze berichten worden verzonden als UTF8-gecodeerde json van het eindpunt /messages/modules/<metrics collector module name>/outputs/metricOutput. Als uw IoT Edge Metrics Collector-module bijvoorbeeld IoTEdgeMetricsCollector heet, is /messages/modules/IoTEdgeMetricsCollector/outputs/metricOutputhet eindpunt . De indeling is als volgt:

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

Met de configuratieoptie UploadTarget bepaalt u of metrische gegevens rechtstreeks naar Azure Monitor of Naar IoT Central worden verzonden.

Als u UploadTarget instelt op IoTMessage, worden de metrische gegevens van uw module gepubliceerd als IoT-berichten. Deze berichten worden verzonden als UTF8-gecodeerde json van het eindpunt /messages/modules/<metrics collector module name>/outputs/metricOutput. Als uw IoT Edge Metrics Collector-module bijvoorbeeld IoTEdgeMetricsCollector heet, is /messages/modules/IoTEdgeMetricsCollector/outputs/metricOutputhet eindpunt . De indeling is als volgt:

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

Soms is het nodig om metrische gegevens via IoT Hub op te nemen in plaats van ze rechtstreeks naar Log Analytics te verzenden. Wanneer u bijvoorbeeld IoT Edge-apparaten bewaakt in een geneste configuratie waarbij onderliggende apparaten alleen toegang hebben tot de IoT Edge-hub van hun bovenliggende apparaat. Een ander voorbeeld is bij het implementeren van een IoT Edge-apparaat met alleen uitgaande netwerktoegang tot IoT Hub.

Als u bewaking in dit scenario wilt inschakelen, kan de module metrics-collector worden geconfigureerd voor het verzenden van metrische gegevens als D2C-berichten (device-to-cloud) via de edgeHub-module. De mogelijkheid kan worden ingeschakeld door de UploadTarget omgevingsvariabele IoTMessage in te stellen in de collectorconfiguratie.

Deze optie vereist extra instellingen, een cloudwerkstroom, om metrische berichten te leveren die bij IoT Hub binnenkomen bij de Log Analytics-werkruimte. Zonder deze configuratie werken de andere delen van de integratie, zoals gecureerde visualisaties en waarschuwingen , niet.

Voorbeeld van cloudwerkstroom

Een cloudwerkstroom die metrische berichten van IoT Hub naar Log Analytics levert, is beschikbaar als onderdeel van het ioT Edge-logboekregistratie- en bewakingsvoorbeeld. Het voorbeeld kan worden geïmplementeerd op bestaande cloudresources of dienen als referentiemateriaal voor productie-implementaties.

Soms is het nodig om metrische gegevens via IoT Central op te nemen in plaats van ze rechtstreeks naar Log Analytics te verzenden. Wanneer u bijvoorbeeld IoT Edge-apparaten bewaakt in een geneste configuratie waarbij onderliggende apparaten alleen toegang hebben tot de IoT Edge-hub van hun bovenliggende apparaat. Een ander voorbeeld is het implementeren van een IoT Edge-apparaat met alleen uitgaande netwerktoegang tot IoT Central.

Als u bewaking in dit scenario wilt inschakelen, kan de module metrics-collector worden geconfigureerd voor het verzenden van metrische gegevens als D2C-berichten (device-to-cloud) via de edgeHub-module. De mogelijkheid kan worden ingeschakeld door de UploadTarget omgevingsvariabele IoTMessage in te stellen in de collectorconfiguratie.

In het volgende voorbeeldimplementatiemanifest ziet u de configuratie:

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

De metrische gegevens van uw IoT Edge-apparaat weergeven in uw IoT Central-toepassing:

• Voeg de standaardinterface van IoT Edge Metrics toe als een overgenomen interface aan uw apparaatsjabloon:

  

• Gebruik de telemetriewaarden die zijn gedefinieerd in de interface om dashboards te bouwen die u nodig hebt om uw IoT Edge-apparaten te bewaken: