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 SNS mobilen Amazon-App
Amazon Simple Notification Service (AmazonSNS) bietet Unterstützung bei der Protokollierung des Lieferstatus von Push-Benachrichtigungen. Nachdem Sie Anwendungsattribute konfiguriert haben, werden Protokolleinträge für Nachrichten, die von Amazon an mobile Endpunkte gesendet wurdenSNS, an CloudWatch Logs gesendet. Die Protokollierung des Zustellungsstatus von Nachrichten verhilft Ihnen zu besseren betrieblichen Einblicken, wie beispielsweise den Folgenden:
-
Erfahren Sie, ob eine Push-Benachrichtigung von Amazon SNS an den Push-Benachrichtigungsdienst zugestellt wurde.
-
Identifizieren Sie die Antwort, die vom Push-Benachrichtigungsdienst an Amazon gesendet wurdeSNS.
-
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 query verwendenAPI.
Themen
Konfiguration von Nachrichtenzustellungsstatusattributen mit dem AWS Management Console
-
Melden Sie sich bei der SNSAmazon-Konsole
an. -
Wählen Sie im Navigationsbereich die Option Mobile (Mobil) und dann Push notifications (Push-Benachrichtigungen) aus.
-
Wählen Sie im Bereich Plattformanwendungen die Anwendung aus, die die Endpunkte 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 „Lieferstatus“ die Option IAMRollen erstellen aus.
Sie werden dann zur IAM Konsole weitergeleitet.
-
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 CloudWatch Logs erhalten 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 CloudWatch Statusprotokolle der SNS Amazon-Nachrichtenzustellung
Nachdem Sie die Attribute für den Nachrichtenzustellungsstatus für einen Anwendungsendpunkt konfiguriert haben, werden CloudWatch Protokolle generiert. Beispielprotokolle werden im folgenden JSON Format angezeigt:
SUCCESS
{ "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" } }
FAILURE
{ "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 die SetPlatformApplicationAttributes
API zur Konfiguration von Anwendungsattributen für den Nachrichtenzustellungsstatus von Push-Benachrichtigungen verwendet werden. 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 Logs 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 den 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-Gerätenachrichten (ADM) | Weitere Informationen finden Sie in der ADM Dokumentation zum Antwortformat |
Apple-Push-Benachrichtigungsdienst (APNs) | Weitere Informationen finden Sie unter HTTP/2 Response from APNs in Kommunizieren mit APNs |
Firebase Cloud-Messaging () FCM | Weitere Informationen finden Sie unter Downstream Message Error Response Codes |
Microsoft-Pushbenachrichtigungsdienst für Windows Phone (MPNS) | Weitere Informationen finden Sie unter Push Notification Service Response Codes for Windows Phone 8 |
Windows-Pushbenachrichtigungsdienste (WNS) | Weitere Informationen finden Sie unter "Response codes" in Push Notification Service Request and Response Headers (Windows Runtime Apps) |