자습서: AWS Lambda 함수를 사용하여 알림 형식 지정

새 AWS Lambda 함수를 생성합니다.

1. AWS Lambda 콘솔에서 함수 생성을 선택합니다.

2. 함수 생성(Create function)에서 블루프린트 사용(Use a blueprint)을 선택합니다.

   hello-world-python 블루프린트를 검색하여 선택한 다음 구성을 선택합니다.

3. 기본 정보(Basic information)에서:

   1. Function name(함수 이름)에 이 함수 이름(format-high-temp-notification)을 입력합니다.

   2. 실행 역할 에서 AWS 정책 템플릿 에서 새 역할 생성을 선택합니다.

   3. 역할 이름에 새 역할의 이름(format-high-temp-notification-role)을 입력합니다.

   4. 정책 템플릿 - 선택 사항 에서 Amazon 게시 정책 SNS 을 검색하고 선택합니다.

   5. 함수 생성(Create function)을 선택합니다.

블루프린트 코드를 수정하여 형식을 지정하고 Amazon SNS 알림을 전송합니다.

1. 함수를 생성한 후에는 format-high-temp-notification 세부 정보 페이지가 표시됩니다. 그렇지 않은 경우 Lambda 함수 페이지에서 엽니다.

2. format-high-temp-notification 세부 정보 페이지에서 구성 탭을 선택하고 함수 코드 패널로 스크롤합니다.

3. 함수 코드(Function code) 창의 환경(Environment) 창에서 Python 파일(lambda_function.py)을 선택합니다.

4. 함수 코드(Function code) 창에서 블루프린트의 원본 프로그램 코드를 모두 삭제하고 이 코드로 교체합니다.다.

   import boto3
   #
   #   expects event parameter to contain:
   #   {
   #       "device_id": "32",
   #       "reported_temperature": 38,
   #       "max_temperature": 30,
   #       "notify_topic_arn": "arn:aws:sns:us-east-1:57EXAMPLE833:high_temp_notice"
   #   }
   # 
   #   sends a plain text string to be used in a text message
   #
   #      "Device {0} reports a temperature of {1}, which exceeds the limit of {2}."
   #   
   #   where:
   #       {0} is the device_id value
   #       {1} is the reported_temperature value
   #       {2} is the max_temperature value
   #
   def lambda_handler(event, context):
   
       # Create an SNS client to send notification
       sns = boto3.client('sns')
   
       # Format text message from data
       message_text = "Device {0} reports a temperature of {1}, which exceeds the limit of {2}.".format(
               str(event['device_id']),
               str(event['reported_temperature']),
               str(event['max_temperature'])
           )
   
       # Publish the formatted message
       response = sns.publish(
               TopicArn = event['notify_topic_arn'],
               Message = message_text
           )
   
       return response

5. 배포(Deploy)를 선택합니다.

새 창에서 에 대한 자습서에서 Amazon SNS 주제의 Amazon 리소스 이름(ARN)을 조회합니다자습서: Amazon SNS 알림 전송.

1. 새 창에서 Amazon SNS 콘솔 의 주제 페이지를 엽니다.

2. 주제 페이지의 Amazon 주제 목록에서 high_temp_notice 알림 SNS 주제를 찾습니다.

3. 다음 단계에서 사용할 high_temp_notice 알림 주제ARN의 를 찾습니다.

Lambda 함수에 대한 테스트 케이스 생성

1. 콘솔의 Lambda 함수 페이지의 format-high-temp-notification 세부 정보 페이지에서 페이지 오른쪽 상단 모서리에 있는 테스트 이벤트 선택을 선택한 다음(비활성화된 것처럼 보이더라도) 테스트 이벤트 구성을 선택합니다.

2. 테스트 이벤트 구성(Configure test event)에서 새 테스트 이벤트 구성(Create new test event)을 선택합니다.

3. 이벤트 이름에 SampleRuleOutput을 입력합니다.

4. 이벤트 이름 아래의 JSON 편집기에 이 샘플 JSON 문서를 붙여넣습니다. 이는 AWS IoT 규칙이 Lambda 함수로 전송할 항목의 예입니다.

   {
     "device_id": "32",
     "reported_temperature": 38,
     "max_temperature": 30,
     "notify_topic_arn": "arn:aws:sns:us-east-1:57EXAMPLE833:high_temp_notice"
   }

5. high_temp_notice 알림 주제ARN의 가 있는 창을 참조하고 ARN 값을 복사합니다.

6. JSON 편집기의 notify_topic_arn 값을 알림 주제의 로 바꿉ARN니다.

   AWS IoT 규칙을 생성할 때 이 ARN 값을 다시 사용할 수 있도록 이 창을 열어 둡니다.

