Direkt zum Inhalt

Wie greife ich auf Amazon SNS-Themenzustellungsprotokolle für SMS-Nachrichten zu?

Lesedauer: 3 Minute
0

Ich möchte auf die Themenzustellungsprotokolle von Amazon Simple Notification Service (Amazon SNS) für SMS-Nachrichten zugreifen.

Behebung

Konfigurieren von SMS-Zustellungsstatus-Attributen für Amazon CloudWatch-Protokolle

Führe die folgenden Schritte aus:

  1. Öffne die Amazon-SNS-Konsole.
  2. Erweitere im Navigationsbereich die Option Mobil und wähle dann Textnachricht (SMS) aus.
  3. Wähle im Abschnitt SMS-Einstellungen die Option Bearbeiten.
  4. Erweitern Sie die Option Protokollierung des Zustellungsstatus – optional.
  5. Gib für Erfolgs-Samplerate in das %-Textfeld den Wert 100 ein.
    Hinweis: Die Erfolgsrate ist der Prozentsatz der erfolgreichen Nachrichtenübermittlungen, die protokolliert werden.
  6. Wählen Sie im Abschnitt IAM-Rollen für Servicerolle die Option Neue Servicerolle erstellen und dann Neue Rollen erstellen aus. Die AWS Identity and Access Management (IAM)-Konsole wird geöffnet.
    Hinweis: Wenn du bereits eine IAM-Rolle mit den richtigen Berechtigungen hast, wähle stattdessen Verwenden einer vorhandenen Servicerolle.
  7. Wähle auf der Seite mit den Berechtigungsanforderungen in der IAM-Konsole die Option Erlauben.
  8. Nachdem du zur Amazon SNS-Konsole zurückgekehrst, wähle Änderungen speichern.

Eine IAM-Rolle für erfolgreiche und fehlgeschlagene Lieferungen mit den folgenden Richtlinien und Vertrauensbeziehungen wird für Amazon SNS erstellt.

IAM-Rolle:

arn:aws:iam::1111111111:role/SNSSuccessFeedback

Richtlinie:

{  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "logs:CreateLogGroup",
        "logs:CreateLogStream",
        "logs:PutLogEvents",
        "logs:PutMetricFilter",
        "logs:PutRetentionPolicy"
      ],
      "Resource": [
        "*"
      ]
    }
  ]
}

Vertrauensbeziehungen:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "Service": "sns.amazonaws.com"
            },
            "Action": "sts:AssumeRole"
        }
    ]
}

Anzeigen von Protokollen des Zustellungsstatus

Führe die folgenden Schritte aus:

  1. Öffne die Amazon-CloudWatch-Konsole.

  2. Erweitere im Navigationsbereich Protokolle und wähle dann Protokollgruppen.

  3. Gib DirectPublishToPhoneNumber in das Filter-Suchfeld ein, um nur SMS-Protokollgruppen für Amazon SNS zu finden.
    Hinweis: Es kann bis zu 72 Stunden dauern, bis die Zustellungsprotokolle in der Amazon SNS-Konsole angezeigt werden, basierend auf dem Mobilfunkanbieter des Zielanschlusses.
    Zum Beispiel:
    Die Protokollgruppe sns/your-AWS-region/your-AWS-account-ID/DirectPublishToPhoneNumber enthält die Protokolle erfolgreicher Zustellungen:

    sns/us-east-1/1111111111/DirectPublishToPhoneNumber
    

    Beispiel für Protokolle erfolgreicher Zustellungen:

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

    Die Protokollgruppe sns/your-AWS-region/your-AWS-account-ID/DirectPublishToPhoneNumber/Failure enthält die Protokolle fehlerhafter Zustellungen:

    sns/us-east-1/1111111111/DirectPublishToPhoneNumber/Failure

    Beispiele für Protokolle fehlerhafter Zustellungen:

    {
        "notification": {
            "messageId": "1077257a-92f3-5ca3-bc97-6a915b310625",
            "timestamp": "2016-06-28 00:40:34.559"
        },
        "delivery": {
            "mnc": 0,
            "destination": "+1XXX5550100",
            "priceInUSD": 0.00645,
            "smsType": "Transactional",
            "mcc": 0,
            "providerResponse": "Unknown error attempting to reach phone",
            "dwellTimeMs": 1420,
            "dwellTimeMsUntilDeviceAck": 1692
        },
        "status": "FAILURE"
    }
  4. Wähle die SNS-Protokollgruppe, die du anzeigen möchtest.

  5. Wähle auf der Registerkarte Protokollstreams einen bestimmten Protokollstream, um die SMS-Zustellungsprotokolle anzuzeigen.

  6. Um den Zustellungsstatus der SMS-Nachricht anzuzeigen, erweitere das Protokollereignis und überprüfe die Angabe providerResponse.

Anzeigen abgemeldeter Telefonnummern

Empfänger können den Empfang von SMS-Nachrichten von ihrem AWS-Konto auf ihren Telefonen kündigen. Weitere Informationen findest du unter Abmeldung vom Erhalt von SMS-Nachrichten.

Führe die folgenden Schritte aus:

  1. Öffne die Amazon-SNS-Konsole.
  2. Erweitern Sie im Navigationsbereich den Abschnitt Mobil und wählen Sie Textnachricht (SMS) aus.
  3. Um abgemeldete Telefonnummern anzuzeigen, navigieren Sie zum Abschnitt Gekündigte Telefonnummern.

Verwandte Informationen

Überwachen von Amazon-SNS-Themen mithilfe von CloudWatch

Einstellungen für SMS-Nachrichten in Amazon SNS einrichten

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