자습서: Amazon SNS 알림 전송

1단계: SMS 문자 메시지를 전송하는 Amazon SNS 주제 생성 2단계: 문자 메시지를 보내는 AWS IoT 규칙 만들기 3단계: AWS IoT 규칙 및 Amazon SNS 알림 테스트 4단계: 결과 및 다음 단계 검토

이 자습서에서는 MQTT 메시지 데이터를 Amazon SNS 주제로 전송하여 SMS 텍스트 메시지로 전송할 수 있는 AWS IoT 규칙을 생성하는 방법을 보여줍니다.

이 자습서에서는 온도가 규칙에 설정된 값을 초과할 때마다 기후 센서에서 Amazon SNS 주제의 모든 구독자에게 메시지 데이터를 전송하는 규칙을 생성합니다. 이 규칙은 보고된 온도가 규칙에 의해 설정된 값을 초과할 때를 감지하고 디바이스 ID, 보고된 온도 및 초과된 온도 제한만 포함하는 새 메시지 페이로드를 생성합니다. 이 규칙은 새 메시지 페이로드를 JSON 문서로 SNS 주제에 전송하여 모든 구독자에게 SNS 주제를 알립니다.

이 자습서에서 배울 내용:

Amazon SNS 알림을 생성하고 테스트하는 방법
AWS IoT 규칙에서 Amazon SNS 알림을 호출하는 방법
규칙 쿼리 문에서 간단한 SQL 쿼리 및 함수를 사용하는 방법
MQTT 클라이언트를 사용하여 규칙을 테스트하는 AWS IoT 방법

이 자습서는 완료하는 데 약 30분 걸립니다.

이 자습서를 시작하기 전에 다음 사항을 확인해야 합니다.

설정하기 AWS 계정

이 튜토리얼을 완료하려면 AWS 계정 및 AWS IoT 콘솔이 필요합니다.
검토된 MQTT 클라이언트에서 MQTT 메시지를 확인하세요 AWS IoT .

MQTT 클라이언트를 사용하여 주제를 구독하고 게시할 수 있는지 확인하세요. 이 절차에서는 MQTT 클라이언트를 사용하여 새 규칙을 테스트합니다.
Amazon Simple Notification Service를 검토했습니다.

이전에 Amazon SNS 사용한 적이 없는 경우 Amazon SNS 액세스 설정을 검토합니다. 다른 AWS IoT 자습서를 이미 AWS 계정 완료했다면 이미 올바르게 구성되어 있을 것입니다.

SMS 문자 메시지를 전송하는 Amazon SNS 주제를 생성하려면

Amazon SNS 주제를 생성합니다.
1. Amazon SNS 콘솔에 로그인합니다.
2. 왼쪽 탐색 창에서 주제를 선택합니다.
3. 주제(Topics) 페이지에서 새 주제 생성(Create new topic)을 선택합니다.
4. 세부 정보에서 표준 유형을 선택합니다. 기본적으로 콘솔은 FIFO 주제를 만듭니다.
5. 이름에 SNS 주제 이름을 입력합니다. 이 자습서에서는 high_temp_notice을 입력합니다.
6. 페이지 끝으로 스크롤하고 주제 생성을 선택합니다.
  
  콘솔에 새 주제의 세부 정보 페이지가 열립니다.
Amazon SNS 구독을 생성합니다.

참고
이 구독에서 사용하는 전화번호는 이 자습서에서 전송할 메시지에서 문자 메시지 요금을 부과할 수 있습니다.
1. high_temp_notice 주제 세부 정보 페이지에서 구독 생성(Create subscription)을 선택합니다.
2. 구독 생성에 있는 세부 정보 섹션의 프로토콜 목록에서 SMS를 선택합니다.
3. 엔드포인트에 문자 메시지를 받을 수 있는 전화 번호를 입력합니다. +로 시작하고 국가 및 지역 코드를 포함하고 다른 구두점은 포함하지 않도록 입력해야 합니다.
4. 구독 생성을 선택합니다.
Amazon SNS 알림을 테스트합니다.
1. Amazon SNS 콘솔의 왼쪽 탐색 창에서 주제를 선택합니다.
2. 주제의 세부 정보 페이지를 열려면 주제의 주제 목록에서 high_temp_notice를 선택합니다.
3. 주제에 메시지 게시(Publish message to topic) 페이지를 열려면 high_temp_notice 세부 정보 페이지에서 메시지 게시(Publish message)를 선택합니다.
4. 주제에 메시지 게시(Publish message to topic)에 있는 메시지 본문 섹션에서 엔드포인트로 전송할 메시지 본문(Message body to send to the endpoint)에 짧은 메시지를 입력합니다.
5. 페이지의 하단으로 스크롤하고 메시지 게시(Publish message)를 선택합니다.
6. 구독을 만들 때 이전에 사용한 번호가 있는 전화에서 메시지가 수신되었는지 확인하세요.
테스트 메시지를 받지 못한 경우 전화 번호와 휴대 전화 설정을 다시 확인하세요.

