7단계: AWS IoT Core에서 장치 자산으로 데이터를 보내는 규칙 만들기 - AWS IoT SiteWise

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

7단계: AWS IoT Core에서 장치 자산으로 데이터를 보내는 규칙 만들기

이 절차에서는 에서 규칙을 설정합니다 AWS IoT Core. 규칙은 디바이스 섀도우의 알림 메시지를 해석하고 데이터를 디바이스 자산으로 전송하도록 설계되었습니다. 디바이스의 섀도가 업데이트될 AWS IoT SiteWise때마다 MQTT 메시지가 AWS IoT 전송됩니다. MQTT 메시지를 기반으로 디바이스 섀도우가 변경될 때 조치를 취하는 규칙을 생성할 수 있습니다. 이 경우 목표는 업데이트 메시지를 처리하고 속성 값을 추출하여 의 장치 자산으로 전송하는 것입니다. AWS IoT SiteWise

AWS IoT SiteWise 액션이 포함된 규칙 생성하기

  1. AWS IoT 콘솔로 이동합니다.

  2. 왼쪽 탐색 창에서 메시지 라우팅을 선택한 다음 규칙을 선택합니다.

  3. Create rule을 선택합니다.

  4. 규칙의 이름과 설명을 입력하고 다음을 선택합니다.

  5. 다음 SQL 문을 입력하고 다음을 선택합니다.

    SELECT
  *
FROM
  '$aws/things/+/shadow/update/accepted'
WHERE
  startsWith(topic(3), "SiteWiseTutorialDevice")

    이 규칙 쿼리 문은 디바이스 섀도우 서비스가 $aws/things/thingName/shadow/update/accepted에 섀도우 업데이트를 게시하기 때문에 작동합니다. 디바이스 섀도우에 대한 자세한 내용은 AWS IoT 개발자 가이드의 디바이스 섀도우 서비스를 참조하십시오.

    WHERE 절에서 이 규칙 쿼리 문은 topic(3) 함수를 사용하여 주제의 세 번째 세그먼트에서 사물 이름을 가져옵니다. 그런 다음 명령문은 자습서 디바이스의 이름과 일치하지 않는 이름을 가진 디바이스를 필터링합니다. AWS IoT SQL에 대한 자세한 내용은 AWS IoT 개발자 안내서의AWS IoT SQL 참조를 참조하십시오.

  6. 규칙 작업에서 AWS IoT SiteWise의 자산 속성에 메시지 데이터 보내기를 선택하고 다음을 수행하십시오.

    1. 속성 별칭 기준을 선택합니다.

    2. 속성 별칭에 /tutorial/device/${topic(3)}/cpu를 입력합니다.

      ${...}구문은 대체 템플릿입니다. AWS IoT 중괄호 안의 내용을 평가합니다. 이 대체 템플릿은 주제에서 사물 이름을 가져와서 각 사물에 고유한 별칭을 생성합니다. 자세한 내용은 AWS IoT 개발자 가이드의 대체 템플릿을 참조하십시오.

      참고

      대체 템플릿의 표현식은 SELECT 문과 별도로 평가되므로 대체 템플릿을 사용하면 AS 절을 사용하여 생성한 별칭은 참조할 수 없습니다. 지원되는 함수와 연산자 외에 원래 페이로드에 있는 정보만 참조할 수 있습니다.

    3. 항목 ID - 선택 사항에 ${concat(topic(3), "-cpu-", floor(state.reported.timestamp))}을 입력합니다.

      항목 ID는 각 값 입력 시도를 고유하게 식별합니다. 항목이 오류를 반환하는 경우 오류 출력에서 항목 ID를 찾아 문제를 해결할 수 있습니다. 이 항목 ID의 대체 템플릿은 사물 이름과 디바이스의 보고된 타임스탬프를 결합합니다. 예를 들어 결과 항목 ID는 SiteWiseTutorialDevice1-cpu-1579808494와 같을 수 있습니다.

    4. 초 단위 시간에 ${floor(state.reported.timestamp)}를 입력합니다.

      이 대체 템플릿은 디바이스의 보고된 타임스탬프에서 시간(초)을 계산합니다. 이 자습서에서 디바이스가 Unix 에포크 시간의 타임스탬프(초)를 부동 소수점 숫자로 보고합니다.

    5. 나노초 단위 오프셋 - 선택 사항에 ${floor((state.reported.timestamp % 1) * 1E9)}를 입력합니다.

      이 대체 템플릿은 디바이스의 보고된 타임스탬프의 소수 부분을 변환하여 초 단위 시간에서 나노초 단위 오프셋을 계산합니다.

      참고

      AWS IoT SiteWise 데이터에 Unix 에포크 타임의 현재 타임스탬프가 있어야 합니다. 디바이스가 시간을 정확하게 보고하지 않는 경우 timestamp()를 사용하여 AWS IoT 규칙 엔진에서 현재 시간을 가져올 수 있습니다. 이 함수는 시간을 밀리초 단위로 보고하므로 규칙 작업의 시간 파라미터를 다음 값으로 업데이트해야 합니다.

      • 초 단위 시간에 ${floor(timestamp() / 1E3)}를 입력합니다.

      • 나노초 단위 오프셋에 ${(timestamp() % 1E3) * 1E6}를 입력합니다.

    6. 데이터 유형에서 Double을 선택합니다.

      이 데이터 유형은 자산 모델에서 정의한 자산 속성의 데이터 유형과 일치해야 합니다.

    7. 값에는 ${state.reported.cpu}를 입력합니다. 대체 템플릿에서는 . 연산자를 사용하여 JSON 구조 내에서 값을 검색합니다.

    8. 항목 추가를 선택하여 메모리 사용량 속성에 대한 새 항목을 추가하고 해당 속성에 대해 다음 단계를 다시 완료합니다.

      1. 속성 별칭 기준을 선택합니다.

      2. 속성 별칭에 /tutorial/device/${topic(3)}/memory를 입력합니다.

      3. 항목 ID - 선택 사항에 ${concat(topic(3), "-memory-", floor(state.reported.timestamp))}을 입력합니다.

      4. 초 단위 시간에 ${floor(state.reported.timestamp)}를 입력합니다.

      5. 나노초 단위 오프셋 - 선택 사항에 ${floor((state.reported.timestamp % 1) * 1E9)}를 입력합니다.

      6. 데이터 유형에서 Double을 선택합니다.

      7. 값에는 ${state.reported.memory}를 입력합니다.

    9. IAM 역할에서 새 역할 생성을 선택하여 이 규칙 작업에 대한 IAM 역할을 생성합니다. 이 역할을 통해 AWS IoT 디바이스 플릿 자산 및 해당 자산 계층 구조의 속성으로 데이터를 푸시할 수 있습니다.

    10. 역할 이름을 입력하고 생성을 선택합니다.

  7. (선택 사항) 규칙 문제를 해결하는 데 사용할 수 있는 오류 작업을 구성합니다. 자세한 내용은 규칙 문제 해결 단원을 참조하십시오.

  8. 다음을 선택합니다.

  9. 설정을 검토하고 생성을 선택하여 규칙을 생성합니다.