Wie richte ich die Protokollierung für AWS End User Messaging SMS ein?

Lösung

Um den Status von SMS-, MMS- und Sprachnachrichten zu protokollieren, konfiguriere einen Konfigurationssatz und ein Ereignisziel. Ordne dann das Ereignisziel dem Konfigurationssatz zu. Du erhältst die Antwortinformationen für die Nachrichten, die du über AWS End User Messaging SMS sendest.

Einen Konfigurationssatz erstellen

Gehe wie folgt vor, um einen Konfigurationssatz zu erstellen:

1. Öffne die AWS-End-User-Messaging-SMS-Konsole.
2. Wähle im Navigationsbereich unter Konfigurationen die Option Konfigurationssätze.
3. Wähle Konfigurationssatz erstellen aus.
4. Gib unter Name des Konfigurationssatzes einen Namen ein.
5. Wähle Konfigurationssatz erstellen aus.

Das Ereignisziel erstellen und es dem Konfigurationssatz zuordnen

Der Konfigurationssatz unterstützt drei Arten von Ereigniszielen, z. B. eine Amazon-CloudWatch-Gruppe, einen Amazon-Data-Firehose-Stream oder ein Amazon Simple Notification Service (Amazon SNS)-Thema. Du kannst SMS-, MMS- und Sprachereignisse an diese Ereignisziele senden. Weitere Informationen findest du unter Ereignisziele in AWS End User Messaging SMS.

CloudWatch Logs als Ereignisziel für AWS End User Messaging SMS konfigurieren

Gehe wie folgt vor, um ein CloudWatch-Ereignisziel zu erstellen:

1. Öffne die AWS-End-User-Messaging-SMS-Konsole.
2. Wähle für Konfigurationen die Option Konfigurationssätze aus.
3. Wähle den Konfigurationssatz aus, dem ein Ereignisziel hinzugefügt werden soll.
4. Wähle Ereignisziel hinzufügen.
5. Gib unter Ereignisdetails für Name des Ereignisziels einen Namen ein.
6. Wähle in der Dropdown-Liste Zieltyp die Option Amazon CloudWatch aus.
7. Gib für IAM-Rollen-ARN den ARN der AWS Identity and Access Management (IAM)-Rolle ein.
   Hinweis: Weitere Informationen findest du unter IAM-Richtlinie für Amazon CloudWatch.
8. Gib für Protokollgruppen-ARN den ARN der CloudWatch-Protokollgruppe ein, an welche die Ereignisse übermittelt werden sollen. Informationen zum Erstellen einer CloudWatch-Protokollgruppe findest du unter Erstellen einer Protokollgruppe in CloudWatch Logs.
9. Wähle Ereignisveröffentlichung.
10. Wähle für Ereignistypen deinen Ereignistyp aus.
    Hinweis: Du kannst bestimmte Arten von Ereignissen auswählen, die du an verschiedene Ereignisziele senden möchtest. Beispielsweise kannst du alle Ereignisse im Zusammenhang mit der Übermittlung zur Speicherung an Data Firehose senden. Du kannst auch alle Fehlerereignisse an ein Amazon-SNS-Thema senden, sodass du eine Benachrichtigung erhältst, wenn sie auftreten.
    Wichtig: Wähle ALLE, um alle SMS-, MMS- und Sprachereignisse an das angegebene Ziel zu senden.
11. Wähle Ereignis erstellen aus.

Weitere Informationen findest du unter Anzeigen von an CloudWatch Logs gesendeten Protokolldaten und Einrichten eines Amazon-CloudWatch-Ereignisziels in AWS End User Messaging SMS.

Einen Firehose-Bereitstellungs-Stream als Ereignisziel für AWS End User Messaging SMS konfigurieren

Gehe wie folgt vor, um ein Firehose-Ereignisziel zu erstellen:

1. Öffne die AWS-End-User-Messaging-SMS-Konsole.
2. Wähle für Konfigurationen die Option Konfigurationssätze aus.
3. Wähle den Konfigurationssatz aus, dem ein Ereignisziel hinzugefügt werden soll.
4. Wähle Ereignisziel hinzufügen.
5. Gib unter Ereignisdetails für Name des Ereignisziels einen Namen ein.
6. Wähle in der Dropdown-Liste Zieltyp die Option Amazon Data Firehose aus.
7. Gib für IAM-Rollen-ARN den ARN der IAM-Rolle ein.
   Hinweis: Weitere Informationen findest du unter IAM-Richtlinie für Amazon Data Firehose.