자습서를 계속하기 전에 Amazon SNS 콘솔에서 테스트 메시지를 게시할 수 있는지 확인하세요.

이 자습서에서 생성할 AWS IoT 규칙은 device/device_id/data MQTT 주제를 구독합니다. 여기서 device_id 는 메시지를 보낸 장치의 ID입니다. 이러한 주제는 주제 필터에서 device/+/data로 설명됩니다. 여기서 +는 두 개의 슬래시 문자 사이의 모든 문자열과 일치하는 와일드카드 문자입니다. 이 규칙은 메시지 페이로드의 temperature 필드 값도 테스트합니다.

규칙이 일치하는 주제로부터 메시지를 수신하면 주제 이름에서 device_id, 메시지 페이로드에서 temperature 값을 가져와 테스트 중인 제한에 대한 상수 값을 추가하고 이러한 값을 JSON 문서로 Amazon SNS 알림 주제에 전송합니다.

예를 들어, 기상 센서 디바이스 번호 32의 MQTT 메시지는 device/32/data 주제를 사용하고 다음과 같은 메시지 페이로드가 있습니다.


{
  "temperature": 38,
  "humidity": 80,
  "barometer": 1013,
  "wind": {
    "velocity": 22,
    "bearing": 255
  }
}

규칙의 규칙 쿼리 문은 메시지 페이로드에서 temperature 값을 가져오고 주제 이름에서 device_id를 가져오고 상수 max_temperature 값을 추가하여 다음과 같은 메시지 페이로드를 Amazon SNS 주제로 전송합니다.


{
  "device_id": "32",
  "reported_temperature": 38,
  "max_temperature": 30
}

초과 온도 값을 감지하는 AWS IoT 규칙을 생성하고 Amazon SNS 주제에 전송할 데이터를 생성하려면

AWS IoT 콘솔의 규칙 허브를 엽니다.
이것이 첫 번째 규칙인 경우 생성 또는 규칙 생성을 선택합니다.
규칙 생성(Create a rule)에서:
1. 이름(Name)에 temp_limit_notify를 입력합니다.
  
  규칙 이름은 사용자 AWS 계정 및 지역 내에서 고유해야 하며 공백을 포함할 수 없습니다. 이 이름에 밑줄 문자를 사용하여 규칙 이름의 단어를 구분했습니다.
2. 설명에서 규칙을 설명합니다.
  
  의미 있는 설명을 사용하면 이 규칙이 수행하는 작업과 규칙을 만든 이유를 쉽게 기억할 수 있습니다. 설명은 필요한 만큼 길어질 수 있으므로 가능한 한 자세하게 설명하세요.
규칙 생성의 규칙 쿼리 문에서:
1. SQL 버전 사용에서 2016-03-23을 선택합니다.
2. 규칙 쿼리 문 편집 상자에 쿼리 문을 입력합니다.
```
SELECT topic(2) as device_id, 
    temperature as reported_temperature, 
    30 as max_temperature 
  FROM 'device/+/data' 
  WHERE temperature > 30
```
  이 문은 다음을 수행합니다.
  - device/+/data 주제 필터와 일치하고 temperature 값이 30보다 큰 주제가 있는 MQTT 메시지를 수신 대기합니다.
  - 주제 문자열에서 두 번째 요소를 선택하여 device_id 필드에 할당합니다.
  - 메시지 페이로드에서 temperature 값 필드를 선택하여 reported_temperature 필드에 할당합니다.
  - 한계 값을 나타내는 상수 값 30을 생성하고 max_temperature 필드에 할당합니다.