7. 생성(Create)을 선택합니다.

샘플 데이터로 함수를 테스트합니다.

1. format-high-temp-notification 세부 정보 페이지의 오른쪽 상단 모서리에서 테스트 버튼 옆에 가 SampleRuleOutput 표시되는지 확인합니다. 그렇지 않은 경우 사용 가능한 테스트 이벤트 목록에서 선택합니다.

2. 함수에 샘플 규칙 출력 메시지를 전송하려면 테스트(Test)를 선택합니다.

AWS IoT 콘솔 의 규칙 허브를 엽니다.

규칙에서 새 규칙 생성을 시작하려면 생성을 선택합니다.

규칙 생성의 상단 부분에서:

1. 이름에 규칙 이름 wx_friendly_text를 입력합니다.

   규칙 이름은 AWS 계정 및 리전 내에서 고유해야 하며 공백이 없어야 합니다. 이 이름에 밑줄 문자를 사용하여 규칙 이름의 두 단어를 구분했습니다.

2. 설명에서 규칙을 설명합니다.

   의미 있는 설명을 사용하면 이 규칙이 수행하는 작업과 규칙을 만든 이유를 쉽게 기억할 수 있습니다. 설명은 필요한 만큼 길어질 수 있으므로 가능한 한 자세하게 설명하세요.

규칙 생성의 규칙 쿼리 문에서:

1. SQL 버전 사용에서 을 선택합니다2016-03-23.

2. 규칙 쿼리 문 편집 상자에 쿼리 문을 입력합니다.

   SELECT 
     cast(topic(2) AS DECIMAL) as device_id, 
     temperature as reported_temperature,
     30 as max_temperature,
     'arn:aws:sns:us-east-1:57EXAMPLE833:high_temp_notice' as notify_topic_arn
   FROM 'device/+/data' WHERE temperature > 30

   이 문은 다음을 수행합니다.

   • 주제 필터와 일치하고 temperature 값이 30보다 큰 device/+/data 주제가 있는 MQTT 메시지를 수신합니다.

   • 주제 문자열에서 두 번째 요소를 선택하고 10진수로 변환한 다음 device_id 필드에 할당합니다.

   • 메시지 페이로드에서 temperature 값 필드를 선택하여 reported_temperature 필드에 할당합니다.

   • 한계 값을 나타내는 상수 값 30을 생성하고 max_temperature 필드에 할당합니다.

   • notify_topic_arn 필드에 대한 상수 값을 만듭니다.

3. high_temp_notice 알림 주제ARN의 가 있는 창을 참조하고 ARN 값을 복사합니다.

4. ARN 값 바꾸기(arn:aws:sns:us-east-1:57EXAMPLE833:high_temp_notice)를 알림 주제ARN의 와 함께 규칙 쿼리 문 편집기에 추가합니다.

하나 이상의 작업 설정에서:

1. 이 규칙에 대한 규칙 작업 목록을 열려면 작업 추가를 선택합니다.

2. 작업 선택(Select an action)에서 Lambda 함수로 메시지 전송하기(Send a message to a Lambda function)를 선택합니다.

3. 작업 목록 하단에서 선택한 작업의 구성 페이지를 열려면 구성 작업을 선택합니다.

구성 작업에서:

1. 함수 이름에서 선택(Select)을 클릭합니다.

2. 를 선택합니다format-high-temp-notification.

3. 작업 구성(Configure action) 하단에서 작업 추가(Add action)를 선택합니다.

4. 규칙을 생성하려면 규칙 생성(Create a rule) 하단에서 규칙 생성(Create rule)을 선택합니다.

MQTT 콘솔 의 AWS IoT 클라이언트에서 입력 주제를 구독합니다. 이 경우 입니다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 32 reports a temperature of 38, which exceeds the limit of 30.

   메시지 주제에서 주제 ID 요소를 변경하는 경우 메시지 주제의 해당 요소에 숫자만 포함된 경우에만 topic(2) 값을 숫자 값으로 캐스팅할 수 있다는 점을 기억하세요.

온도가 한도를 초과하지 않는 MQTT 메시지를 보내 보세요.

1. MQTT 클라이언트의 구독에서 주제에 게시를 선택합니다.

2. 게시 필드에 입력 주제 이름 device/33/data를 입력합니다.

3. 여기에 표시된 샘플 데이터를 복사하고 주제 이름 아래의 편집 상자에 샘플 데이터를 붙여 넣습니다.

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

4. MQTT 메시지를 보내려면 주제에 게시를 선택합니다.

device/+/data 구독에서 전송한 메시지가 표시되어야 하지만 온도 값이 규칙 쿼리 문에서 최대 온도보다 낮기 때문에 문자 메시지를 받지 않아야 합니다.

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