翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Amazon SNS モバイルアプリの属性

Amazon Simple Notification Service (Amazon SNS) は、プッシュ通知メッセージの配信ステータスをログに記録するサポートを提供します。アプリケーション属性を設定すると、Amazon からモバイルエンドポイントに送信されるメッセージのログエントリが CloudWatch Logs SNS に送信されます。メッセージの配信ステータスを記録することは、以下のように運用をよりよく把握するのに役立ちます。

メッセージ配信ステータスのアプリケーション属性を設定するには、、 AWS ソフトウェア開発キット (SDKs） AWS Management Console、またはクエリ を使用できますAPI。

を使用したメッセージ配信ステータス属性の設定 AWS Management Console

Amazon SNS メッセージ配信ステータス CloudWatch ログの例

アプリケーションエンドポイントのメッセージ配信ステータス属性を設定すると、 CloudWatch ログが生成されます。JSON 形式のログの例を以下に示します。

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

プッシュ通知サービスのレスポンスコードの一覧は、「プラットフォームのレスポンスコード」を参照してください。

を使用したメッセージ配信ステータス属性の設定 AWS SDKs

は、Amazon APIsでメッセージ配信ステータス属性を使用するための複数の言語でAWS SDKs提供しますSNS。

次の Java の例は、 を使用してプッシュ通知メッセージのメッセージ配信ステータスのアプリケーション属性SetPlatformApplicationAttributesAPIを設定する方法を示しています。メッセージの配信ステータスには、SuccessFeedbackRoleArn、FailureFeedbackRoleArn、および SuccessFeedbackSampleRate の属性を使用できます。属性SuccessFeedbackRoleArnと FailureFeedbackRoleArn 属性は、ユーザーに代わって ログを使用するためのSNS書き込みアクセスを Amazon CloudWatch に付与するために使用されます。SuccessFeedbackSampleRate 属性は、正常な配信メッセージのサンプルレートの割合 (0〜100) を指定するためのものです。FailureFeedbackRoleArn 属性を設定すると、失敗したメッセージ配信はすべて CloudWatch ログを生成します。

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」を参照してください。

プラットフォームのレスポンスコード

以下は、プッシュ通知サービスのレスポンスコードへのリンクの一覧です。