8. Gib für ARN des Bereitstellungs-Streams den ARN der Firehose-Protokollgruppe ein, an welche die Ereignisse übermittelt werden sollen. Informationen zum Erstellen einer Firehose-Stream-Protokollgruppe findest du unter Tutorial: Einen Firehose-Stream von der Konsole aus erstellen.
9. Wähle Ereignisveröffentlichung.
10. Wähle für Ereignistypen deinen Ereignistyp aus.
    Hinweis: Du kannst bestimmte Arten von Ereignissen auswählen, die du an verschiedene Ereignisziele senden möchtest. Beispielsweise kannst du alle Ereignisse im Zusammenhang mit der Übermittlung zur Speicherung an Firehose senden. Du kannst auch alle Fehlerereignisse an ein Amazon-SNS-Thema senden, sodass du eine Benachrichtigung erhältst, wenn sie auftreten.
    Wichtig: Wähle ALLE, um alle SMS-, MMS- und Sprachereignisse an das angegebene Ziel zu senden.
11. Wähle Ereignis erstellen aus.

Weitere Informationen findest du unter Einrichten eines Amazon-Data-Firehose-Ereignisziels in AWS End User Messaging SMS.

Ein Amazon-SNS-Thema als Ereignisziel für AWS End User Messaging SMS konfigurieren

Gehe wie folgt vor, um ein Amazon-SNS-Ereignisziel zu erstellen:

1. Öffne die AWS-End-User-Messaging-SMS-Konsole.
2. Wähle für Konfigurationen die Option Konfigurationssätze aus.
3. Wähle den Konfigurationssatz aus, dem ein Ereignisziel hinzugefügt werden soll.
4. Wähle Ereignisziel hinzufügen.
5. Gib unter Ereignisdetails für Name des Ereignisziels einen Namen ein.
6. Wähle in der Dropdown-Liste Zieltyp die Option Amazon SNS aus.
7. Damit AWS End User Messaging SMS ein Thema in deinem Konto erstellt, wähle Neues Amazon-SNS-Thema aus.
   Hinweis: Das Thema wird automatisch mit allen erforderlichen Berechtigungen erstellt. Weitere Informationen zu Amazon-SNS-Themen findest du unter Ein Amazon SNS-Thema erstellen und Nachrichten veröffentlichen.
8. Wenn du bereits ein Amazon-SNS-Thema hast, wähle Vorhandenes Amazon-SNS-Thema in der Dropdown-Liste Thema-ARN aus.
   Hinweis: Stelle sicher, dass das Amazon-SNS-Thema über die Zugriffsrichtlinie verfügt, die es AWS End User Messaging SMS ermöglicht, im Amazon-SNS-Thema Veröffentlichungen zu machen.
9. Wähle für Ereignistypen deinen Ereignistyp aus.
   Hinweis: Du kannst bestimmte Arten von Ereignissen auswählen, die du an verschiedene Ereignisziele senden möchtest. Beispielsweise kannst du alle Ereignisse im Zusammenhang mit der Übermittlung zur Speicherung an Firehose senden. Du kannst auch alle Fehlerereignisse an ein Amazon-SNS-Thema senden, sodass du eine Benachrichtigung erhältst, wenn sie auftreten.
   Wichtig: Wähle ALLE, um alle SMS-, MMS- und Sprachereignisse an das angegebene Ziel zu senden.
10. Wähle Ereignis erstellen aus.

Wenn für das Amazon-SNS-Thema die serverseitige Verschlüsselung mit dem AWS Key Management Service aktiviert ist, füge dem zugehörigen kundenverwalteten Schlüssel die folgende Richtlinie hinzu:

{
    "Version": "2012-10-17",
    "Id": "example-ID",
    "Statement": [
        {
            "Sid": "example-statement-ID",
            "Effect": "Allow",
            "Principal": {
                "Service": "sms-voice.amazonaws.com"
            },
            "Action": [
                "kms:GenerateDataKey",
                "kms:Decrypt"
            ],
            "Resource": "*"
        }
    ]
}

Weitere Informationen findest du unter Einrichten eines Amazon-SNS-Ereignisziels in AWS End User Messaging SMS.

Hinweis: Um Ereignisse oder Übermittlungsbestätigungen an das konfigurierte Ziel zu senden, müssen die API-Anforderungen SendTextMessage, SendMediaMessage und SendVoiceMessage den Parameter für den Konfigurationssatznamen enthalten. Du kannst einem einzigen Konfigurationssatz bis zu fünf Ereignisziele zuordnen. Es kann bis zu 72 Stunden dauern, bis du SMS-Ereignisse oder Übermittlungsbestätigungen von Mobilfunkanbietern erhältst.

Ähnliche Informationen

Beispiel für Ereignisdaten von AWS End User Messaging SMS

Ereignistypen für SMS-, MMS- und Sprachnachrichten

Überwachung von AWS End User Messaging SMS