Amazon SNS メッセージ配信の再試行

Amazon SNS は、各配信プロトコルの配信ポリシーを定義します。配信ポリシーは、サーバー側のエラーが発生したとき (サブスクライブされたエンドポイントをホストするシステムが利用できなくなったとき) に Amazon SNS がメッセージの配信を再試行する方法を定義します。配信ポリシーが枯渇すると、Amazon SNS は配信の再試行を停止し、にデッドレターキューが添付されていない限り、メッセージを破棄します。詳細については、「Amazon SNS デッドレターキュー」を参照してください。

配信プロトコルとポリシー

¹Firehose プロトコルのスロットリングエラーの場合、Amazon SNS はカスタマーマネージドエンドポイントと同じ配信ポリシーを使用します。

配信ポリシーの段階

次の図は、配信ポリシーの段階を示しています。

各配信ポリシーは、4 つの段階で構成されます。

HTTP/S 配信ポリシーの作成

Amazon SNS が HTTP/S エンドポイントへのメッセージ配信を再試行する方法は、遅延なし、バックオフ前、バックオフ後、およびバックオフ後の 4 つのフェーズで、配信ポリシーを使用して定義できます。このポリシーでは、デフォルトの再試行設定を上書きし、HTTP サーバーの容量に合わせてカスタマイズできます。

HTTP/S 配信ポリシーは、トピックレベルまたはサブスクリプションレベルで JSON オブジェクトとして定義できます。

または、 AWS CloudFormation テンプレートで AWS::SNS::Subscription リソースを使用することもできます。

HTTP/S サーバーの容量に基づいて配信ポリシーをカスタマイズする必要があります。

リクエストポリシーで Content-Typeヘッダーを設定して、通知のメディアタイプを指定することもできます。デフォルトでは、Amazon SNS はコンテンツタイプが に設定されているすべての通知を HTTP/S エンドポイントに送信しますtext/plain; charset=UTF-8。ただし、リクエストポリシーの headerContentTypeフィールドを使用して、このデフォルトを上書きできます。

次の JSON オブジェクトは、4 つのフェーズで構成された再試行を含む配信ポリシーを定義します。

Amazon SNS は、メッセージを破棄する前に、合計 50 回メッセージの配信を試みます。すべての再試行後に配信できないメッセージを保持するには、配信不能メッセージをデッドレターキュー (DLQ) に移動するようにサブスクリプションを設定します。詳細については、「Amazon SNS デッドレターキュー」を参照してください。

{
    "healthyRetryPolicy": {
        "minDelayTarget": 1,
        "maxDelayTarget": 60,
        "numRetries": 50,
        "numNoDelayRetries": 3,
        "numMinDelayRetries": 2,
        "numMaxDelayRetries": 35,
        "backoffFunction": "exponential"
    },
    "throttlePolicy": {
        "maxReceivesPerSecond": 10
    },
    "requestPolicy": {
        "headerContentType": "application/json"
    }
}

配信ポリシーは、再試行ポリシー、スロットルポリシー、およびリクエストポリシーで構成されます。配信ポリシーには合計 9 つの属性があります。

Amazon SNS は、次の式を使用して、バックオフ段階での再試行回数を計算します。

numRetries - numNoDelayRetries - numMinDelayRetries - numMaxDelayRetries

バックオフフェーズ中の再試行の頻度は、次の 3 つのパラメータを使用して制御できます。

次の図は、さまざまな再試行バックオフ関数が、バックオフフェーズ中の再試行間の遅延にどのように影響するかを示しています。この例で使用される配信ポリシーには、合計再試行回数 10、最小遅延時間 5 秒、最大遅延時間 260 秒の設定が含まれます。