View a markdown version of this page

Überwachung der Amazon SNS-SMS-Zustellung mit CloudWatch Amazon-Metriken und -Protokollen - Amazon Simple Notification Service
CloudWatch Amazon-Metriken anzeigenCloudWatch Protokolle anzeigenBeispielprotokoll für eine erfolgreiche SMS-ZustellungBeispielprotokoll für eine fehlgeschlagene SMS-ZustellungGründe für das Fehlschlagen der SMS-Zustellung

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Überwachung der Amazon SNS-SMS-Zustellung mit CloudWatch Amazon-Metriken und -Protokollen

Sie können Amazon CloudWatch und Amazon CloudWatch Logs verwenden, um Ihre SMS-Nachrichtenzustellungen zu überwachen.

CloudWatch Amazon-Metriken anzeigen

Amazon SNS erfasst automatisch Kennzahlen zu Ihren SMS-Nachrichtenzustellungen und leitet sie an Amazon weiter. CloudWatch Sie können diese Metriken überwachen und Alarme erstellen, CloudWatch um Sie zu warnen, wenn eine Metrik einen Schwellenwert überschreitet. Beispielsweise können Sie CloudWatch Kennzahlen überwachen, um Ihre SMS-Zustellungsrate und Ihre SMS-Gebühren seit Monatsbeginn zu erfahren.

Informationen zum Überwachen von CloudWatch Messwerten, zum Einstellen von CloudWatch Alarmen und zu den verfügbaren Metriktypen finden Sie unter. Überwachung von Amazon SNS-Themen mit CloudWatch

CloudWatch Protokolle anzeigen

Sie können Daten über erfolgreiche und fehlgeschlagene SMS-Lieferungen sammeln. Aktivieren Sie Amazon SNS, um in Amazon CloudWatch Logs zu schreiben. Für jede SMS-Nachricht, die Sie senden, schreibt Amazon SNS ein Protokoll, das die Kosten für die Nachricht, den Erfolgs- oder Fehlerstatus, den Grund für das Fehlschlagen (wenn die Nachricht fehlgeschlagen ist), die Leerlaufzeit für die Nachricht und andere Informationen enthält.

Um CloudWatch Protokolle für Ihre SMS-Nachrichten zu aktivieren und anzuzeigen

  1. Melden Sie sich bei der Amazon SNS-Konsole an.

  2. Stellen Sie im Konsolenmenü die Regionsauswahl auf eine Region ein, die SMS-Nachrichten unterstützt.

  3. Wählen Sie im Navigationsbereich Text messaging (SMS) (Textnachrichten (SMS)) aus.

  4. Wählen Sie auf der Seite Mobile text messaging (SMS) (Mobile Texttnachrichten (SMS)) im Abschnitt Text messaging preferences (Textnachrichteneinstellungen) die Option Edit (Bearbeiten) aus.

  5. Erweitern Sie auf der nächsten Seite den Abschnitt Protokollierung des Zustellungsstatus.

  6. Geben Sie für die Stichprobenrate bei Erfolg den Prozentsatz der erfolgreichen SMS-Zustellungen an, für die Amazon SNS Protokolle in CloudWatch Logs schreibt. Beispiel:

    • Um nur Protokolle für fehlgeschlagene Zustellungen zu schreiben, setzen Sie diesen Wert auf 0.

    • Um Protokolle für 10 % der erfolgreichen Zustellungen zu schreiben, setzen Sie den Wert auf 10.

    Wenn Sie keinen Prozentsatz angeben, schreibt Amazon SNS Protokolle für alle erfolgreichen Zustellungen.

  7. Gehen Sie wie folgt vor, um die angeforderten Genehmigungen bereitzustellen:

    • Zum Erstellen einer neuen Servicerolle wählen Sie Neue Servicerolle erstellen und dann Neue Rollen erstellen. Wählen Sie auf der nächsten Seite Erlauben, um Amazon SNS Schreibzugriff auf die Ressourcen Ihres Kontos zu geben.

    • Um eine bestehende Servicerolle zu verwenden, wählen Sie Vorhandene Servicerolle verwenden und fügen Sie dann den ARN-Namen im Feld IAM-Rolle für erfolgreiche und fehlgeschlagene Übermittlungen.

      Die angegebene Servicerolle muss Schreibzugriff auf die Ressourcen Ihres Kontos ermöglichen. Weitere Informationen zum Erstellen von IAM-Rollen finden Sie unter Erstellen einer Rolle für einen AWS Service im IAM-Benutzerhandbuch.

  8. Wählen Sie Änderungen speichern aus.

  9. Zurück auf der Seite Text-Messaging (SMS) gehen Sie zum Abschnitt Zustellungsstatusprotokolle, um verfügbare Protokolle anzuzeigen.

    Anmerkung

    Je nach Carrier der Zieltelefonnummer kann es bis zu 72 Stunden dauern, bis Zustellungsprotokolle in der Amazon-SNS-Konsole angezeigt werden.

Beispielprotokoll für eine erfolgreiche SMS-Zustellung

Das Zustellungsstatusprotokoll für eine erfolgreiche SMS-Zustellung ähnelt dem folgenden Beispiel:

{
    "notification": {
        "messageId": "34d9b400-c6dd-5444-820d-fbeb0f1f54cf",
        "timestamp": "2016-06-28 00:40:34.558"
    },
    "delivery": {
        "phoneCarrier": "My Phone Carrier",
        "mnc": 270,
        "numberOfMessageParts": 1,
        "destination": "+1XXX5550100",
        "priceInUSD": 0.00645,
        "smsType": "Transactional",
        "mcc": 310,
        "providerResponse": "Message has been accepted by phone carrier",
        "dwellTimeMs": 599,
        "dwellTimeMsUntilDeviceAck": 1344
    },
    "status": "SUCCESS"
}

Beispielprotokoll für eine fehlgeschlagene SMS-Zustellung

Das Zustellungsstatusprotokoll für eine fehlgeschlagene SMS-Zustellung ähnelt dem folgenden Beispiel:

{
    "notification": {
        "messageId": "1077257a-92f3-5ca3-bc97-6a915b310625",
        "timestamp": "2016-06-28 00:40:34.559"
    },
    "delivery": {
        "mnc": 0,
        "numberOfMessageParts": 1,
        "destination": "+1XXX5550100",
        "priceInUSD": 0.00645,
        "smsType": "Transactional",
        "mcc": 0,
        "providerResponse": "Unknown error attempting to reach phone",
        "dwellTimeMs": 1420,
        "dwellTimeMsUntilDeviceAck": 1692
    },
    "status": "FAILURE"
}

Gründe für das Fehlschlagen der SMS-Zustellung

Der Grund für das Fehlschlagen wird mit dem providerResponse-Attribut angegeben. SMS-Nachrichten können aus den folgenden Gründen fehlschlagen:

  • Telefonnetzbetreiber hat die Nachricht als Spam blockiert

  • Ziel befindet sich auf einer blockierten Liste

  • Telefonnummer ist ungültig

  • Nachrichtentext ist ungültig

  • Telefonnentzbetreiber hat die Nachricht blockiert

  • Der Telefonanbieter ist derzeit unreachable/unavailable

  • Telefon blockiert SMS

  • Telefon befindet sich auf einer blockierten Liste

  • Telefon ist derzeit unreachable/unavailable

  • Telefonnummer lehnt Empfang ab

  • Zustellung würde den Maximalpreis überschreiten

  • Unbekannter Fehler versucht das Telefon zu erreichen