AWS SDKs を使用した配信ステータスのログ記録の設定 - Amazon Simple Notification Service
トピック属性

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

AWS SDKs を使用した配信ステータスのログ記録の設定

AWS SDKs は、メッセージ配信ステータスのログ記録のトピック属性を設定するための APIs を複数の言語で提供します。たとえば、SetTopicAttributes API を使用して以下を設定します。

  • LambdaSuccessFeedbackRoleArn – Lambda エンドポイントへのメッセージ配信を成功させるための IAM ロール。

  • LambdaSuccessFeedbackSampleRate – Lambda エンドポイントへの成功メッセージのサンプリングレート。

  • LambdaFailureFeedbackRoleArn – Lambda エンドポイントへの失敗したメッセージ配信の IAM ロール。

AWS CLI コマンドの例

aws sns set-topic-attributes \
    --topic-arn arn:aws:sns:us-west-2:123456789012:MyTopic \
    --attribute-name LambdaSuccessFeedbackRoleArn \
    --attribute-value arn:aws:iam::123456789012:role/MyFeedbackRole

トピック属性

メッセージ配信ステータスには、次のトピック属性名の値を使用します。

HTTP

  • HTTPSuccessFeedbackRoleArn – HTTP エンドポイントにサブスクライブされている Amazon SNS トピックのメッセージ配信ステータスの成功。

  • HTTPSuccessFeedbackSampleRate – HTTP エンドポイントにサブスクライブされている Amazon SNS トピックのサンプリングに成功したメッセージの割合。

  • HTTPFailureFeedbackRoleArn – HTTP エンドポイントにサブスクライブされている Amazon SNS トピックのメッセージ配信ステータスが失敗しました。

Amazon Data Firehose

  • FirehoseSuccessFeedbackRoleArn – Amazon Data Firehose エンドポイントにサブスクライブされている Amazon SNS トピックのメッセージ配信ステータスの成功。

  • FirehoseSuccessFeedbackSampleRate – Amazon Data Firehose エンドポイントにサブスクライブされている Amazon SNS トピックのサンプリングに成功したメッセージの割合。

  • FirehoseFailureFeedbackRoleArn – Amazon Data Firehose エンドポイントにサブスクライブされている Amazon SNS トピックのメッセージ配信ステータスが失敗しました。

AWS Lambda

  • LambdaSuccessFeedbackRoleArn – Lambda エンドポイントにサブスクライブされている Amazon SNS トピックのメッセージ配信ステータスの成功。

  • LambdaSuccessFeedbackSampleRate – Lambda エンドポイントにサブスクライブされている Amazon SNS トピックのサンプリングに成功したメッセージの割合。

  • LambdaFailureFeedbackRoleArn – Lambda エンドポイントにサブスクライブされている Amazon SNS トピックのメッセージ配信ステータスが失敗しました。

プラットフォームアプリケーションエンドポイント

  • ApplicationSuccessFeedbackRoleArn – AWS アプリケーションエンドポイントにサブスクライブされている Amazon SNS トピックのメッセージ配信ステータスの成功。

  • ApplicationSuccessFeedbackSampleRate – AWS アプリケーションエンドポイントにサブスクライブされている Amazon SNS トピックのサンプリングに成功したメッセージの割合。

  • ApplicationFailureFeedbackRoleArn – AWS アプリケーションエンドポイントにサブスクライブされている Amazon SNS トピックのメッセージ配信ステータスが失敗しました。

    注記

    さらに、配信ステータスを直接プッシュ通知サービスに記録するようにアプリケーション属性を設定できます。詳細については、「メッセージの配信ステータスの Amazon SNS アプリケーション属性を使用する」を参照してください。

Amazon SQS

  • SQSSuccessFeedbackRoleArn – Amazon SQS エンドポイントにサブスクライブされている Amazon SNS Amazon SQS トピックのメッセージ配信ステータスの成功。

  • SQSSuccessFeedbackSampleRate – Amazon SQS エンドポイントにサブスクライブされている Amazon SNS Amazon SQS トピックに対してサンプリングする正常なメッセージの割合。

  • SQSFailureFeedbackRoleArn – Amazon SQS エンドポイントにサブスクライブされている Amazon SNS Amazon SQS トピックのメッセージ配信ステータスが失敗しました。

プラットフォームアプリケーションエンドポイントのログは、他のエンドポイントと同じ CloudWatch Logs グループに書き込まれます。

注記

<ENDPOINT>SuccessFeedbackRoleArn および <ENDPOINT>FailureFeedbackRoleArn 属性は、お客様に代わって CloudWatch Logs を使用する書き込みアクセス許可を Amazon SNS に付与するために使用します。<ENDPOINT>SuccessFeedbackSampleRate 属性は、正常な配信メッセージのサンプルレートの割合 (0〜100) を指定するためのものです。<ENDPOINT>FailureFeedbackRoleArn 属性を設定した後は、メッセージの配信に失敗すると、必ず CloudWatch Logs が生成されます。