Tutorial: Formattare una notifica utilizzando una funzione AWS Lambda

Crea una nuova AWS Lambda funzione.

1. Nella console AWS Lambda scegliere Create function (Crea funzione).

2. In Create function (Crea funzione) seleziona Use a blueprint (Usa un blueprint).

   Cerca e seleziona il blueprint hello-world-python, quindi scegli Configure (Configura).

3. In Basic information (Informazioni di base):

   1. In Function name (Nome funzione), inserisci il nome della funzione, format-high-temp-notification.

   2. In Ruolo di esecuzione, scegli Crea un nuovo ruolo dai modelli di AWS policy.

   3. In Nome ruolo, inserisci il nome del nuovo ruolo, format-high-temp-notification-role.

   4. In Modelli di policy, facoltativo, cerca e seleziona Amazon SNS Publish Policy.

   5. Scegli Crea funzione.

Modifica il codice del blueprint per formattare e inviare una SNS notifica Amazon.

1. Dopo aver creato la funzione, dovresti vedere la pagina dei format-high-temp-notificationdettagli. In caso contrario, aprilo dalla pagina Lambda Funzioni.

2. Nella pagina dei format-high-temp-notificationdettagli, scegli la scheda Configurazione e scorri fino al pannello Codice funzione.

3. Nella finestra Function code (Codice della funzione), nel pannello Environment (Ambiente), scegli il file Python, lambda_function.py.

4. Nella finestra Function code (Codice della funzione), elimina tutto il codice originale del programma dal blueprint e sostituiscilo con questo codice.

   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. Seleziona Deploy (Implementa).

In una nuova finestra, cerca l'Amazon Resource Name (ARN) del tuo SNS argomento Amazon tratto dal tutorial su come farloTutorial: invio di una SNS notifica Amazon.

1. In una nuova finestra, apri la pagina Argomenti della SNS console Amazon.

2. Nella pagina Argomenti, trova l'argomento di notifica high_temp_notice nell'elenco degli argomenti di Amazon. SNS

3. Trova l'argomento ARNdi notifica high_temp_notice da utilizzare nel passaggio successivo.

Crea un test per la tua funzione Lambda.

1. Nella pagina Lambda Functions della console, nella pagina dei format-high-temp-notificationdettagli, scegli Seleziona un evento di test nell'angolo in alto a destra della pagina (anche se sembra disabilitato), quindi scegli Configura eventi di test.

2. In Configure test event (Configura eventi di test), scegli Create new test event (Crea un nuovo evento di test).

3. In Event name (Nome evento), inserisci SampleRuleOutput.

4. Nell'JSONeditor sotto Event name, incolla questo JSON documento di esempio. Questo è un esempio di ciò che la AWS IoT regola invierà alla funzione Lambda.

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

5. Fate riferimento alla finestra che contiene l'argomento ARNdella notifica high_temp_notice e copiate il valore. ARN

6. Sostituite il notify_topic_arn valore nell'JSONeditor con quello dell'argomento di ARN notifica.

   Tieni aperta questa finestra in modo da poter riutilizzare questo ARN valore quando crei la AWS IoT regola.

7. Scegli Create (Crea) .

Testare la funzione con i dati di esempio.

1. Nella pagina dei format-high-temp-notificationdettagli, nell'angolo in alto a destra della pagina, verifica che sia SampleRuleOutputvisualizzato accanto al pulsante Test. In caso contrario, sceglilo dall'elenco degli eventi di test disponibili.

2. Per inviare il messaggio di output della regola di esempio alla funzione, scegli Test.

Apri l'hub Rules della AWS IoT console.

Per iniziare a creare la nuova regola in Rules (Regole), scegli Create (Crea).

Nella parte superiore di Create a rule (Crea una regola):

1. In Name (Nome), inserisci il nome della regola, wx_friendly_text.

   Ricorda che il nome di una regola deve essere univoco all'interno della tua regione Account AWS e non può avere spazi. Abbiamo usato un carattere di sottolineatura in questo nome per separare le due parole nel nome della regola.

2. In Description (Descrizione), descrivi la regola.

   Una descrizione significativa ti aiuta a ricordare cosa fa questa regola e perché l'hai creata. La descrizione può essere lunga quanto necessario, quindi sii il più dettagliato possibile.

In Rule query statement (Istruzione query regola) di Create a rule (Crea una regola):

1. In Utilizzo della SQL versione, seleziona2016-03-23.

