IoT Edge 배포 모니터링

적용 대상: IoT Edge 1.5

중요합니다

IoT Edge 1.5 LTS는 지원되는 릴리스입니다. IoT Edge 1.4 LTS는 2024년 11월 12일부터 수명이 종료됩니다. 이전 릴리스에 있는 경우 IoT Edge 업데이트를 참조하세요.

Azure IoT Edge는 IoT Edge 디바이스에 배포된 모듈에 대한 실시간 정보를 제공합니다. IoT Hub 서비스는 디바이스에서 상태를 가져오고 사용자에게 표시합니다. 자동 배포 및 계층화된 배포를 포함하는 규모에 맞게 수행된 배포에도 모니터링이 중요합니다.

디바이스 및 모듈에는 연결과 같은 유사한 데이터가 있으므로 디바이스 ID 또는 모듈 ID를 기반으로 값을 가져옵니다.

IoT Hub 서비스는 디바이스 및 모듈 쌍에서 보고한 데이터를 수집하고 디바이스가 가질 수 있는 다양한 상태의 수를 제공합니다. IoT Hub 서비스는 이 데이터를 4개의 메트릭 그룹으로 구성합니다.

유형	설명
대상	배포 대상 조건과 일치하는 IoT Edge 디바이스를 표시합니다.
적용됨	우선 순위가 높은 다른 배포의 대상이 아닌 대상 IoT Edge 디바이스를 표시합니다.
성공 보고	모듈이 성공적으로 배포되었다고 보고하는 IoT Edge 디바이스를 표시합니다.
오류 보고	하나 이상의 모듈을 보고하는 IoT Edge 디바이스가 성공적으로 배포되지 않음을 보여 줍니다. 오류를 조사하려면 해당 디바이스에 원격으로 연결하고 로그 파일을 봅니다.

Azure Portal에서 이 데이터를 모니터링하거나 Azure CLI를 사용할 수 있습니다.

Azure Portal에서 배포 모니터링

배포 세부 정보를 보고 실행 중인 디바이스를 모니터링하려면 다음 단계를 수행합니다.

배포 목록을 검토합니다. 각 배포에 대해 다음 세부 정보가 표시됩니다.

열	설명
아이디	배포의 이름입니다.
유형	배포 유형(배포 또는 계층화된 배포)입니다.
대상 조건	대상 디바이스를 정의하는 태그입니다.
우선 순위	배포에 할당된 우선 순위 번호입니다.
시스템 메트릭	대상 조건과 일치하는 IoT Hub의 디바이스 쌍의 수입니다. 적용된 데이터는 IoT Hub에서 모듈 트윈에 배포 콘텐츠가 적용된 디바이스 수를 보여 줍니다.
디바이스 메트릭	IoT Edge 클라이언트 런타임에서 성공 또는 오류를 보고하는 IoT Edge 디바이스의 수입니다.
사용자 지정 메트릭	배포에 대해 정의한 메트릭에 대한 데이터를 보고하는 IoT Edge 디바이스의 수입니다.
만듦	배포를 만들 때의 타임스탬프입니다. 이 타임스탬프는 두 배포의 우선 순위가 동일한 경우 연결을 중단하는 데 사용됩니다.

모니터링할 배포를 선택합니다.
배포 세부 정보 페이지에서 대상 조건 탭으로 이동합니다. 보기를 선택하여 대상 조건과 일치하는 디바이스를 나열합니다. 필요에 따라 조건 또는 우선 순위를 변경한 다음 저장을 선택합니다.
메트릭 탭을 선택합니다. 메트릭 선택 드롭다운에서 메트릭을 선택하면 결과를 표시할 수 있도록 보기 단추가 나타납니다. 메트릭 편집을 선택하여 정의한 사용자 지정 메트릭에 대한 조건을 조정합니다. 변경하면 저장 을 선택합니다.

배포를 변경하려면 배포 수정을 참조하세요.

az iot edge deployment show 명령을 사용하여 단일 배포의 세부 정보를 표시합니다.

az iot edge deployment show --deployment-id [deployment id] --hub-name [hub name]

이 명령은 다음 deployment show 매개 변수를 사용합니다.

--deployment-id - IoT Hub의 배포 이름입니다. 필수 매개 변수입니다.
--hub-name - 배포가 있는 IoT Hub의 이름입니다. 허브가 현재 구독에 있어야 합니다. 다음을 사용하여 구독으로 전환 az account set -s [subscription name]

명령 창에서 배포를 확인합니다. 이 속성은 metrics 각 허브에서 평가되는 각 메트릭의 개수를 나열합니다.

targetedCount - 대상 지정 조건과 일치하는 IoT Hub의 디바이스 쌍 수입니다.
appliedCount - IoT Hub의 모듈 쌍에 배포 콘텐츠가 적용된 디바이스 수입니다.
reportedSuccessfulCount - IoT Edge 클라이언트 런타임에서 성공을 보고하는 배포의 IoT Edge 디바이스 수입니다.
reportedFailedCount - IoT Edge 클라이언트 런타임의 실패를 보고하는 배포의 IoT Edge 디바이스 수입니다.

az iot edge deployment show-metric 명령을 사용하여 각 메트릭에 대한 디바이스 ID 또는 개체 목록을 표시합니다.

az iot edge deployment show-metric --deployment-id [deployment id] --metric-id [metric id] --hub-name [hub name]

이 명령은 다음 deployment show-metric 매개 변수를 사용합니다.

--deployment-id - IoT Hub의 배포 이름입니다.
--metric-id - 디바이스 ID 목록을 표시할 메트릭의 이름입니다. 예를 들면 다음과 같습니다 reportedFailedCount.
--hub-name - 배포가 있는 IoT Hub의 이름입니다. 허브가 현재 구독에 있어야 합니다. az account set -s [subscription name]을/를 사용하여 구독으로 전환하세요. 배포를 변경하려면 배포 수정을 참조하세요.

모 듈 쌍(주로 IoT Edge 에이전트 및 IoT Edge Hub 런타임 모듈)을 모니터링하여 IoT Edge 배포의 연결 및 상태를 확인하는 방법을 알아봅니다.