# S3 Replication on Outposts に EventBridge を使用する
<a name="outposts-replication-eventbridge"></a>

Amazon S3 on Outposts は、Amazon EventBridge と統合されており、`s3-outposts` ネームスペースを使用します。EventBridge は、アプリケーションをさまざまなソースからのデータに接続するために使用できるサーバーレスのイベントバスサービスです。詳細については、「*Amazon EventBridge ユーザーガイド*」の「[Amazon EventBridge とは](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html)」を参照してください。

レプリケーション設定の問題のトラブルシューティングを支援するために、Amazon EventBridge を設定して、レプリケーションの失敗イベントに関する通知を受け取ることもできます。EventBridge は、オブジェクトがデスティネーション Outposts にレプリケートされない場合に通知できます。レプリケートされるオブジェクトの現在の状態の詳細については、「[レプリケーションステータスの概要](manage-outposts-replication.md#outposts-replication-status-overview)」を参照してください。

Outposts バケット内で特定のイベントが発生するたびに S3 on Outposts は EventBridge にイベントを送信できます。他の宛先とは異なり、配信するイベントタイプを選択する必要はありません。また、EventBridge ルールを使用すると、イベントを追加のターゲットにルートできます。EventBridge を有効にすると、S3 on Outposts は次のすべてのイベントを EventBridge に送信します。


| イベントタイプ | 説明  | 名前空間 | 
| --- | --- | --- | 
| `OperationFailedReplication` | レプリケーションルール内のオブジェクトのレプリケーションが失敗しました。S3 Replication on Outposts の詳細については、「[EventBridge を使用して S3 Replication on Outposts の障害理由を表示する](#outposts-replication-failure-codes)」を参照してください。 | `s3-outposts` | 

## EventBridge を使用して S3 Replication on Outposts の障害理由を表示する
<a name="outposts-replication-failure-codes"></a>

次の表は、Outposts の S3 レプリケーションが失敗した理由を示しています。EventBridge ルールを設定して、Amazon Simple Queue Service (Amazon SQS)、Amazon Simple Notification Service (Amazon SNS)、AWS Lambda、または Amazon CloudWatch Logs を介して失敗の理由を公開して表示できます。EventBridge でこれらのリソースを使用するために必要なアクセス許可の詳細については、「[EventBridge のリソースベースのポリシーを使用する](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-use-resource-based.html)」を参照してください。


| レプリケーションの失敗の理由 | 説明 | 
| --- | --- | 
| AssumeRoleNotPermitted | S3 on Outposts は、レプリケーション設定で指定されている AWS Identity and Access Management (IAM) ロールを引き継ぐことはできません。 | 
| DstBucketNotFound | S3 on Outposts は、レプリケーション設定で指定されたレプリケート先バケットを見つけることができません。 | 
| DstBucketUnversioned | Outposts レプリケート先バケットでバージョニングが有効になっていません。S3 Replication on Outposts でオブジェクトをレプリケートするには、レプリケート先バケットのバージョニングを有効にします。 | 
| DstDelObjNotPermitted | S3 on Outposts は、レプリケート先バケットに削除をレプリケートできません。レプリケート先バケットに対する s3-outposts:ReplicateDelete 権限がない可能性があります。 | 
| DstMultipartCompleteNotPermitted | S3 on Outposts は、レプリケート先バケットでオブジェクトのマルチパートアップロードを完了できません。レプリケート先バケットに対する s3-outposts:ReplicateObject 権限がない可能性があります。 | 
| DstMultipartInitNotPermitted | S3 on Outposts は、レプリケート先バケットへのオブジェクトのマルチパートアップロードを開始できません。レプリケート先バケットに対する s3-outposts:ReplicateObject 権限がない可能性があります。 | 
| DstMultipartPartUploadNotPermitted | S3 on Outposts は、レプリケート先バケットにマルチパートアップロードオブジェクトをアップロードできません。レプリケート先バケットに対する s3-outposts:ReplicateObject 権限がない可能性があります。 | 
| DstOutOfCapacity | Outpost に S3 ストレージ容量が不足しているため、S3 on Outposts は、デスティネーションアウトポストにレプリケートできません。 | 
| DstPutObjNotPermitted | S3 on Outposts は、レプリケート先バケットにオブジェクトをレプリケートできません。レプリケート先バケットに対する s3-outposts:ReplicateObject 権限がない可能性があります。 | 
| DstPutTaggingNotPermitted | S3 on Outposts は、レプリケート先バケットにオブジェクトタグをレプリケートできません。レプリケート先バケットに対する s3-outposts:ReplicateObject 権限がない可能性があります。 | 
| DstVersionNotFound | S3 on Outposts は、そのオブジェクトバージョンのメタデータをレプリケートするためにレプリケート先バケットで必要なオブジェクトバージョンを見つけることができません。 | 
| SrcBucketReplicationConfigMissing | S3 on Outposts は、ソースの Outposts バケットに関連付けられているアクセスポイントのレプリケーション設定を見つけることができません。 | 
| SrcGetObjNotPermitted | S3 on Outposts は、レプリケーションのレプリケート元バケットにあるオブジェクトにアクセスできません。レプリケート元バケットに対する s3-outposts:GetObjectVersionForReplication 権限がない可能性があります。 | 
| SrcGetTaggingNotPermitted | S3 on Outposts は、レプリケート元バケットからオブジェクトタグ情報にアクセスできません。レプリケート元バケットに対する s3-outposts:GetObjectVersionTagging 権限がない可能性があります。 | 
| SrcHeadObjectNotPermitted | S3 on Outposts は、レプリケート元バケットからオブジェクトメタデータを取得できません。レプリケート元バケットに対する s3-outposts:GetObjectVersionForReplication 権限がない可能性があります。 | 
| SrcObjectNotEligible | このオブジェクトはレプリケーションの対象外です。オブジェクトまたはそのオブジェクトタグがレプリケーション設定と一致しません。 | 

レプリケーションのトラブルシューティングの詳細については、以下のトピックを参照してください。
+ [IAM ロールの作成](outposts-replication-prerequisites-config.md#outposts-rep-pretwo)
+ [レプリケーションのトラブルシューティング](manage-outposts-replication.md#outposts-replication-troubleshoot)

## CloudWatch での EventBridge のモニタリング
<a name="outposts-replication-eventbridge-cw"></a>

モニタリングには、Amazon EventBridge が Amazon CloudWatch と統合します。EventBridge は自動的に CloudWatch に毎分メトリクスを送信します。これらのメトリクスには、[ルール](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html)に一致した[イベント](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html)の数と、ルールによって[ターゲット](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-targets.html)が呼び出された回数が含まれます。Eventbridge でルールが実行されると、このルールに関連付けられているすべてのターゲットが呼び出されます。EventBridge の動作は、CloudWatch を通じて次の方法でモニタリングできます。
+ EventBridge ルールで利用可能な [EventBridge メトリクス](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-monitoring.html#eb-metrics)は、CloudWatch ダッシュボードからモニタリングできます。次に、CloudWatch アラームなどの CloudWatch 機能を使用して、特定のメトリクスにアラームを設定できます。これらのメトリクスがアラームで指定したカスタムしきい値に達すると、通知が届き、それに応じてアクションを実行できます。
+ Amazon CloudWatch Logs を EventBridge ルールのターゲットとして設定できます。次に、EventBridge がログストリームを作成し、CloudWatch Logs がログエントリとしてイベントからテキストを保存します。詳細については、「[EventBridge の CloudWatch Logs のアクセス許可](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-use-resource-based.html#eb-cloudwatchlogs-permissions)」を参照してください。

EventBridge イベント配信のデバッグとイベントのアーカイブの詳細については、次のトピックを参照してください。
+ [イベントの再試行ポリシーとデッドレターキューの使用](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rule-dlq.html)
+ [EventBridge イベントのアーカイブ](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-archive-event.html)