이 규칙에 대한 규칙 작업 목록을 열려면 하나 이상의 작업 설정(Set one or more actions)에서 작업 추가(Add action)를 선택합니다.
Select an action(작업 선택)에서 SNS 푸시 알림으로 메시지 전송(Send a message as an SNS push notification)을 선택합니다.
작업 목록 하단에서 선택한 작업의 구성 페이지를 열려면 구성 작업을 선택합니다.
구성 작업에서:
1. SNS 대상에서 선택(Select)을 클릭하고 high_temp_notice라는 이름의 SNS 주제를 찾은 다음 선택(Select)을 클릭합니다.
2. 메시지 형식(Message format)에서 RAW를 선택합니다.
3. 이 작업을 수행할 수 있는 AWS IoT 액세스 권한을 부여할 역할 선택 또는 생성에서 역할 생성을 선택합니다.
4. 새 역할 생성에서 이름에 새 역할의 고유 이름을 입력합니다. 본 자습서에서는 sns_rule_role를 사용합니다.
5. 역할 생성을 선택합니다.
이 자습서를 반복하거나 기존 역할을 재사용하는 경우 계속 진행하기 전에 역할 업데이트를 선택합니다. 그러면 SNS 대상에서 작동하도록 역할의 정책 문서가 업데이트됩니다.
작업 추가를 선택하여 규칙 생성 페이지로 이동합니다.

새 작업의 타일에서 SNS 푸시 알림으로 메시지 전송하기(Send a message as an SNS push notification) 아래에서 규칙이 호출할 SNS 주제를 볼 수 있습니다.

이 규칙 작업은 이 규칙에 추가할 유일한 규칙 작업입니다.
규칙을 생성하고 이 단계를 완료하려면 규칙 생성(Create a rule)에서 하단으로 스크롤하여 규칙 생성(Create rule)을 선택합니다.

새 규칙을 테스트하려면 MQTT 클라이언트를 사용하여 이 규칙에서 사용하는 MQTT 메시지를 게시하고 구독합니다.

새 창에서 AWS IoT 콘솔의 MQTT 클라이언트를 엽니다. 이렇게 하면 MQTT 클라이언트의 구성을 그대로 유지하면서 규칙을 편집할 수 있습니다. 콘솔의 다른 페이지로 이동하기 위해 MQTT 클라이언트를 나가면 구독이나 메시지 로그가 유지되지 않습니다.

MQTT 클라이언트를 사용하여 규칙을 테스트하려면

AWS IoT 콘솔의 MQTT 클라이언트에서 입력 주제(이 경우 device/+/data)를 구독합니다.
1. MQTT 클라이언트에서 구독 아래에서 주제 구독을 선택합니다.
2. 구독 주제에 입력 주제 필터 device/+/data의 주제를 입력합니다.
3. 나머지 필드는 기본 설정을 유지합니다.
4. 주제 구독을 선택합니다.
  
  구독 열의 주제 게시 아래에 device/+/data가 나타납니다.
특정 디바이스 ID device/32/data로 입력 주제에 메시지를 게시합니다. 와일드카드 문자가 포함된 MQTT 항목에는 게시할 수 없습니다.
1. MQTT 클라이언트의 구독 아래에서 주제 게시를 선택합니다.
2. 게시 필드에 입력 주제 이름 device/32/data를 입력합니다.
3. 여기에 표시된 샘플 데이터를 복사하고 주제 이름 아래의 편집 상자에 샘플 데이터를 붙여 넣습니다.
```
{
  "temperature": 38,
  "humidity": 80,
  "barometer": 1013,
  "wind": {
    "velocity": 22,
    "bearing": 255
  }
}
```
4. 주제에 게시를 선택하여 MQTT 메시지를 게시합니다.
문자 메시지가 전송되었는지 확인합니다.
1. MQTT 클라이언트의 구독 아래에서 이전에 구독한 주제 옆에 녹색 점이 있습니다.
  
  녹색 점은 마지막으로 메시지를 보았을 때 하나 이상의 새 메시지가 수신되었음을 나타냅니다.
2. 구독 아래에서 device/+/data를 선택하여 메시지 페이로드가 방금 게시한 것과 일치하고 다음과 같이 표시되는지 확인하세요.
```
{
  "temperature": 38,
  "humidity": 80,
  "barometer": 1013,
  "wind": {
    "velocity": 22,
    "bearing": 255
  }
}
```
3. SNS 주제를 구독하는 데 사용한 전화를 확인하고 메시지 페이로드의 내용이 다음과 같이 표시되는지 확인합니다.
```
{"device_id":"32","reported_temperature":38,"max_temperature":30}
```
  device_id 값은 따옴표로 묶인 문자열이고 temperature 값은 숫자여야 합니다. 이는 topic() 함수가 입력 메시지의 주제 이름에서 문자열을 추출하는 반면 temperature 값은 입력 메시지의 페이로드에서 숫자 값을 사용하기 때문입니다.
  
  device_id 값을 숫자 값으로 만들려면 규칙 쿼리 문에서 topic(2)를 다음으로 바꿉니다.
