에이전트 검사를 사용하여 Device Update for IoT Hub에서 누락된 디바이스 찾기 및 수정

에이전트 검사 기능을 사용하여 Device Update for IoT Hub에서 누락된 디바이스를 찾고 진단하고 수정하는 방법을 알아봅니다.

필수 조건

• Device Update for IoT Hub를 사용하도록 설정하여 IoT Hub에 액세스합니다.
• Device Update를 위해 프로비전되고 호환되는 PnP(플러그 앤 플레이) 모델 ID를 보고하는 IoT 디바이스(또는 시뮬레이터).

참고 항목

에이전트 유효성 검사 기능은 Device Update 에이전트가 설치되어 있고 Device Update for IoT Hub와 호환되는 항목과 맞는 PnP 모델 ID를 보고하는 디바이스에서만 유효성 검사를 수행할 수 있습니다.

Azure Portal

지원되는 브라우저:

• Microsoft Edge
• Google Chrome

Azure CLI

Azure CLI 환경:

• Azure Cloud Shell에서 Bash 환경을 사용합니다.

  

• 또는 CLI 참조 명령을 로컬에서 실행하려면 Azure CLI를 설치합니다.

  1. az login 명령을 사용하여 Azure CLI에 로그인합니다.
  2. az version을 실행하여 설치된 버전과 종속 라이브러리를 찾습니다. 최신 버전으로 업그레이드하려면 az upgrade를 실행합니다.
  3. 메시지가 표시되면 처음 사용할 때 Azure CLI 확장을 설치합니다. 이 문서의 명령은 azure-iot 확장을 사용합니다. az extension update --name azure-iot를 실행하여 최신 버전의 확장을 사용하고 있는지 확인합니다.

에이전트 검사에서 지원하는 유효성 검사

에이전트 유효성 검사 기능은 현재 위의 필수 조건을 충족하는 모든 디바이스에서 다음과 같은 유효성 검사를 수행합니다.

유효성 검사	기준
PnP 모델 ID	PnP 모델 ID는 디바이스/클라우드 통신에 사용해야 하는 PnP 모델을 설명하는 디바이스 쌍에 Device Update 에이전트가 보고하는 문자열입니다. 이 문자열은 Device Update 인터페이스를 지원하는 유효한 DTMI(디지털 트윈 모델 식별자)여야 합니다.
인터페이스 ID	인터페이스 ID는 디바이스/클라우드 통신에 사용해야 하는 Device Update 인터페이스 버전을 설명하는 디바이스 쌍에 Device Update 에이전트가 보고하는 문자열입니다. 이 문자열은 Device Update 인터페이스를 지원하는 유효한 DTMI여야 합니다.
호환성 속성 이름	CompatPropertyNames는 지정된 배포와 디바이스의 호환성을 결정하는 데 사용해야 하는 deviceProperties 필드를 설명하는 Device Update 에이전트가 디바이스 쌍에 보고하는 필드입니다. 이 필드의 값은 쉼표로 구분된 이름의 문자열이어야 합니다. 문자열은 최소 1개에서 5개까지의 이름을 포함해야 합니다. 각 이름은 <32자여야 합니다.
호환성 속성 값	호환성 속성 값은 compatPropertyNames 필드로 지정되고 Device Update 에이전트가 디바이스 쌍에 deviceProperties로 보고하는 필드:값 쌍입니다. 호환성 속성 이름에 정의된 모든 이름에는 보고된 해당 필드:값 쌍이 있어야 합니다. 각 쌍의 값은 64자로 제한됩니다.
ADU 그룹	ADU 그룹 태그는 디바이스의 디바이스 쌍에 정의되고 디바이스가 속한 디바이스 그룹을 결정하는 태그입니다(선택 사항). 지정된 경우 태그 문자열은 255자로 제한되며 영숫자와 "." 특수 문자만 포함할 수 있습니다. "-" "_" "~"

디바이스가 이러한 조건 중 하나라도 실패하면 Device Update에 제대로 표시되지 않을 수 있습니다. 지정된 조건을 충족하도록 유효하지 않은 값을 수정하면 디바이스가 Device Update에 제대로 표시됩니다. 디바이스가 Device Update 또는 에이전트 검사에 표시되지 않으면 디바이스 동기화를 실행하여 문제를 해결해야 할 수 있습니다.

에이전트 검사 결과 보기

Azure Portal

에이전트 검사 결과는 Device Update의 진단 탭에서 확인할 수 있습니다.

1. Azure Portal에서 IoT Hub로 이동합니다.
2. 탐색 메뉴에서 업데이트를 선택한 다음 진단 탭을 선택합니다.
3. 누락된 디바이스 찾기 섹션을 펼칩니다.

Azure CLI

디바이스의 상태를 보려면 az iot du device health list를 사용합니다.

device health list 명령은 다음과 같은 인수를 사용합니다.

• --account: Device Update 계정의 이름입니다.
• --instance: Device Update 인스턴스의 이름입니다.
• --filter: 디바이스 상태 또는 디바이스 ID를 필터링하는 디바이스 상태 필터입니다. 예:
  • 정상 디바이스를 모두 나열하려면 state eq 'Healthy'로 필터링합니다.
  • 비정상 디바이스를 모두 나열하려면 state eq 'Unhealthy'로 필터링합니다.
  • 대상 디바이스의 상태를 표시하려면 deviceId eq '<device_name>' 또는 deviceId eq '<device_name>' and moduleId eq '<module_name>'로 필터링합니다.

az iot du device health list --account <Device Update account name> --instance <Device Update instance name> --filter "<filter query>"

디바이스 동기화 작업 시작

디바이스가 IoT 허브에 등록되었지만 Device Update나 에이전트 검사 결과에 표시되지 않는 경우 디바이스 동기화가 트리거되어야 합니다.

각 Device Update 인스턴스에 대해 한 번에 하나의 디바이스 동기화 작업만 활성화될 수 있습니다.

Azure Portal

1. Azure Portal에서 IoT Hub로 이동합니다.
2. 탐색 메뉴에서 업데이트를 선택한 다음 진단 탭을 선택합니다.
3. 디바이스 상태 보기 섹션을 확장합니다.
4. 디바이스 동기화 시작을 선택합니다.

Azure CLI

연결된 IoT Hub에서 Device Update 인스턴스로 디바이스 및 모듈을 가져오려면 az iot du device import를 사용합니다.

az iot du device import --account <Device Update account name> --instance <Device Update instance name>

다음 단계

디바이스 업데이트의 진단 기능에 대해 자세히 알아보려면 디바이스 업데이트 진단 기능 개요를 참조하세요.