Tutorial: Formatieren einer Benachrichtigung mithilfe einer AWS Lambda Funktion

Erstellen Sie eine neue AWS Lambda Funktion.

1. Wählen Sie in der AWS Lambda Konsole die Option Create function (Funktion erstellen) aus.

2. Wählen Sie unter Funktion erstellen die Option Blueprint verwenden aus.

   Suchen Sie nach dem hello-world-python Blueprint, wählen Sie ihn aus und wählen Sie dann Konfigurieren aus.

3. Unter Grundlegende Informationen:

   1. Geben Sie unter Funktionsname den Namen dieser Funktion ein, format-high-temp-notification.

   2. Wählen Sie unter Ausführungsrolle die Option Neue Rolle aus AWS Richtlinienvorlagen erstellen aus.

   3. Geben Sie im Feld Rollenname den Namen der neuen Rolle ein, format-high-temp-notification-role.

   4. Suchen Sie unter Richtlinienvorlagen — optional nach Amazon SNS Publish Policy und wählen Sie diese aus.

   5. Wählen Sie Funktion erstellen aus.

Ändern Sie den Blueprint-Code, um ihn zu formatieren und eine SNS Amazon-Benachrichtigung zu senden.

1. Nachdem Sie Ihre Funktion erstellt haben, sollte die format-high-temp-notificationDetailseite angezeigt werden. Wenn Sie dies nicht tun, öffnen Sie es auf der Seite Lambda Funktionen.

2. Wählen Sie auf der format-high-temp-notificationDetailseite die Registerkarte Konfiguration und scrollen Sie zum Bereich Funktionscode.

3. Wählen Sie im Fenster Funktionscode im Bereich Umgebung die Python-Datei lambda_function.py aus.

4. Löschen Sie im Fenster Funktionscode den gesamten ursprünglichen Programmcode aus dem Blueprint und ersetzen Sie ihn durch diesen 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. Wählen Sie Bereitstellen.

Suchen Sie in einem neuen Fenster den Amazon-Ressourcennamen (ARN) Ihres SNS Amazon-Themas aus dem Tutorial zur VorgehensweiseTutorial: Eine SNS Amazon-Benachrichtigung senden.

1. Öffnen Sie in einem neuen Fenster die Themenseite der SNS Amazon-Konsole.

2. Suchen Sie auf der Seite Themen in der Liste der Amazon-Themen nach dem Benachrichtigungsthema high_temp_notice. SNS

3. Suchen Sie das ARNBenachrichtigungsthema high_temp_notice, das Sie im nächsten Schritt verwenden möchten.

Erstellen Sie einen Testfall für Ihre Lambda-Funktion.

1. Wählen Sie auf der Seite Lambda-Funktionen der Konsole auf der format-high-temp-notificationDetailseite in der oberen rechten Ecke der Seite die Option Testereignis auswählen aus (auch wenn es deaktiviert aussieht) und wählen Sie dann Testereignisse konfigurieren aus.

2. Wählen Sie unter Testereignis konfigurieren die Option Neues Testereignis erstellen.

3. Geben Sie unter Event name (Ereignisname) SampleRuleOutput ein.

4. Fügen Sie dieses JSON Beispieldokument im JSON Editor unter dem Namen des Ereignisses ein. Dies ist ein Beispiel dafür, was Ihre AWS IoT Regel an die Lambda-Funktion sendet.

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

5. Rufen Sie das Fenster auf, das das ARNBenachrichtigungsthema high_temp_notice enthält, und kopieren Sie den Wert. ARN

6. Ersetzen Sie den notify_topic_arn Wert im JSON Editor durch den Wert ARN aus Ihrem Benachrichtigungsthema.

   Lassen Sie dieses Fenster geöffnet, damit Sie diesen ARN Wert erneut verwenden können, wenn Sie die AWS IoT Regel erstellen.

7. Wählen Sie Create (Erstellen) aus.

Testen Sie die Funktion mit Beispieldaten.

1. Vergewissern Sie sich, dass auf der format-high-temp-notificationDetailseite in der oberen rechten Ecke der Seite neben der Schaltfläche Testen SampleRuleOutputangezeigt wird. Wenn nicht, wählen Sie es aus der Liste der verfügbaren Testereignisse aus.

2. Um die Ausgabenachricht der Beispielregel an Ihre Funktion zu senden, wählen Sie Test.

Öffnen Sie den Regel-Hub der AWS IoT Konsole.

Um mit der Erstellung Ihrer neuen Regel unter Regeln zu beginnen, wählen Sie Erstellen.

Gehen Sie im oberen Teil von Regel erstellen wie folgt vor:

1. Geben Sie im Feld Name den Namen der Regel ein, wx_friendly_text.

   Denken Sie daran, dass ein Regelname in Ihrer Region AWS-Konto und in Ihrer Region eindeutig sein muss und keine Leerzeichen enthalten darf. Wir haben in diesem Namen einen Unterstrich verwendet, um die beiden Wörter im Namen der Regel voneinander zu trennen.

2. Beschreiben Sie die Regel im Feld Beschreibung.

   Eine aussagekräftige Beschreibung macht es einfacher, sich daran zu erinnern, was diese Regel bewirkt und warum Sie sie erstellt haben. Die Beschreibung kann so lang wie nötig sein, also seien Sie so detailliert wie möglich.

In der Regelabfrageanweisung von Regel erstellen:

1. Wählen Sie unter SQL Version verwenden die Option aus2016-03-23.