```
cast(topic(2) AS DECIMAL)
```
  주제의 해당 부분에 숫자만 포함된 경우에만 topic(2) 값을 숫자 DECIMAL 값으로 캐스팅할 수 있다는 점을 유의하세요.
온도가 한계를 초과하지 않는 MQTT 메시지를 전송해보세요.
1. MQTT 클라이언트의 구독 아래에서 주제 게시를 선택합니다.
2. 게시 필드에 입력 주제 이름 device/33/data를 입력합니다.
3. 여기에 표시된 샘플 데이터를 복사하고 주제 이름 아래의 편집 상자에 샘플 데이터를 붙여 넣습니다.
```
{
  "temperature": 28,
  "humidity": 80,
  "barometer": 1013,
  "wind": {
    "velocity": 22,
    "bearing": 255
  }
}
```
4. MQTT 메시지를 전송하려면 주제 게시를 선택합니다.
device/+/data 구독에서 전송한 메시지가 표시되어야 합니다. 그러나 온도 값이 규칙 쿼리 문에서 최대 온도보다 낮기 때문에 문자 메시지를 받지 않아야 합니다.

올바른 동작이 표시되지 않으면 문제 해결 팁을 확인합니다.

예상한 결과가 표시되지 않는 경우를 대비하여 확인해야 할 몇 가지 사항이 있습니다.

오류 배너가 있음

입력 메시지를 게시할 때 오류가 나타나면 먼저 해당 오류를 수정하세요. 다음 단계는 해당 오류를 수정하는 데 도움이 될 수 있습니다.
MQTT 클라이언트에서 입력 메시지가 표시되지 않음

device/+/data 주제 필터를 구독한 경우 입력 메시지를 device/22/data 주제에 게시할 때마다 절차에 설명된 대로 해당 메시지가 MQTT 클라이언트에 나타나야 합니다.
확인해야 할 사항
- 구독한 주제 필터 확인
  
  절차에 설명된 대로 입력 메시지 주제를 구독한 경우 게시할 때마다 입력 메시지의 복사본이 표시되어야 합니다.
  
  메시지가 표시되지 않으면 구독한 주제 이름을 확인하고 게시한 주제와 비교합니다. 주제 이름은 대소문자를 구분하며 구독한 주제는 메시지 페이로드를 게시한 주제와 동일해야 합니다.
- 메시지 게시 함수 확인
  
  MQTT 클라이언트의 구독에서 device/+/data를 선택하고 게시 메시지의 주제를 확인한 다음 주제에 게시를 선택합니다. 주제 아래의 편집 상자에서 메시지 페이로드가 메시지 목록에 나타납니다.
SMS 메시지가 수신되지 않음

규칙이 작동하려면 메시지를 수신하고 SNS 알림을 전송할 수 있도록 권한을 부여하는 올바른 정책이 있어야 하며 메시지를 수신해야 합니다.
확인해야 할 사항
- MQTT 클라이언트와 생성한 규칙을 확인하십시오. AWS 리전
  
  MQTT 클라이언트를 실행 중인 콘솔은 생성한 규칙과 동일한 AWS 리전에 있어야 합니다.
- 메시지 페이로드의 온도 값이 테스트 임계값을 초과하는지 확인
  
  규칙 쿼리 문에 정의된 대로 온도 값이 30보다 작거나 같으면 규칙은 해당 작업을 수행하지 않습니다.
- 규칙 쿼리 문의 입력 메시지 주제 확인
  
  규칙이 작동하려면 규칙 쿼리 문의 FROM 절에 있는 주제 필터와 일치하는 주제 이름이 포함된 메시지를 받아야 합니다.
  
  MQTT 클라이언트에 있는 주제의 철자와 함께 규칙 쿼리 문에서 주제 필터의 철자를 확인하세요. 주제 이름은 대/소문자를 구분하며 메시지의 주제는 규칙 쿼리 문의 주제 필터와 일치해야 합니다.
- 입력 메시지 페이로드의 내용 확인
  
  규칙이 작동하려면 SELECT 문에서 선언된 메시지 페이로드에서 데이터 필드를 찾아야 합니다.
  
  MQTT 클라이언트에 있는 메시지 페이로드의 철자와 함께 규칙 쿼리 명령문의 temperature 필드 철자를 확인하세요. 필드 이름은 대소문자를 구분하며 규칙 쿼리 문의 temperature 필드는 메시지 페이로드의 temperature 필드와 동일해야 합니다.
  
  메시지 페이로드의 JSON 문서의 형식이 올바른지 확인하세요. JSON에 쉼표 누락과 같은 오류가 있으면 규칙에서 읽을 수 없습니다.
