SNSSMSAmazon-Lieferüberwachung mit CloudWatch Amazon-Metriken und Protokollen - Amazon Simple Notification Service

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.

SNSSMSAmazon-Lieferüberwachung 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 sammelt SNS automatisch Kennzahlen zu Ihren SMS Nachrichtenzustellungen und leitet sie an Amazon CloudWatch weiter. Sie können diese Messwerte überwachen und Alarme einrichten, CloudWatch um Sie zu benachrichtigen, wenn eine Metrik einen Schwellenwert überschreitet. Sie können beispielsweise CloudWatch Kennzahlen überwachen, um Ihre SMS Versandrate und Ihre month-to-date SMS Gebühren zu ermitteln.

Informationen zur Überwachung von CloudWatch Messwerten, zur Einstellung von CloudWatch Alarmen und zu den verfügbaren Messwerttypen finden Sie unterÜberwachung von SNS Amazon-Themen mit CloudWatch.

CloudWatch Protokolle anzeigen

Sie können Informationen über erfolgreiche und erfolglose SMS Nachrichtenzustellungen sammeln, indem Sie Amazon ermöglichen, in Amazon CloudWatch Logs SNS zu schreiben. Für jede SMS Nachricht, die Sie senden, SNS schreibt Amazon ein Protokoll, das den Nachrichtenpreis, den Erfolgs- oder Fehlerstatus, den Grund für den Fehler (falls die Nachricht fehlgeschlagen ist), die Verweildauer der Nachricht und andere Informationen enthält.

Um CloudWatch Protokolle für Ihre SMS Nachrichten zu aktivieren und einzusehen
  1. Melden Sie sich bei der SNSAmazon-Konsole an.

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

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

  4. Wählen Sie auf der Seite SMS-Nachrichten für Mobilgeräte (SMS) im Abschnitt Einstellungen für Textnachrichten die Option Bearbeiten aus.

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

  6. Geben Sie für Success sample rate den Prozentsatz der erfolgreichen SMS Lieferungen an, für SNS die Amazon CloudWatch Protokolle in Logs schreibt. Beispielsweise:

    • 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, SNS schreibt Amazon Protokolle für alle erfolgreichen Lieferungen.

  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 Zulassen aus, um Amazon SNS Schreibzugriff auf die Ressourcen Ihres Kontos zu gewähren.

    • Um eine bestehende Servicerolle zu verwenden, wählen Sie Bestehende Servicerolle verwenden und fügen Sie dann den ARN Namen in das Feld IAMRolle für erfolgreiche und fehlgeschlagene Lieferungen ein.

      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 Dienst im IAMBenutzerhandbuch.

  8. Wählen Sie Änderungen speichern.

  9. Gehen Sie zurück auf der Seite für mobile Textnachrichten (SMS) zum Abschnitt Versandstatusprotokolle, um alle verfügbaren Protokolle einzusehen.

    Anmerkung

    Abhängig vom Transporteur der Zieltelefonnummer kann es bis zu 72 Stunden dauern, bis die Lieferprotokolle in der SNS Amazon-Konsole angezeigt werden.

Beispielprotokoll für eine erfolgreiche SMS Lieferung

Das Versandstatusprotokoll für eine erfolgreiche SMS Lieferung ä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 Versandstatusprotokoll für eine fehlgeschlagene SMS Lieferung ä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" }

SMSGründe für den Fehlschlag der Lieferung

Der Grund für das Fehlschlagen wird mit dem providerResponse-Attribut angegeben. SMSNachrichten können aus den folgenden Gründen möglicherweise nicht zugestellt werden:

  • 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

  • Telefonnetzbetreiber ist derzeit nicht erreichbar/nicht verfügbar

  • Das Telefon wurde blockiert SMS

  • Telefon befindet sich auf einer blockierten Liste

  • Telefon ist derzeit nicht erreichbar/nicht verfügbar

  • Telefonnummer lehnt Empfang ab

  • Zustellung würde den Maximalpreis überschreiten

  • Unbekannter Fehler versucht das Telefon zu erreichen