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

# Amazon EventBridge でのイベントのアーカイブと再生
<a name="eb-archive"></a>

EventBridge では、後で手軽に*再生*したり、最初に受信したイベントバスに再送信したりするために、イベントのアーカイブを作成することができます。例えば、イベントを再生して、エラーから回復したり、アプリケーションの新機能を検証したりする場合があります。

## イベントのアーカイブ
<a name="eb-archive-archive"></a>

アーカイブを作成するときには、以下を指定できます。
+ アーカイブに送信するイベント。

  EventBridge がアーカイブに送信するイベントのフィルタリングに使用するイベントパターンを指定できます。
+ アーカイブにイベントを保持する期間。

  アーカイブにイベントを保持する日数を指定できます。デフォルトでは、EventBridge はイベントをアーカイブに無期限で保存します。

各アーカイブは、単一の*ソース*イベントバスからイベントを受け取ります。アーカイブが作成されると、ソースイベントバスを変更することはできなくなります。特定のイベントバスに対して複数のアーカイブを作成できます。

![イベントはイベントパターンでフィルタリングされ、アーカイブに送信されます。再生はアーカイブから実行できます。](http://docs.aws.amazon.com/ja_jp/eventbridge/latest/userguide/images/archive_eventbridge_conceptual.svg)


EventBridge の料金はアーカイブに適用されます。詳細については、「[Amazon EventBridge の料金](https://aws.amazon.com/eventbridge/pricing/)」を参照してください。

### アーカイブイベントの暗号化
<a name="eb-archive-encryption"></a>

EventBridge はデフォルトで、アーカイブ内のイベントデータを、[AWS 所有の CMK](https://docs.aws.amazon.com//kms/latest/developerguide/concepts.html#aws-owned-cmk) の下で 256 ビット高度暗号化規格 (AES-256) を用いて暗号化しており、不正なアクセスからデータを保護します。

### イベント配信
<a name="eb-archive-timing"></a>

EventBridge がアーカイブにイベントを配信する方法については、次の考慮事項に注意してください。
+ イベントがイベントバスに受信されてからアーカイブに到着するまでの間に遅延が生じる場合があります。すべてのイベントが確実に再生されるよう、アーカイブしたイベントの再生を 10 分間遅らせることをお勧めします。
+ [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_DescribeArchive.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_DescribeArchive.html) オペレーションの `EventCount` および `SizeBytes` 値の調整時間は 24 時間です。そのため、最近期限切れになったイベントは、これらの値に反映されていない場合があります。

### 再生されたイベントがアーカイブに配信されないようにする
<a name="eb-archive-managed-rule"></a>

アーカイブを作成すると、EventBridge はソースイベントバスに[マネージドルール](eb-rules.md#eb-rules-managed)を生成し、再生されたイベントがアーカイブに送信されないようにします。マネージドルールは、次のイベントパターンを追加します。このパターンは、`replay-name` フィールドが含まれているかどうかに基づいてイベントをフィルタリングします。(EventBridge は、再生時にこのフィールドをイベントに追加します)。

```
{
  "replay-name": [{
    "exists": false
  }]
}
```

## アーカイブからのイベントの再生
<a name="eb-archive-replay"></a>

アーカイブを作成すると、アーカイブからイベントを再生することができます。例えば、アプリケーションを追加機能で更新する場合、履歴イベントを再生して、イベントの再処理がアプリケーションの一貫性を維持するようにすることができます。アーカイブを利用して、新しい機能に対するイベントを再生することもできます。

アーカイブからイベントを再生するときは、以下を指定します。
+ 再生するイベントを選択する時間枠。
+ 選択したイベントを EventBridge で再生する際のイベントバスの特定のルール (必要な場合)。

アーカイブイベントは、ソースイベントバスに対してのみ再生できます。

 AWS リージョンごとに、アカウントごとに最大 10 個のアクティブな同時再生を持つことができます。

イベントは、再生してもアーカイブから削除されません。複数の再生でイベントを再生できます。EventBridge は、アーカイブの保持期間を超えたイベント、またはアーカイブ自体を削除したイベントのみを削除します。

EventBridge は 90 日後に再生を削除します。

再生は、ステータスが `Starting` または `Running` のときにキャンセルできます。詳細については、「[イベントの再生のキャンセル](eb-replay-cancel.md)」を参照してください。

### 再生されたイベントの特定
<a name="eb-archive-replay-event-transform"></a>

EventBridge は、再生中にアーカイブからソースイベントバスにイベントを送信すると、再生の名前 `replay-name` を含むメタデータフィールドをイベントに追加します。このフィールドを使用すると、ターゲットへの配信時に、再生されたイベントを識別できます。

EventBridge は、このフィールドを使用して、再生されたイベントがアーカイブに送信されないようにします。

### アーカイブからイベントを再生する際の考慮事項
<a name="eb-archive-replay-considerations"></a>

アーカイブからイベントを再生するときは、次の考慮事項に注意してください。
+ イベントがイベントバスに受信されてからアーカイブに到着するまでの間に遅延が生じる場合があります。すべてのイベントが確実に再生されるよう、アーカイブしたイベントの再生を 10 分間遅らせることをお勧めします。
+ イベントは、必ずしもアーカイブに追加された順序通りに再生されるわけではありません。再生では、イベント内の時間に基づいて再生するイベントを処理し、1 分間隔で再生します。イベントの開始時刻と終了時刻を 20 分単位で指定すると、イベントは、その 20 分単位の最初の 1 分目から再生されます。その後、2 分目以降のイベントが再生されます。
+ EventBridge API の `DescribeReplay` 操作を使用して、再生の進行状況を確認することができます。`EventLastReplayedTime` は、最後に再生されたイベントのタイムスタンプを返します。
+ イベントは、 AWS アカウントの 1 秒あたりの`PutEvents`トランザクション数の制限に基づいて再生されますが、それとは別に再生されます。PutEvents の制限の引き上げをリクエストすることができます。詳細については、[Amazon EventBridge クォータ](https://docs.aws.amazon.com/eventbridge/latest/userguide/cloudwatch-limits-eventbridge.html)を参照してください。

 次の動画では、アーカイブと再生の使用方法を示します。