모바일 앱 속성

Amazon Simple Notification Service(Amazon SNS)는 푸시 알림 메시지 전송 상태를 로그하기 위한 지원을 제공합니다. 애플리케이션 속성을 구성하면 Amazon SNS에서 모바일 엔드포인트로 전송된 메시지에 대한 로그 항목이 CloudWatch Logs로 전송됩니다. 메시지 전송 상태를 로깅하면 다음과 같이 더욱 확장된 운영 이해를 제공할 수 있습니다.

• 푸시 알림 메시지가 Amazon SNS로부터 푸시 알림 서비스로 전송되었는지 확인합니다.

• 푸시 알림 서비스로부터 Amazon SNS로 전송되는 응답을 식별합니다.

• 메시지 유지 시간(게시 타임스탬프 시간부터 푸시 알림 서비스에 넘겨주기 직전까지의 시간)을 결정합니다.

메시지 전송 상태에 대한 애플리케이션 속성을 구성하려면 AWS Management Console, AWS 소프트웨어 개발 키트(SDK) 또는 쿼리 API를 사용하면 됩니다.

AWS Management Console을 사용한 메시지 전송 상태 속성 구성

1. Amazon SNS 콘솔에 로그인합니다.

2. 탐색 창에서 모바일을 가리킨 다음 푸시 알림을 선택합니다.

3. 플랫폼 애플리케이션 섹션에서 CloudWatch Logs를 수신하려는 엔드포인트가 포함된 애플리케이션을 선택합니다.

4. Application Actions(애플리케이션 작업)를 선택한 다음 Delivery Status(전송 상태)를 선택합니다.

5. Delivery Status(전송 상태) 대화 상자에서 Create IAM Roles(IAM 역할 생성)를 선택합니다.

   이제 IAM 콘솔로 리디렉션됩니다.

6. Amazon SNS에 사용자 대신 CloudWatch Logs를 사용할 수 있는 쓰기 액세스 권한을 부여하려면 허용을 선택합니다.

7. 이제 전송 상태 대화 상자로 돌아가 CloudWatch Logs를 수신하려는 성공적인 메시지의 백분율을 샘플 성공 백분율(0-100) 필드에 입력합니다.

   참고

   메시지 전송 상태를 위해 애플리케이션 속성을 구성하고 나면 메시지의 전송 실패가 CloudWatch Logs를 생성합니다.

8. 마지막으로, Save Configuration(구성 저장)을 선택합니다. 이제 CloudWatch Logs가 포함된 메시지 전송 상태를 보고 파싱할 수 있습니다. CloudWatch 사용에 대한 자세한 정보는 CloudWatch 설명서를 참조하세요.

Amazon SNS 메시지 전송 상태 CloudWatch 로그 예제

애플리케이션 엔드포인트를 위해 메시지 전송 상태 속성을 구성하고 나면 CloudWatch Logs가 생성됩니다. JSON 형식의 예제 로그는 다음과 같이 나타납니다.

성공

{
  "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"
  }
}

실패

{
  "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"
  }
}

푸시 알림 서비스 응답 코드를 확인하려면 플랫폼 응답 코드에서 확인하세요.

AWS SDK를 사용한 메시지 전송 상태 속성 구성

AWS SDK는 Amazon SNS에서 메시지 전송 상태 속성을 사용하기 위해 여러 언어로 API를 제공합니다.

다음 Java 예제에서는 SetPlatformApplicationAttributes API를 이용해 푸시 알림 메시지 전송 상태를 위한 애플리케이션 속성을 구성하는 방법을 보여줍니다. 메시지 전송 상태를 위해 SuccessFeedbackRoleArn, FailureFeedbackRoleArn, SuccessFeedbackSampleRate 속성을 사용할 수 있습니다. SuccessFeedbackRoleArn 및 FailureFeedbackRoleArn 속성은 사용자 대신 CloudWatch Logs를 사용할 수 있는 쓰기 액세스 권한을 Amazon SNS에 부여하는 데 사용됩니다. SuccessFeedbackSampleRate 속성은 성공적으로 전송된 메시지의 샘플 비율(0-100)을 지정할 때 사용됩니다. FailureFeedbackRoleArn 속성을 구성하고 나면, 메시지의 전송 실패가 CloudWatch Logs를 생성합니다.

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);

SDK for Java에 대한 자세한 정보는 AWS SDK for Java 시작하기를 참조하세요.

플랫폼 응답 코드

다음은 푸시 알림 서비스 응답 코드를 위한 링크 목록입니다.

푸시 알림 서비스	응답 코드
Amazon Device Messaging(ADM)	ADM 설명서의 응답 형식을 참조하세요.
Apple 푸시 알림 서비스(APN)	로컬 및 원격 알림 프로그래밍 가이드의 APN과 통신에서 APN의 HTTP/2 응답을 참조하세요.
Firebase Cloud Messaging(FCM)	Firebase Cloud Messaging 설명서의 Downstream Message Error Response Codes를 참조하세요.
Windows Phone용 Microsoft 푸시 알림 서비스(MPNS)	Windows 8 개발 설명서의 Push Notification Service Response Codes for Windows Phone 8을 참조하세요.
Windows 푸시 알림 서비스(WNS)	Windows 8 개발 설명서의 Push Notification Service Request and Response Headers(Windows Runtime Apps)에서 "응답 코드"를 참조하세요.