2. Nella casella di modifica Rule query statement (Istruzione query regola), inserisci l'istruzione:

   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

   Questa istruzione:

   • Ascolta i MQTT messaggi con un argomento che corrisponde al filtro degli device/+/data argomenti e che hanno un temperature valore maggiore di 30.

   • Seleziona il secondo elemento dalla stringa dell'argomento, lo converte in un numero decimale e quindi lo assegna al campo device_id.

   • Seleziona il valore del campo temperature dal payload del messaggio e lo assegna al campo reported_temperature.

   • Crea un valore costante, 30, per rappresentare il valore limite e lo assegna al campo max_temperature.

   • Crea un valore costante per il campo notify_topic_arn.

3. Fate riferimento alla finestra che contiene l'argomento ARNdella notifica high_temp_notice e copiate il valore. ARN

4. Sostituite il valore (ARNarn:aws:sns:us-east-1:57EXAMPLE833:high_temp_notice) nell'editor delle istruzioni di interrogazione ARN delle regole con l'argomento della notifica.

In Set one or more actions (Imposta una o più operazioni):

1. Per aprire l'elenco delle operazioni delle regole per questa regola, scegli Add action (Aggiungi operazione).

2. In Select an action (Seleziona un’operazione), scegli Send a message to a Lambda function (Invia un messaggio a una funzione Lambda).

3. Per aprire la pagina di configurazione dell’operazione selezionata, nella parte inferiore dell'elenco delle operazioni, scegli Configure action (Configura operazione).

In Configure action (Configura operazione):

1. In Function name (Nome della funzione), scegli Select (Seleziona).

2. Scegli format-high-temp-notification.

3. Nella parte inferiore di Configure action (Configura operazione), scegli Add action (Aggiungi operazione).

4. Per creare la regola, nella parte inferiore di Create a rule (Crea una regola), scegli Create a rule (Crea una regola).

Nel MQTT client della AWS IoT console, iscriviti agli argomenti di input, in questo caso,device/+/data.

1. Nel MQTT client, in Abbonamenti, scegli Sottoscrivi a un argomento.

2. In Subscription topic (Argomento sottoscrizione), inserisci l'argomento del filtro dell’argomento di input, device/+/data.

3. Lascia gli altri campi ai valori predefiniti.

4. Scegli Subscribe to topic (Effettua sottoscrizione all'argomento).

   Nella colonna Subscriptions (Sottoscrizioni), sotto Publish to a topic (Pubblica un argomento), device/+/data viene visualizzato.

Pubblicazione di un messaggio nell'argomento di input con un ID dispositivo specifico, device/32/data. Non puoi pubblicare MQTT su argomenti che contengono caratteri jolly.

1. Nel MQTT client, in Abbonamenti, scegli Pubblica su argomento.

2. Nel campo Publish (Pubblica), inserisci il nome dell'argomento di input, device/32/data.

3. Copia i dati di esempio mostrati qui e, nella casella di modifica sotto il nome dell'argomento, incolla i dati di esempio.

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

4. Per pubblicare il tuo MQTT messaggio, scegli Pubblica su argomento.

Conferma che il messaggio di testo è stato inviato.

1. Nel MQTT client, sotto Abbonamenti, c'è un punto verde accanto all'argomento a cui ti sei iscritto in precedenza.

   I punti verdi indicano che uno o più nuovi messaggi sono stati ricevuti dall'ultima volta che li hai visualizzati.

2. Sotto Subscriptions (Sottoscrizioni), scegli device/+/data (dispositivo/+/dati) per verificare che il payload del messaggio corrisponda a quello che hai appena pubblicato e assomigli a questo:

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

3. Controlla che il telefono che hai usato per iscriverti all'SNSargomento e conferma che il contenuto del payload del messaggio abbia questo aspetto:

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

   Se si modifica l'elemento ID dell’argomento nell'argomento del messaggio, tenere presente che la trasformazione del valore topic(2) in un valore numerico funzionerà solo se tale elemento nell'argomento del messaggio contiene solo caratteri numerici.

Prova a inviare un MQTT messaggio in cui la temperatura non superi il limite.

1. Nel MQTT client, in Abbonamenti, scegli Pubblica su argomento.

2. Nel campo Publish (Pubblica), inserisci il nome dell'argomento di input, device/33/data.

3. Copia i dati di esempio mostrati qui e, nella casella di modifica sotto il nome dell'argomento, incolla i dati di esempio.

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

4. Per inviare il MQTT messaggio, scegli Pubblica su argomento.

Il messaggio inviato dovrebbe essere visualizzato nella sottoscrizione device/+/data; tuttavia, poiché il valore della temperatura è inferiore alla temperatura massima nell'istruzione query della regola, non si dovrebbe ricevere un messaggio di testo.

Se il comportamento non viene visualizzato correttamente, controlla i suggerimenti per la risoluzione dei problemi.