메트릭 수집 및 전송

¹ 현재 옵션 1을 사용하여 IoT Edge 디바이스에서 Log Analytics로 메트릭을 직접 전송하는 것은 최소한의 설정이 필요한 좀 더 간단한 경로입니다. 특정 시나리오에서 IoT Edge 디바이스가 IoT Hub 통신할 수 있도록 옵션 2 접근 방식을 요구하지 않는 한, 첫 번째 옵션이 선호됩니다.

IoT Edge와 IoT Central에 대한 자세한 내용은 Azure IoT Central 애플리케이션에 Azure IoT Edge 디바이스 연결을 참조하세요.

메트릭 수집기 모듈에는 IoT Edge 디바이스가 속하는 IoT Hub의 Azure Resource Manager ID가 필요합니다. 이 ID를 ResourceID 환경 변수의 값으로 제공합니다.

리소스 ID의 형식은 다음과 같습니다.

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

리소스 ID는 Azure Portal에 있는 IoT Hub의 속성 페이지에서 찾을 수 있습니다.

또는 az resource show 명령을 사용하여 ID를 검색합니다.

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

메트릭 수집기 모듈에는 IoT Edge 디바이스가 속하는 IoT Central 애플리케이션의 Azure Resource Manager ID가 필요합니다. 이 ID를 ResourceID 환경 변수의 값으로 제공합니다.

리소스 ID의 형식은 다음과 같습니다.

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

리소스 ID는 Azure Portal에 있는 IoT Central 애플리케이션의 속성 페이지에서 찾을 수 있습니다.

또는 az resource show 명령을 사용하여 ID를 검색합니다.

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

UploadTarget 구성 옵션은 메트릭을 Azure Monitor로 직접 보낼지 또는 IoT Hub로 보낼지를 제어합니다.

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 Monitor에 직접 전송되는지 또는 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"
    }
}]

Log Analytics에 직접 전송하는 대신 IoT Hub를 통해 메트릭을 수집해야 하는 경우도 있습니다. 자식 디바이스에서 부모 디바이스의 IoT Edge 허브에만 액세스할 수 있는 중첩된 구성의 IoT Edge 디바이스를 모니터링하는 경우를 예로 들 수 있습니다. 또 다른 예로는 아웃바운드 네트워크 액세스 권한이 있는 IoT Edge 디바이스를 IoT Hub에 배포하는 경우가 있습니다.

이 시나리오에서 모니터링을 사용하도록 설정하려면 edgeHub 모듈을 통해 메트릭을 D2C(디바이스-클라우드) 메시지로 보내도록 메트릭 수집기 모듈을 구성할 수 있습니다. 수집기 구성에서 UploadTarget 환경 변수를 IoTMessage로 설정하여 이 기능을 켤 수 있습니다.

이 옵션은 IoT Hub에 도착하는 메트릭 메시지를 Log Analytics 작업 영역으로 배달하기 위해 추가 설정인 클라우드 워크플로가 필요합니다. 설정이 없으면 큐레이팅된 시각화, 경고 등의 다른 통합 부분이 작동하지 않습니다.

샘플 클라우드 워크플로

IoT Hub에서 Log Analytics로 메트릭 메시지를 배달하는 클라우드 워크플로는 IoT Edge 로깅 및 모니터링 샘플의 일부로 제공됩니다. 이 샘플을 기존 클라우드 리소스에 배포하거나 프로덕션 배포 참조로 사용할 수 있습니다.

Log Analytics에 직접 전송하는 대신 IoT Central을 통해 메트릭을 수집해야 하는 경우도 있습니다. 자식 디바이스에서 부모 디바이스의 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: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 디바이스를 모니터링하는 데 필요한 대시보드를 빌드합니다.