Tutorial: Como formatar uma notificação usando uma função AWS Lambda

Criar uma nova função AWS Lambda.

1. No AWS Lambda console, selecione Criar função.

2. Em Criar função, selecione Usar um esquema.

   Pesquise e selecione o esquema hello-world-python e, em seguida, escolha Configurar.

3. Em Informações básicas:

   1. Em Nome do perfil, insira o nome da função, format-high-temp-notification.

   2. Em Função de execução, escolha Criar uma nova função a partir dos modelos AWS de política .

   3. No campo Nome do perfil, digite o nome da nova função, format-high-temp-notification-role.

   4. Em Modelos de política - opcional, pesquise e selecione a política de publicação do Amazon SNS.

   5. Escolha a opção Criar função.

Modifique o código do esquema para formatar e enviar uma notificação do Amazon SNS.

1. Depois de criar sua função, você deverá ver a página de detalhes da notificação em format-high-temp-notification. Caso contrário, abra-a na página Função do Lambda

2. Na página de detalhes format-high-temp-notification, selecione a guia Configuração e navegue até o painel Código da função

3. Na janela Código da função, no painel Ambiente, escolha o arquivo Python, lambda_function.py.

4. Na janela Código da função, exclua todo o código original do programa do esquema e substitua-o por esse código.

   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. Escolha Implantar.

Em uma nova janela, consulte o nome do recurso da Amazon (ARN) do tópico do Amazon SNS no tutorial sobre como fazer isso Tutorial:r Como enviar uma notificação do Amazon SNS.

1. Em uma nova janela, abra o console página Tópicos no console do Amazon SNS.

2. Na página Tópicos, encontre o tópico de notificação high_temp_notice na lista de tópicos do Amazon SNS.

3. Encontre o ARN do tópico de notificação high_temp_notice para usar na próxima etapa.

Crie um caso de teste para sua função do Lambda.

1. Na página Funções do Lambda do console, na página de detalhes format-high-temp-notification, escolha Selecionar um evento de teste no canto superior direito da página (mesmo que pareça desativado) e escolha Configurar eventos de teste.

2. Em Selecionar um evento de teste, escolha Configurar evento de teste.

3. Em Nome do evento, insira SampleRuleOutput.

4. No editor JSON abaixo do Nome do evento, cole esse exemplo de documento JSON. Esse é um exemplo do que a AWS IoT regra enviará para a função do Lambda.

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

5. Consulte a janela que tem o ARN do tópico de notificação high_temp_notice e copie o valor do ARN.

6. Substitua o valor notify_topic_arn no editor JSON pelo ARN do seu tópico de notificação.

   Mantenha essa janela aberta para que você possa usar esse valor de ARN novamente ao criar a regra AWS IoT.

7. Escolha Criar.

Teste a função com dados de amostra.

1. Na página de detalhes format-high-temp-notification, no canto superior direito, confirme que o termo SampleRuleOutput é exibido próximo ao botão de Teste. Caso contrário, selecione-o na lista de eventos de teste disponíveis.

2. Para enviar a mensagem de saída da regra de amostra para a função, escolha Testar.

Abra o hub RegrasAWS IoT do console.

Para começar a criar sua nova regra em Regras, escolha a opção Criar.

Na parte superior da opção Criar uma regra:

1. Em Nome, insira o nome da regra, wx_friendly_text.

   Lembre-se de que um nome de regra deve ser exclusivo na região Conta da AWS e não pode ter espaços. Usamos um caractere sublinhado nesse nome para separar as duas palavras no nome da regra.

2. Em Descrição, descreva a regra.

   Uma descrição significativa facilita lembrar o que essa regra faz e por que você a criou. A descrição pode ser tão longa quanto necessário, portanto, seja o mais detalhista possível.

Na declaração de consulta de regra de Criar uma regra:

1. Em Uso da versão SQL, selecione2016-03-23.

