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.
Attribute der mobilen Amazon SNS SNS-App
Amazon Simple Notification Service (Amazon SNS) unterstützt die Protokollierung des Zustellungsstatus von Push-Benachrichtigungen. Nachdem Sie Anwendungsattribute konfiguriert haben, werden Protokolleinträge für Nachrichten, die von Amazon SNS an mobile Endpunkte gesendet wurden, an CloudWatch Logs gesendet. Die Protokollierung des Zustellungsstatus von Nachrichten verhilft Ihnen zu besseren betrieblichen Einblicken, wie beispielsweise den Folgenden:
-
Sie erfahren, ob eine Push-Benachrichtigungsmitteilung von Amazon SNS an den Push-Benachrichtigungsservice zugestellt wurde.
-
Identifizieren Sie die Antwort, die vom Push-Benachrichtigungsservice an den Amazon SNS gesendet wurde.
-
Ermitteln Sie die dwell-Zeit der Nachricht (das Zeitfenster zwischen dem Zeitstempel der Veröffentlichung bis direkt vor der Übergabe an einen Push-Benachrichtigungsservice).
Um Anwendungsattribute für den Nachrichtenzustellungsstatus zu konfigurieren, können Sie die AWS Management Console AWS Software Development Kits (SDKs) oder die Abfrage-API verwenden.
Konfiguration von Nachrichtenzustellungsstatusattributen mit dem AWS Management Console
-
Melden Sie sich bei der Amazon-SNS-Konsole
an. -
Wählen Sie im Navigationsbereich die Option Mobile (Mobil) und dann Push notifications (Push-Benachrichtigungen) aus.
-
Wählen Sie im Abschnitt Plattformanwendungen die Anwendung aus, die die Endpoints enthält, für die Sie CloudWatch Protokolle erhalten möchten.
-
Wählen Sie Application Actions (Anwendungsaktionen) und anschließend Delivery status (Zustellungsstatus).
-
Wählen Sie im Dialogfeld Delivery Status (Zustellungsstatus)die Option Create IAM Roles (IAM-Rollen erstellen).
Sie werden anschließend zur IAM-Konsole umgeleitet.
-
Wählen Sie Zulassen, um Amazon SNS Schreibzugriff auf die Nutzung von CloudWatch Logs in Ihrem Namen zu gewähren.
-
Kehren Sie nun zum Dialogfeld „Lieferstatus“ zurück und geben Sie im Feld Erfolgsquote bis zur Stichprobe (0-100) eine Zahl für den Prozentsatz der erfolgreich gesendeten Nachrichten ein, für die Sie Logs erhalten CloudWatch möchten.
Anmerkung
Nachdem Sie die Anwendungsattribute für den Nachrichtenzustellungsstatus konfiguriert haben, werden für alle fehlgeschlagenen Nachrichtenzustellungen CloudWatch Protokolle generiert.
-
Wählen Sie anschließend Save Configuration (Konfiguration speichern). Sie können jetzt die CloudWatch Protokolle mit dem Status der Nachrichtenzustellung anzeigen und analysieren. Weitere Informationen zur Verwendung CloudWatch finden Sie in der CloudWatchDokumentation
.
Beispiele für das CloudWatch Protokoll zum Status der Nachrichtenzustellung in Amazon SNS
Nachdem Sie die Attribute für den Nachrichtenzustellungsstatus für einen Anwendungsendpunkt konfiguriert haben, werden CloudWatch Protokolle generiert. Beispielprotokolle im JSON-Format werden wie folgt angezeigt:
ERFOLG
{ "status": "SUCCESS", "notification": { "timestamp": "2015-01-26 23:07:39.54", "messageId": "9655abe4-6ed6-5734-89f7-e6a6a42de02a" }, "delivery": { "statusCode": 200, "dwellTimeMs": 65, "token": "Examplei7fFachkJ1xjlqT64RaBkcGHochmf1VQAr9k-IBJtKjp7fedYPzEwT_Pq3Tu0lroqro1cwWJUvgkcPPYcaXCpPWmG3Bqn-wiqIEzp5zZ7y_jsM0PKPxKhddCzx6paEsyay9Zn3D4wNUJb8m6HXrBf9dqaEw", "attempts": 1, "providerResponse": "{\"multicast_id\":5138139752481671853,\"success\":1,\"failure\":0,\"canonical_ids\":0,\"results\":[{\"message_id\":\"0:1422313659698010%d6ba8edff9fd7ecd\"}]}", "destination": "arn:aws:sns:us-east-2:111122223333:endpoint/FCM/FCMPushApp/c23e42de-3699-3639-84dd-65f84474629d" } }
FEHLER
{ "status": "FAILURE", "notification": { "timestamp": "2015-01-26 23:29:35.678", "messageId": "c3ad79b0-8996-550a-8bfa-24f05989898f" }, "delivery": { "statusCode": 8, "dwellTimeMs": 1451, "token": "examp1e29z6j5c4df46f80189c4c83fjcgf7f6257e98542d2jt3395kj73", "attempts": 1, "providerResponse": "NotificationErrorResponse(command=8, status=InvalidToken, id=1, cause=null)", "destination": "arn:aws:sns:us-east-2:111122223333:endpoint/APNS_SANDBOX/APNSPushApp/986cb8a1-4f6b-34b1-9a1b-d9e9cb553944" } }
Eine Liste der Antwortcodes für den Push-Benachrichtigungsservice finden Sie unter Antwortcodes der Plattformen.
Konfiguration von Statusattributen für die Nachrichtenzustellung mit dem AWS SDKs
AWS SDKs
Das folgende Java-Beispiel zeigt, wie Sie mit der SetPlatformApplicationAttributes
-API Anwendungsattribute für den Status von Nachrichtenübermittlungen von Push-Benachrichtigungsmitteilungen konfigurieren. Sie können die folgenden Attribute für den Status von Nachrichtenübermittlungen verwenden: SuccessFeedbackRoleArn
FailureFeedbackRoleArn
und SuccessFeedbackSampleRate
. Die FailureFeedbackRoleArn
Attribute SuccessFeedbackRoleArn
und werden verwendet, um Amazon SNS Schreibzugriff auf die Nutzung von CloudWatch Logs in Ihrem Namen zu gewähren. Das Attribut SuccessFeedbackSampleRate
dient zum Festlegen des Prozentsatzes der Samplerate (0-100) der erfolgreich zugestellten Nachrichten. Nachdem Sie das FailureFeedbackRoleArn
Attribut konfiguriert haben, werden bei allen fehlgeschlagenen Nachrichtenzustellungen CloudWatch Protokolle generiert.
SetPlatformApplicationAttributesRequest setPlatformApplicationAttributesRequest = new SetPlatformApplicationAttributesRequest(); Map<String, String> attributes = new HashMap<>(); attributes.put("SuccessFeedbackRoleArn", "arn:aws:iam::111122223333:role/SNS_CWlogs"); attributes.put("FailureFeedbackRoleArn", "arn:aws:iam::111122223333:role/SNS_CWlogs"); attributes.put("SuccessFeedbackSampleRate", "5"); setPlatformApplicationAttributesRequest.withAttributes(attributes); setPlatformApplicationAttributesRequest.setPlatformApplicationArn("arn:aws:sns:us-west-2:111122223333:app/FCM/FCMPushApp"); sns.setPlatformApplicationAttributes(setPlatformApplicationAttributesRequest);
Weitere Informationen zu SDK für Java finden Sie unter Erste Schritte mit dem AWS SDK for Java.
Antwortcodes der Plattformen
Die folgende Liste enthält Links für die Antwortcodes des Push-Benachrichtigungsservice:
Push-Benachrichtigungsservice | Antwortcodes |
---|---|
Amazon Device Messaging (ADM) | Weitere Informationen finden Sie unter Antwortformat |
Apple-Push-Benachrichtigungsdienst () APNs | Weitere Informationen finden Sie unter HTTP/2-Antwort von APNs in Kommunizieren mit APNs |
Firebase Cloud Messaging (FCM) | Weitere Informationen finden Sie unter Downstream Message Error Response Codes |
Microsoft Push Notification Service für Windows Phone (MPNS) | Weitere Informationen finden Sie unter Push Notification Service Response Codes for Windows Phone 8 |
Windows Push Notification Services (WNS) | Weitere Informationen finden Sie unter "Response codes" in Push Notification Service Request and Response Headers (Windows Runtime Apps) |