Attribute der SNS mobilen Amazon-App - 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.

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.

Konfiguration von Nachrichtenzustellungsstatusattributen mit dem AWS Management Console

  1. Melden Sie sich bei der SNSAmazon-Konsole an.

  2. Wählen Sie im Navigationsbereich die Option Mobile (Mobil) und dann Push notifications (Push-Benachrichtigungen) aus.

  3. Wählen Sie im Bereich Plattformanwendungen die Anwendung aus, die die Endpunkte enthält, für die Sie CloudWatch Protokolle erhalten möchten.

  4. Wählen Sie Application Actions (Anwendungsaktionen) und anschließend Delivery status (Zustellungsstatus).

  5. Wählen Sie im Dialogfeld „Lieferstatus“ die Option IAMRollen erstellen aus.

    Sie werden dann zur IAM Konsole weitergeleitet.

  6. Wählen Sie Zulassen, um Amazon SNS Schreibzugriff auf die Nutzung von CloudWatch Logs in Ihrem Namen zu gewähren.

  7. 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.

  8. 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 SDKsSie bieten APIs in mehreren Sprachen die Verwendung von Nachrichtenzustellungsstatusattributen bei Amazon anSNS.

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: SuccessFeedbackRoleArnFailureFeedbackRoleArn 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 im Programmierhandbuch für lokale und ferngesteuerte Benachrichtigungen.
Firebase Cloud-Messaging () FCM Weitere Informationen finden Sie unter Downstream Message Error Response Codes in der Firebase Cloud Messaging Dokumentation.
Microsoft-Pushbenachrichtigungsdienst für Windows Phone (MPNS) Weitere Informationen finden Sie unter Push Notification Service Response Codes for Windows Phone 8 in der Windows 8 Development Dokumentation.
Windows-Pushbenachrichtigungsdienste (WNS) Weitere Informationen finden Sie unter "Response codes" in Push Notification Service Request and Response Headers (Windows Runtime Apps) in der Windows 8 Development-Dokumentation.