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

Lesedauer: 4 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

Hinweis: Als Alternative zu den folgenden Schritten in der Konsole können Sie mithilfe von AWS SDKs oder AWS Command Line Interface (AWS CLI) einen Nachrichtenzustellungsstatus konfigurieren. Wenn Sie beim Ausführen von Befehlen in AWS CLI Fehlermeldungen erhalten, finden Sie weitere Informationen unter Beheben von AWS CLI-Fehlern. Stellen Sie außerdem sicher, dass Sie die neueste Version von AWS CLI verwenden.

  1. Öffnen Sie die Amazon SNS-Konsole.

  2. Erweitern Sie im Navigationsbereich die Option Mobil und wählen Sie Textnachricht (SMS) aus.

  3. Wählen Sie im Abschnitt SMS-Einstellungen die Option Bearbeiten aus.

  4. Erweitern Sie die Option Protokollierung des Zustellungsstatus – optional.

  5. Geben Sie 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 öffnet sich.

    Hinweis: Wenn Sie bereits über eine IAM-Rolle mit den richtigen Berechtigungen verfügen, verwenden Sie diese Servicerolle, indem Sie stattdessen die Option Verwenden einer vorhandenen Servicerolle auswählen.

  7. Wählen Sie auf der Seite mit den Berechtigungsanforderungen in der IAM-Konsole die Option Erlauben aus.

  8. Kehren Sie zur Amazon-SNS-Konsole zurück und klicken Sie auf Änderungen speichern.

Dadurch wird eine IAM-Rolle für erfolgreiche und fehlgeschlagene Zustellungen mit den folgenden Richtlinien und Vertrauensbeziehungen 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

  1. Öffnen Sie die Amazon CloudWatch-Konsole.

  2. Wählen Sie im Navigationsbereich Protokolle und dann Protokollgruppen aus.

  3. Geben Sie DirectPublishToPhoneNumber in das Filter-Suchfeld ein, um nur SMS-Protokollgruppen für Amazon SNS zu finden.

    Hinweis: Je nach Mobilfunkanbieter des Zielanschlusses kann es bis zu 72 Stunden dauern, bis die Zustellungsprotokolle in der Amazon SNS-Konsole angezeigt werden.

    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ählen Sie die SNS-Protokollgruppe aus, die Sie anzeigen möchten.

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

  6. Um den Zustellungsstatus Ihrer SMS-Nachricht zu sehen, erweitern Sie das Protokollereignis und überprüfen Sie 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 finden Sie unter Abmeldung vom Erhalt von SMS-Nachrichten.

  1. Öffnen Sie 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 festlegen

Anzeigen Amazon CloudWatch-Metriken und -Protokolle für SMS-Lieferungen