- 규칙 동작에서 다시 게시된 메시지 주제 확인
  
  재게시 규칙 작업에서 새 메시지를 게시하는 주제는 MQTT 클라이언트에서 구독한 주제와 일치해야 합니다.
  
  콘솔에서 만든 규칙을 열고 규칙 작업이 메시지를 다시 게시할 주제를 확인합니다.
- 규칙에서 사용 중인 역할 확인
  
  규칙 작업에는 원래 주제를 받고 새 주제를 게시할 수 있는 권한이 있어야 합니다.
  
  메시지 데이터를 수신하고 다시 게시하도록 규칙을 인증하는 정책은 사용된 주제에 따라 다릅니다. 메시지 데이터를 다시 게시하는 데 사용되는 주제를 변경하는 경우 규칙 작업의 역할을 업데이트하여 현재 주제와 일치하도록 정책을 업데이트해야 합니다.
  
  문제가 의심되는 경우 규칙 재게시 작업을 편집하고 새 역할을 만듭니다. 규칙 작업에 의해 생성된 새 역할에는 이러한 작업을 수행하는 데 필요한 권한이 부여됩니다.

이 자습서에서

Amazon SNS 알림 주제 및 구독을 생성하고 테스트했습니다.
규칙 쿼리 문에서 간단한 SQL 쿼리 및 함수를 사용하여 알림에 대한 새 메시지를 만들었습니다.
사용자 지정 메시지 페이로드를 사용하는 Amazon SNS 알림을 보내는 AWS IoT 규칙을 만들었습니다.
MQTT 클라이언트를 사용하여 규칙을 테스트했습니다. AWS IoT

다음 단계

이 규칙을 사용하여 몇 가지 문자 메시지를 전송한 후 이 규칙을 실험하여 자습서의 일부 측면을 변경하면 메시지가 전송되는 시기에 영향을 받는지 확인하세요. 다음은 시작하는 데 도움이 될 몇 가지 아이디어입니다.

입력 메시지의 주제에서 device_id를 변경하고 문자 메시지 내용의 영향을 관찰합니다.
규칙 쿼리 문에서 선택한 필드를 변경하고 텍스트 메시지 내용의 영향을 관찰합니다.
최대 온도 대신 최소 온도에 대한 테스트 규칙 쿼리 문에서 테스트를 변경합니다. max_temperature 이름을 변경하는 것을 잊지 마세요!
SNS 알림이 전송될 때 MQTT 메시지를 전송하기 위한 재게시 규칙 작업을 추가합니다.
이 시리즈의 다음 자습서를 사용해 보고 자습서: DynamoDB 테이블에 디바이스 데이터 저장의 방법을 알아봅니다.

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

MQTT 메시지 재게시

DynamoDB 테이블에 디바이스 데이터 저장

자습서: Amazon SNS 알림 전송

이 자습서에서 배울 내용:

이 자습서에서 배울 내용은 다음과 같습니다.

이 자습서를 시작하기 전에 다음 사항을 확인해야 합니다.

설정하기 AWS 계정

검토된 MQTT 클라이언트에서 MQTT 메시지를 확인하세요 AWS IoT .

Amazon Simple Notification Service를 검토했습니다.

1단계: SMS 문자 메시지를 전송하는 Amazon SNS 주제 생성

SMS 문자 메시지를 전송하는 Amazon SNS 주제를 생성하려면

참고

2단계: 문자 메시지를 보내는 AWS IoT 규칙 만들기

초과 온도 값을 감지하는 AWS IoT 규칙을 생성하고 Amazon SNS 주제에 전송할 데이터를 생성하려면

3단계: AWS IoT 규칙 및 Amazon SNS 알림 테스트

MQTT 클라이언트를 사용하여 규칙을 테스트하려면

SNS 메시지 규칙 문제 해결

오류 배너가 있음

MQTT 클라이언트에서 입력 메시지가 표시되지 않음

확인해야 할 사항

구독한 주제 필터 확인

메시지 게시 함수 확인

SMS 메시지가 수신되지 않음

확인해야 할 사항

MQTT 클라이언트와 생성한 규칙을 확인하십시오. AWS 리전

메시지 페이로드의 온도 값이 테스트 임계값을 초과하는지 확인

규칙 쿼리 문의 입력 메시지 주제 확인

입력 메시지 페이로드의 내용 확인

규칙 동작에서 다시 게시된 메시지 주제 확인

규칙에서 사용 중인 역할 확인

4단계: 결과 및 다음 단계 검토

이 자습서에서

다음 단계