2. Geben Sie im Bearbeitungsfeld Regelabfrageanweisung die folgende Anweisung ein:

   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

   Diese Aussage:

   • Sucht nach MQTT Nachrichten mit einem Thema, das dem device/+/data Themenfilter entspricht und deren temperature Wert größer als 30 ist.

   • Wählt das zweite Element aus der Themenzeichenfolge aus, konvertiert es in eine Dezimalzahl und weist es dann dem device_id Feld zu.

   • Wählt den Wert des temperature Felds aus der Nachrichtennutzlast aus und weist ihn dem reported_temperature Feld zu.

   • Erstellt einen konstanten Wert, 30, um den Grenzwert darzustellen, und weist ihn dem max_temperature Feld zu.

   • Erstellt einen konstanten Wert für das notify_topic_arn Feld.

3. Suchen Sie im Fenster nach, das das ARNBenachrichtigungsthema high_temp_notice enthält, und kopieren Sie den Wert. ARN

4. Ersetzen Sie den Wert (ARNarn:aws:sns:us-east-1:57EXAMPLE833:high_temp_notice) im Editor für Regelabfrageanweisungen mit dem Thema ARN Ihres Benachrichtigungsthemas.

Gehen Sie im Feld Eine oder mehrere Aktionen festlegen wie folgt vor:

1. Um die Liste der Regelaktionen für diese Regel zu öffnen, wählen Sie Aktion hinzufügen.

2. Wählen Sie unter Aktion auswählen die Option Nachricht an eine Lambda-Funktion senden aus.

3. Um die Konfigurationsseite der ausgewählten Aktion zu öffnen, wählen Sie unten in der Aktionsliste die Option Aktion konfigurieren aus.

Gehen Sie in Aktion konfigurieren wie folgt vor:

1. Wählen Sie unter Funktionsname die Option Auswählen aus.

2. Wählen Sie format-high-temp-notification.

3. Wählen Sie unten im Bereich Aktion konfigurieren die Option Aktion hinzufügen aus.

4. Um die Regel zu erstellen, wählen Sie unten im Bereich Eine Regel erstellen die Option Regel erstellen aus.

Abonnieren Sie im MQTT Client in der AWS IoT Konsole die Eingabethemen, in diesem Falldevice/+/data.

1. Wählen Sie im MQTT Client unter Abonnements die Option Thema abonnieren aus.

2. Geben Sie im Abonnementthema das Thema des Eingabethemenfilters device/+/data ein.

3. Belassen Sie die übrigen Felder auf ihren Standardeinstellungen.

4. Wählen Sie Thema abonnieren aus.

   In der Spalte Abonnements wird device/+/data unter In einem Thema veröffentlichen angezeigt.

Veröffentlichen Sie eine Nachricht zum Eingabethema mit einer bestimmten Geräte-ID, device/32/data. Sie können nicht zu MQTT Themen veröffentlichen, die Platzhalterzeichen enthalten.

1. Wählen Sie im MQTT Client unter Abonnements die Option Als Thema veröffentlichen aus.

2. Geben Sie im Feld Veröffentlichen den Namen des Eingabethemas device/32/data ein.

3. Kopieren Sie die hier gezeigten Beispieldaten und fügen Sie die Beispieldaten in das Bearbeitungsfeld unter dem Themennamen ein.

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

4. Um Ihre MQTT Nachricht zu veröffentlichen, wählen Sie Im Thema veröffentlichen.

Bestätigen Sie, dass die Textnachricht gesendet wurde.

1. Im MQTT Client befindet sich unter Abonnements ein grüner Punkt neben dem Thema, das Sie zuvor abonniert haben.

   Der grüne Punkt zeigt an, dass eine oder mehrere neue Nachrichten eingegangen sind, seit Sie sie das letzte Mal angesehen haben.

2. Wählen Sie unter Abonnements die Option Gerät/+/Daten aus, um zu überprüfen, ob die Nutzlast der Nachricht mit dem übereinstimmt, was Sie gerade veröffentlicht haben, und wie folgt aussieht:

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

3. Überprüfe das Telefon, mit dem du das SNS Thema abonniert hast, und vergewissere dich, dass der Inhalt der Nachrichten-Payload wie folgt aussieht:

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

   Wenn Sie das Thema-ID-Element im Nachrichtenthema ändern, denken Sie daran, dass die Umwandlung des topic(2) Werts in einen numerischen Wert nur funktioniert, wenn dieses Element im Nachrichtenthema nur numerische Zeichen enthält.

Versuchen Sie, eine MQTT Nachricht zu senden, bei der die Temperatur den Grenzwert nicht überschreitet.

1. Wählen Sie im MQTT Client unter Abonnements die Option Als Thema veröffentlichen aus.

2. Geben Sie im Feld Veröffentlichen den Namen des Eingabethemas device/33/data ein.

3. Kopieren Sie die hier gezeigten Beispieldaten und fügen Sie die Beispieldaten in das Bearbeitungsfeld unter dem Themennamen ein.

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

4. Um Ihre MQTT Nachricht zu senden, wählen Sie Im Thema veröffentlichen.

Sie sollten die Nachricht sehen, die Sie im device/+/data Abonnement gesendet haben. Da der Temperaturwert jedoch unter der Höchsttemperatur in der Regelabfrageanweisung liegt, sollten Sie keine Textnachricht erhalten.

Wenn Sie nicht das richtige Verhalten feststellen, lesen Sie die Tipps zur Fehlerbehebung.