Zbieranie i transport metryk

^{1 Obecnie użycie opcji 1} do bezpośredniego transportu metryk do usługi Log Analytics z urządzenia usługi IoT Edge jest prostszą ścieżką, która wymaga minimalnej konfiguracji. Pierwsza opcja jest preferowana, chyba że dany scenariusz wymaga podejścia opcji 2 , aby urządzenie usługi IoT Edge komunikowało się tylko z usługą IoT Hub.

Aby dowiedzieć się więcej na temat usług IoT Edge i IoT Central, zobacz Połączenie urządzeniach usługi Azure IoT Edge do aplikacji usługi Azure IoT Central.

Moduł modułu zbierającego metryki wymaga identyfikatora usługi Azure Resource Manager centrum IoT Hub, do którego należy urządzenie usługi IoT Edge. Podaj ten identyfikator jako wartość zmiennej środowiskowej ResourceID .

Identyfikator zasobu ma następujący format:

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

Identyfikator zasobu można znaleźć na stronie Właściwości centrum IoT Hub w witrynie Azure Portal.

Możesz też pobrać identyfikator za pomocą polecenia az resource show :

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

Moduł metrics-collector wymaga identyfikatora usługi Azure Resource Manager aplikacji usługi IoT Central, do którego należy urządzenie usługi IoT Edge. Podaj ten identyfikator jako wartość zmiennej środowiskowej ResourceID .

Identyfikator zasobu ma następujący format:

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

Identyfikator zasobu można znaleźć na stronie Właściwości aplikacji usługi IoT Central w witrynie Azure Portal.

Możesz też pobrać identyfikator za pomocą polecenia az resource show :

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

Opcja konfiguracji UploadTarget określa, czy metryki są wysyłane bezpośrednio do usługi Azure Monitor, czy do usługi IoT Hub.

Jeśli ustawisz wartość UploadTarget na IoTMessage, metryki modułu zostaną opublikowane jako komunikaty IoT. Te komunikaty są emitowane jako kodowane w formacie UTF8 w formacie json z punktu końcowego /messages/modules/<metrics collector module name>/outputs/metricOutput. Jeśli na przykład moduł zbierający metryki usługi IoT Edge ma nazwę IoTEdgeMetricsCollector, punkt końcowy to /messages/modules/IoTEdgeMetricsCollector/outputs/metricOutput. Format jest następujący:

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

Opcja konfiguracji UploadTarget określa, czy metryki są wysyłane bezpośrednio do usługi Azure Monitor, czy do usługi IoT Central.

Jeśli ustawisz wartość UploadTarget na IoTMessage, metryki modułu zostaną opublikowane jako komunikaty IoT. Te komunikaty są emitowane jako kodowane w formacie UTF8 w formacie json z punktu końcowego /messages/modules/<metrics collector module name>/outputs/metricOutput. Jeśli na przykład moduł zbierający metryki usługi IoT Edge ma nazwę IoTEdgeMetricsCollector, punkt końcowy to /messages/modules/IoTEdgeMetricsCollector/outputs/metricOutput. Format jest następujący:

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

Czasami konieczne jest pozyskiwanie metryk za pośrednictwem usługi IoT Hub zamiast wysyłania ich bezpośrednio do usługi Log Analytics. Na przykład podczas monitorowania urządzeń usługi IoT Edge w konfiguracji zagnieżdżonej, w której urządzenia podrzędne mają dostęp tylko do centrum usługi IoT Edge urządzenia nadrzędnego. Innym przykładem jest wdrożenie urządzenia usługi IoT Edge z dostępem wychodzącym tylko do usługi IoT Hub.

Aby włączyć monitorowanie w tym scenariuszu, moduł modułu zbierającego metryki można skonfigurować do wysyłania metryk jako komunikatów urządzenie-chmura (D2C) za pośrednictwem modułu edgeHub. Tę funkcję można włączyć, ustawiając zmienną UploadTarget środowiskową na IoTMessage wartość w konfiguracji modułu zbierającego.

Ta opcja wymaga dodatkowej konfiguracji, przepływu pracy w chmurze w celu dostarczania komunikatów metryk przychodzących do usługi IoT Hub do obszaru roboczego usługi Log Analytics. Bez tej konfiguracji inne części integracji, takie jak wyselekcjonowane wizualizacje i alerty, nie działają.

Przykładowy przepływ pracy w chmurze

Przepływ pracy w chmurze, który dostarcza komunikaty metryk z usługi IoT Hub do usługi Log Analytics, jest dostępny w ramach przykładu rejestrowania i monitorowania usługi IoT Edge. Przykład można wdrożyć w istniejących zasobach w chmurze lub służyć jako dokumentacja wdrożenia produkcyjnego.

Czasami konieczne jest pozyskiwanie metryk za pośrednictwem usługi IoT Central zamiast wysyłania ich bezpośrednio do usługi Log Analytics. Na przykład podczas monitorowania urządzeń usługi IoT Edge w konfiguracji zagnieżdżonej, w której urządzenia podrzędne mają dostęp tylko do centrum usługi IoT Edge urządzenia nadrzędnego. Innym przykładem jest wdrożenie urządzenia usługi IoT Edge z dostępem wychodzącym tylko do usługi IoT Central.

Aby włączyć monitorowanie w tym scenariuszu, moduł modułu zbierającego metryki można skonfigurować do wysyłania metryk jako komunikatów urządzenie-chmura (D2C) za pośrednictwem modułu edgeHub. Tę funkcję można włączyć, ustawiając zmienną UploadTarget środowiskową na IoTMessage wartość w konfiguracji modułu zbierającego.

Poniższy przykładowy manifest wdrożenia przedstawia konfigurację:

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

Aby wyświetlić metryki z urządzenia usługi IoT Edge w aplikacji usługi IoT Central:

• Dodaj standardowy interfejs metryk usługi IoT Edge jako dziedziczony interfejs do szablonu urządzenia:

  

• Użyj wartości telemetrii zdefiniowanych w interfejsie, aby utworzyć wszystkie pulpity nawigacyjne potrzebne do monitorowania urządzeń usługi IoT Edge: