자동 IoT 디바이스 및 모듈 관리

필수 조건

• 활성화된 Azure 구독. Azure 구독이 없는 경우, 시작하기 전에 무료 계정을 만드십시오.

• Azure 구독에 있는 IoT Hub 아직 허브가 없는 경우 Azure IoT Hub 만들기 및 관리의 IoT Hub 만들기 섹션에 있는 단계를 수행할 수 있습니다.

쌍 구현

자동 디바이스 구성을 사용하려면 디바이스 쌍을 사용하여 클라우드와 디바이스 간의 상태를 동기화해야 합니다. 자세한 내용은 IoT Hub의 디바이스 쌍 이해 및 사용을 참조하세요.

자동 모듈 구성을 사용하려면 모듈 쌍을 사용하여 클라우드와 모듈 간의 상태를 동기화해야 합니다. 자세한 내용은 IoT Hub에서 모듈 쌍 이해 및 사용을 참조하세요.

태그를 사용하여 트윈 대상 지정

구성을 만들기 전에 영향을 줄 디바이스 또는 모듈을 지정해야 합니다. Azure IoT Hub는 디바이스 쌍에서 태그를 사용하여 디바이스를 식별하고 모듈 쌍의 태그를 사용하여 모듈을 식별합니다. 각 디바이스 또는 모듈에는 여러 태그가 있을 수 있으며 솔루션에 적합한 방식으로 정의할 수 있습니다. 예를 들어 다른 위치에서 디바이스를 관리하는 경우 디바이스 쌍에 다음 태그를 추가합니다.

"tags": {
    "location": {
        "state": "Washington",
        "city": "Tacoma"
    }
},

구성 만들기

표준 계층 IoT Hub에서 최대 100개의 자동 구성을 만들 수 있습니다. 무료 계층 IoT Hub에서 10개. 자세한 내용은 IoT Hub 할당량 및 제한을 참조하세요.

1. Azure Portal에서 IoT Hub로 이동합니다.

2. 서비스 메뉴의 디바이스 관리에서 구성 + 배포를 선택합니다.

3. 드롭다운 목록에서 추가를 선택하고 디바이스 쌍 구성 또는 모듈 쌍 구성을 선택합니다.

   

구성을 만드는 5단계가 있습니다. 다음 내용에서는 각 항목을 설명합니다.

이름 및 레이블

1. 구성의 고유한 이름을 입력합니다. 이름은 최대 128자까지 가능하며 소문자와 다음 특수 문자를 -+%_*!'포함할 수 있습니다. 공백이 없어야 합니다.
2. 구성을 체계화하고 설명하기 위한 레이블을 추가하세요. 레이블은 키-값 쌍(예: HostPlatform, Linux 또는 Version, 3.0.1.)입니다.
3. 다음을 선택하여 작업을 계속할 수 있습니다.

트윈 설정

각 설정에 대해 두 개의 입력을 제공하여 대상 디바이스 트윈 또는 모듈 트윈의 원하는 속성의 콘텐츠를 설정합니다. 먼저 트윈의 원하는 속성 내에서 업데이트해야 할 JSON 섹션을 가리키고 있는 트윈 경로를 지정합니다. 다음으로, 해당 위치에 삽입할 JSON 콘텐츠를 입력합니다.

예를 들어 쌍 경로를 properties.desired.chiller-water 설정한 다음, 다음 JSON 콘텐츠를 제공할 수 있습니다.

{
  "temperature": 66,
  "pressure": 28
}

전체 트윈 경로를 지정하고 대괄호 없이 값을 제공하여 개별 설정을 설정할 수도 있습니다. 예를 들어 쌍 경로를 properties.desired.chiller-water.temperature사용하여 콘텐츠를 66.로 설정합니다. 그런 다음 압력 속성에 대한 새 트윈 설정을 만듭니다.

둘 이상의 구성이 동일한 트윈 경로를 대상으로 하는 경우 우선 순위가 가장 높은 구성의 콘텐츠가 적용됩니다(우선 순위는 4단계에서 정의됨).

기존 속성을 제거하려면 속성 값을 지정합니다 null.

디바이스 쌍 설정 추가 또는 모듈 쌍 설정 추가를 선택하여 설정을 더 추가할 수 있습니다.

대상 디바이스 또는 모듈

트윈의 태그 속성을 사용하여 이 구성을 수신해야 하는 특정 디바이스 또는 모듈을 대상으로 지정합니다. 보고된 쌍둥이 속성을 대상으로 지정할 수도 있습니다.

자동 디바이스 구성은 디바이스 쌍 태그만 대상으로 지정할 수 있으며, 자동 모듈 구성은 모듈 쌍 태그만 대상으로 지정할 수 있습니다.

여러 구성이 동일한 디바이스 또는 모듈을 대상으로 할 수 있으므로 각 구성에는 우선 순위 번호가 필요합니다. 충돌이 발생하면 우선 순위가 가장 높은 구성이 우선합니다.

1. 구성 우선 순위에 대해 양의 정수로 입력합니다. 가장 높은 숫자 값은 가장 높은 우선 순위로 간주됩니다. 두 구성의 우선 순위 번호가 같으면 가장 최근에 만든 구성이 우선합니다.

2. 대상 조건을 입력하여 이 구성을 대상으로 하는 디바이스 또는 모듈을 결정합니다. 조건은 쌍 태그 또는 보고되는 쌍 속성을 기준으로 하며, 표현 형식이 일치해야 합니다.

   • 자동 디바이스 구성의 경우 대상으로 지정할 태그 또는 reported 속성만 지정할 수 있습니다. 예를 들어 tags.environment='test' 또는 properties.reported.chillerProperties.model='4000x'. 모든 디바이스를 대상으로 지정할 * 수 있습니다.

   • 자동 모듈 구성을 위해, 쿼리를 사용하여 IoT Hub에 등록된 모듈에서 태그 또는 보고된 속성을 지정합니다. 예를 들어 from devices.modules where tags.environment='test' 또는 from devices.modules where properties.reported.chillerProperties.model='4000x'. 와일드카드를 사용하여 모든 모듈을 대상으로 지정할 수는 없습니다.

Metrics

메트릭은 구성 콘텐츠를 적용한 후 디바이스 또는 모듈이 다시 보고할 수 있는 다양한 상태의 요약 수를 제공합니다. 예를 들어 보류 중인 설정 변경에 대한 메트릭, 오류 메트릭 및 성공적인 설정 변경에 대한 메트릭을 만들 수 있습니다.

각 구성에는 최대 5개의 사용자 지정 메트릭이 있을 수 있습니다.

1. 메트릭 이름의 이름을 입력합니다.

2. 메트릭 조건에 대한 쿼리를 입력합니다. 쿼리는 디바이스 트윈 보고된 속성을 기반으로 합니다. 메트릭은 쿼리에서 반환되는 행 수를 나타냅니다.

   다음은 그 예입니다.

   SELECT deviceId FROM devices 
     WHERE properties.reported.chillerWaterSettings.status='pending'
   

   예를 들어 구성이 적용된 절을 포함할 수 있습니다.

   /* Include the double brackets. */
   SELECT deviceId FROM devices 
     WHERE configurations.[[yourconfigname]].status='Applied'
   

   구성된 모듈에 대해 보고할 메트릭을 빌드하는 경우 다음 중에서 moduleId선택합니다devices.modules. 다음은 그 예입니다.

   SELECT deviceId, moduleId FROM devices.modules
     WHERE properties.reported.lastDesiredStatus.code = 200
   

구성 검토

구성 정보를 검토한 다음 제출을 선택합니다.

구성 모니터링

구성의 세부 정보를 보고 실행 중인 디바이스를 모니터링하려면 다음 단계를 사용합니다.

1. Azure Portal에서 IoT Hub로 이동합니다.

2. 서비스 메뉴의 디바이스 관리에서 구성 + 배포를 선택합니다.

3. 구성 목록을 검사합니다. 각 구성에 대해 다음 세부 정보를 볼 수 있습니다.

   • ID - 구성의 이름입니다.

   • 대상 조건 - 대상 디바이스 또는 모듈을 정의하는 데 사용되는 쿼리입니다.

   • 우선 순위 - 구성에 할당된 우선 순위 번호입니다.

   • 생성 시간 - 구성이 만들어진 시점의 타임스탬프입니다. 이 타임스탬프는 두 구성의 우선 순위가 같을 때 관계를 끊는 데 사용됩니다.

   • 시스템 메트릭 - IoT Hub에서 계산되고 개발자가 사용자 지정할 수 없는 메트릭입니다. 대상 지정은 대상 조건과 일치하는 디바이스 쌍의 수를 지정합니다. 적용은 구성에 의해 수정되는 디바이스 쌍의 수를 지정하며, 이는 우선 순위가 높은 별도의 구성도 변경한 경우 부분 수정을 포함할 수 있습니다.

   • 사용자 지정 메트릭 - 개발자가 보고된 쌍 속성에 대한 쿼리로 지정한 메트릭입니다. 구성당 최대 5개의 사용자 지정 메트릭을 정의할 수 있습니다.

4. 모니터링할 구성을 선택합니다.

5. 구성 세부 정보를 검사합니다. 탭을 사용하여 구성을 받은 디바이스에 대한 특정 세부 정보를 볼 수 있습니다.

   • 대상 디바이스 또는 대상 모듈 - 대상 조건과 일치하는 디바이스 또는 모듈입니다.

   • 메트릭 - 시스템 메트릭 및 사용자 지정 메트릭 목록입니다. 드롭다운에서 메트릭을 선택한 다음 디바이스 보기 또는 모듈 보기를 선택하여 각 메트릭에 대해 계산되는 디바이스 또는 모듈 목록을 볼 수 있습니다.

   • 레이블 - 구성을 설명하는 데 사용되는 키-값 쌍입니다. 레이블은 기능에 영향을 주지 않습니다.

   • 디바이스 쌍 설정 또는 모듈 쌍 설정 - 구성에 의해 설정된 쌍 설정(있는 경우)입니다.

구성 수정

구성을 수정하면 변경 내용이 모든 대상 디바이스 또는 모듈에 즉시 복제됩니다.

대상 조건을 업데이트하는 경우 다음 업데이트가 발생합니다.

• 트윈이 이전 대상 조건을 충족하지 않았지만 새 대상 조건을 충족하고 이 구성이 해당 트윈의 우선 순위가 가장 높은 경우 이 구성이 적용됩니다.

• 현재 이 구성을 실행하는 트윈이 더 이상 대상 조건을 충족하지 않는 경우 구성의 설정이 제거되고 트윈은 다음으로 가장 높은 우선 순위 구성에 의해 수정됩니다.

• 현재 이 구성을 실행하는 트윈이 더 이상 대상 조건을 충족하지 않고 다른 구성의 대상 조건을 충족하지 않는 경우 구성의 설정이 제거되고 트윈에서 다른 변경 내용이 수행되지 않습니다.

구성을 수정하려면 다음 단계를 사용합니다.

1. Azure Portal에서 IoT Hub로 이동합니다.
2. 서비스 메뉴의 디바이스 관리에서 구성 + 배포를 선택합니다.
3. 수정하려는 구성을 선택합니다.
4. 우선 순위, 메트릭, 대상 조건 및 레이블 필드를 업데이트할 수 있습니다.
5. 저장을 선택합니다.
6. 구성 모니터링의 단계에 따라 변경 내용이 롤아웃되는 것을 확인합니다.

구성 삭제

구성을 삭제하면 모든 디바이스 쌍이 다음으로 가장 높은 우선 순위 구성을 사용합니다. 디바이스 쌍이 다른 구성의 대상 조건을 충족하지 않으면 다른 설정이 적용되지 않습니다.

1. Azure Portal에서 IoT Hub로 이동합니다.
2. 서비스 메뉴의 디바이스 관리에서 구성 + 배포를 선택합니다.
3. 확인란을 사용하여 삭제할 구성을 선택합니다.
4. 을 선택하고을 삭제합니다.
5. 삭제를 확인하라는 메시지가 표시됩니다.

필수 조건

• 활성화된 Azure 구독. Azure 구독이 없는 경우, 시작하기 전에 무료 계정을 만드십시오.

• Azure 구독에 있는 IoT Hub 아직 허브가 없는 경우 Azure IoT Hub 만들기 및 관리의 IoT Hub 만들기 섹션에 있는 단계를 수행할 수 있습니다.

• Azure CLI를 환경에서 사용. 최소한 Azure CLI 버전은 2.0.70 이상이어야 합니다. az –-version를 사용하여 유효성을 검사하십시오. 이 버전은 az extension 명령을 지원하고 Knack 명령 프레임워크를 도입합니다.

• Azure CLI용 IoT 확장입니다.

쌍 구현

자동 디바이스 구성을 사용하려면 디바이스 쌍을 사용하여 클라우드와 디바이스 간의 상태를 동기화해야 합니다. 자세한 내용은 IoT Hub의 디바이스 쌍 이해 및 사용을 참조하세요.

자동 모듈 구성을 사용하려면 모듈 쌍을 사용하여 클라우드와 모듈 간의 상태를 동기화해야 합니다. 자세한 내용은 IoT Hub에서 모듈 쌍 이해 및 사용을 참조하세요.

태그를 사용하여 트윈 대상 지정

구성을 만들기 전에 영향을 줄 디바이스 또는 모듈을 지정해야 합니다. Azure IoT Hub는 디바이스를 식별하고 디바이스 쌍에서 태그를 사용하며 모듈 쌍의 태그를 사용하여 모듈을 식별합니다. 각 디바이스 또는 모듈에는 여러 태그가 있을 수 있으며 솔루션에 적합한 방식으로 정의할 수 있습니다. 예를 들어 다른 위치에서 디바이스를 관리하는 경우 디바이스 쌍에 다음 태그를 추가합니다.

"tags": {
	"location": {
		"state": "Washington",
		"city": "Tacoma"
    }
},

대상 콘텐츠 및 메트릭 정의

대상 콘텐츠 및 메트릭 쿼리는 설정할 원하는 디바이스 쌍 또는 모듈 쌍 속성과 측정할 보고된 속성을 설명하는 JSON 문서로 지정됩니다. Azure CLI를 사용하여 자동 구성을 만들려면 대상 콘텐츠 및 메트릭을 로컬로 .txt 파일로 저장합니다. 명령을 실행하여 디바이스에 구성을 적용할 때 이후 섹션의 파일 경로를 사용합니다.

자동 디바이스 구성에 대한 기본 대상 콘텐츠 샘플은 다음과 같습니다.

{
  "content": {
    "deviceContent": {
      "properties.desired.chillerWaterSettings": {
        "temperature": 38,
        "pressure": 78
      }
    }
  }
}

자동 모듈 구성은 유사하게 동작하지만 moduleContent 대신 deviceContent을 대상으로 지정합니다.

{
  "content": {
    "moduleContent": {
      "properties.desired.chillerWaterSettings": {
        "temperature": 38,
        "pressure": 78
      }
    }
  }
}

메트릭 쿼리의 예는 다음과 같습니다.

{
  "queries": {
    "Compliant": "select deviceId from devices where configurations.[[chillerdevicesettingswashington]].status = 'Applied' AND properties.reported.chillerWaterSettings.status='current'",
    "Error": "select deviceId from devices where configurations.[[chillerdevicesettingswashington]].status = 'Applied' AND properties.reported.chillerWaterSettings.status='error'",
    "Pending": "select deviceId from devices where configurations.[[chillerdevicesettingswashington]].status = 'Applied' AND properties.reported.chillerWaterSettings.status='pending'"
  }
}

모듈에 대한 메트릭 쿼리는 장치에 대한 쿼리와 유사하지만 moduleId에서 devices.modules을(를) 선택합니다. 다음은 그 예입니다.

{
  "queries": {
    "Compliant": "select deviceId, moduleId from devices.module where configurations.[[chillermodulesettingswashington]].status = 'Applied' AND properties.reported.chillerWaterSettings.status='current'"
  }
}

구성 만들기

표준 계층 IoT Hub에서 최대 100개의 자동 구성을 만들 수 있습니다. 무료 계층 IoT Hub에서 10개. 자세한 내용은 IoT Hub 할당량 및 제한을 참조하세요.

대상 콘텐츠 및 메트릭으로 구성된 구성을 만들어 대상 디바이스를 구성합니다. 다음 명령을 사용하여 구성을 만듭니다.

   az iot hub configuration create --config-id [configuration id] \
     --labels [labels] --content [file path] --hub-name [hub name] \
     --target-condition [target query] --priority [int] \
     --metrics [metric queries]

• -- config-id - IoT Hub에서 만든 구성의 이름입니다. 구성에 최대 128자 길이의 고유한 이름을 지정합니다. 소문자와 다음 특수 문자가 허용 -+%_*!'됩니다. 공백이 없어야 합니다.

• -- 레이블 - 구성을 추적하는 데 도움이 되는 레이블을 추가합니다. 레이블은 배포를 설명하는 이름, 값 쌍입니다. 예를 들어 HostPlatform, Linux 또는 Version, 3.0.1

• -- content - 원하는 쌍 속성으로 설정할 대상 콘텐츠의 인라인 JSON 또는 파일 경로입니다.

• -- hub-name - 구성이 만들어지는 IoT Hub의 이름입니다. 허브는 현재 구독에 있어야 합니다. 명령을 사용하여 원하는 구독으로 전환 az account set -s [subscription name]

• -- 대상 조건 - 대상 조건을 입력하여 이 구성을 대상으로 하는 디바이스 또는 모듈을 결정합니다. 자동 디바이스 구성을 위해서는 조건이 디바이스 트윈 태그 또는 디바이스 트윈 원하는 속성을 기반으로 하며, 식 형식에 맞아야 합니다. 예를 들어 tags.environment='test' 또는 properties.desired.devicemodel='4000x'. 자동 모듈 구성의 경우 조건은 모듈 쌍 태그 또는 원하는 모듈 쌍 속성을 기반으로 합니다. 예를 들어 from devices.modules where tags.environment='test' 또는 from devices.modules where properties.reported.chillerProperties.model='4000x'.

• -- priority - 양수입니다. 둘 이상의 구성이 동일한 디바이스 또는 모듈을 대상으로 하는 경우 우선 순위에 대한 숫자 값이 가장 높은 구성이 적용됩니다.

• -- 메트릭 - 메트릭 쿼리에 대한 Filepath입니다. 메트릭은 구성 콘텐츠를 적용한 후 디바이스 또는 모듈이 다시 보고할 수 있는 다양한 상태의 요약 수를 제공합니다. 예를 들어 보류 중인 설정 변경에 대한 메트릭, 오류 메트릭 및 성공적인 설정 변경에 대한 메트릭을 만들 수 있습니다.

구성 모니터링

다음 명령을 사용하여 구성의 내용을 표시합니다.

az iot hub configuration show --config-id [configuration id] \
  --hub-name [hub name]

• -- config-id - IoT Hub에 있는 구성의 이름입니다.

• -- hub-name - 구성이 존재하는 IoT Hub의 이름입니다. 허브는 현재 구독에 있어야 합니다. 명령을 az account set -s [subscription name]사용하여 원하는 구독으로 전환합니다.