2. Na caixa de edição Instrução de consulta de regra, insira a instrução:

   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

   Esta declaração:

   • Recebe mensagens MQTT com um tópico que corresponda ao filtro de tópicos device/+/data e que tenha um valor temperature maior que 30.

   • Seleciona o segundo elemento da cadeia de caracteres do tópico, converte-o em um número decimal e o atribui ao campo device_id.

   • Seleciona o valor do campo temperature na carga da mensagem e o atribui ao campo reported_temperature.

   • Cria um valor constante, 30, para representar o valor limite e o atribui ao campo max_temperature.

   • Cria um valor constante para o campo notify_topic_arn.

3. Consulte a janela que tem o ARN do tópico de notificação high_temp_notice e copie o valor do ARN.

4. Substitua o valor do ARN (arn:aws:sns:us-east-1:57EXAMPLE833:high_temp_notice) no editor de instruções de consulta de regras pelo ARN do tópico de notificação.

Em Definir uma ou mais ações:

1. Para abrir a lista de ações de regra para essa regra, escolha Adicionar ação.

2. Em Selecionar uma ação, escolha Enviar uma mensagem para uma função do Lambda.

3. Para abrir a página de configuração da ação selecionada, na parte inferior da lista de ações, escolha Configurar ação.

Em Configurar ação:

1. Em Nome do perfil, escolha Selecionar.

2. Escolha a opção format-high-temp-notification.

3. Na parte inferior da opção Configurar ação, escolha Adicionar ação.

4. Para criar a regra, na parte inferior da opção Criar uma regra, escolha Criar regra.

No cliente MQTT no AWS IoT console, assine os tópicos de entrada, neste caso, device/+/data.

1. No Cliente MQTT, em Assinaturas, selecione Assine um tópico.

2. Em Tópico de assinatura, insira o tópico do filtro de tópico de entrada, device/+/data.

3. Deixe os demais campos com as configurações padrão.

4. Escolha Assinar um tópico.

   Na coluna Assinaturas, em Publicar em um tópico, device/+/data é exibido.

Publique uma mensagem no tópico de entrada com um ID de dispositivo específico, device/32/data. Você não pode publicar nos tópicos MQTT que contenham caracteres curinga.

1. No cliente MQTT, em Assinaturas, selecione Publicar em um tópico.

2. No campo Publicar, insira o nome do tópico de entrada, device/32/data.

3. Copie os dados de amostra mostrados aqui e, na caixa de edição abaixo do nome do tópico, cole os dados de amostra.

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

4. Escolha Publicar em um tópico para publicar sua mensagem MQTT.

Confirme se a mensagem de texto foi enviada.

1. No cliente MQTT, em Assinaturas, há um ponto verde ao lado do tópico assinado anteriormente.

   O ponto verde indica que uma ou mais mensagens novas foram recebidas desde a última vez que você as visualizou.

2. Em Assinaturas, escolha dispositivo/+/dado para verificar se a carga útil da mensagem corresponde ao que você acabou de publicar e tem a seguinte aparência:

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

3. Verifique o telefone utilizado para assinar o tópico do SNS e confirme se o conteúdo da carga útil da mensagem tem a seguinte aparência:

   Device 32 reports a temperature of 38, which exceeds the limit of 30.

   Se você alterar o elemento ID do tópico no tópico da mensagem, lembre-se de que converter o valor topic(2) em um valor numérico só funcionará se esse elemento no tópico da mensagem contiver somente caracteres numéricos.

Tente enviar uma mensagem MQTT na qual a temperatura não exceda o limite.

1. No cliente MQTT, em Assinaturas, selecione Publicar em um tópico.

2. No campo Publicar, insira o nome do tópico de entrada, device/33/data.

3. Copie os dados de amostra mostrados aqui e, na caixa de edição abaixo do nome do tópico, cole os dados de amostra.

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

4. Para enviar sua mensagem MQTT, escolha Publicar no tópico.

Você deve ver a mensagem que enviou na assinatura device/+/data; no entanto, como o valor da temperatura está abaixo da temperatura máxima na consulta da regra, você não deve receber uma mensagem de texto.

Se não encontrar o comportamento correto, confira as dicas de solução de problemas.