명령 창에서 구성을 검사합니다.  메트릭 속성은 각 허브에서 평가되는 각 메트릭의 개수를 나열합니다.

• targetedCount - 대상 지정 조건과 일치하는 IoT Hub의 디바이스 쌍 또는 모듈 쌍 수를 지정하는 시스템 메트릭입니다.

• appliedCount - 시스템 메트릭은 대상 콘텐츠가 적용된 디바이스 또는 모듈의 수를 지정합니다.

• 사용자 지정 메트릭 - 정의한 모든 메트릭은 사용자 메트릭입니다.

다음 명령을 사용하여 각 메트릭에 대한 디바이스 ID, 모듈 ID 또는 개체 목록을 표시할 수 있습니다.

az iot hub configuration show-metric --config-id [configuration id] \
   --metric-id [metric id] --hub-name [hub name] --metric-type [type] 

• -- config-id - IoT Hub에 있는 배포의 이름입니다.

• -- metric-id - 디바이스 ID 또는 모듈 ID 목록을 보려는 메트릭의 이름입니다. 예를 들면 다음과 같습니다 appliedCount.

• -- hub-name - 배포가 있는 IoT Hub의 이름입니다. 허브는 현재 구독에 있어야 합니다. 명령을 az account set -s [subscription name]사용하여 원하는 구독으로 전환합니다.

• -- 메트릭 유형 - 메트릭 형식은 systemuser 시스템 메트릭은 다음과 같습니다 targetedCountappliedCount. 다른 모든 메트릭은 사용자 메트릭입니다.

구성 수정

구성을 수정하면 변경 내용이 모든 대상 디바이스에 즉시 복제됩니다.

대상 조건을 업데이트하는 경우 다음 업데이트가 발생합니다.

• 트윈이 이전 대상 조건을 충족하지 않았지만 새 대상 조건을 충족하고 이 구성이 해당 트윈의 우선 순위가 가장 높은 경우 이 구성이 적용됩니다.

• 현재 이 구성을 실행하는 트윈이 더 이상 대상 조건을 충족하지 않는 경우 구성의 설정이 제거되고 트윈은 다음으로 가장 높은 우선 순위 구성에 의해 수정됩니다.

• 현재 이 구성을 실행하는 트윈이 더 이상 대상 조건을 충족하지 않고 다른 구성의 대상 조건을 충족하지 않는 경우 구성의 설정이 제거되고 트윈에서 다른 변경 내용이 수행되지 않습니다.

다음 명령을 사용하여 구성을 업데이트합니다.

az iot hub configuration update --config-id [configuration id] \
   --hub-name [hub name] --set [property1.property2='value']

• -- config-id - IoT Hub에 있는 구성의 이름입니다.

• -- hub-name - 구성이 존재하는 IoT Hub의 이름입니다. 허브는 현재 구독에 있어야 합니다. 명령을 az account set -s [subscription name]사용하여 원하는 구독으로 전환합니다.

• -- set - 구성에서 속성을 업데이트합니다. 다음 속성을 업데이트할 수 있습니다.

  • targetCondition - 예: targetCondition=tags.location.state='Oregon'

  • labels

  • 우선순위

구성 삭제

구성을 삭제하면 모든 디바이스 쌍 또는 모듈 쌍이 다음으로 가장 높은 우선 순위 구성을 사용합니다. 트윈이 다른 구성의 대상 조건을 충족하지 않으면 다른 설정이 적용되지 않습니다.

다음 명령을 사용하여 구성을 삭제합니다.

az iot hub configuration delete --config-id [configuration id] \
   --hub-name [hub name] 

• -- config-id - IoT Hub에 있는 구성의 이름입니다.

• -- hub-name - 구성이 존재하는 IoT Hub의 이름입니다. 허브는 현재 구독에 있어야 합니다. 명령을 az account set -s [subscription name]사용하여 원하는 구독으로 전환합니다.