Object Replication: Generating a Failure Report

  • Published on Jul 22, 2025
  • 1 minute(s) read
Prev Next

You can generate a Replication Failure Report to verify the objects that failed replication. This report is a valuable tool for identifying and resolving issues with replication jobs.

  • The Generate Failed Report option (described in this article) is visible only when there are replication failures to report. If no failures have occurred, this option will not appear in the Actions menu.

  • The report helps you identify objects that failed to replicate in the last 30 days.

  • The report is in CSV format and is generated in the Root prefix of the source bucket.

Generating a Failure Report

You can generate a failure report by navigating to the replication job on the Object Replication tab under Settings for a bucket:

  1. On the Buckets list, click for the desired bucket. This is the source bucket where the replication is configured.

  2. Click Settings.

  3. Click the Object Replication tab to view all replicatioins

  4. In the list of replication jobs, locate the job for which you want a failure report.

  5. Click to access the Actions menu for the desired replication job.

  6. Select Generate Failure Report. This option is available only if there was a replication failure.

The system will generate a report listing all objects that failed to replicate for the selected job in the Root prefix of the source bucket. The report name format is:

replication-rule-failures-report-timestamp-(job name)

You can download the report for further analysis.

Reviewing the Replication Report

The generated failure report is a CSV file with the following information:

Column

Description

RuleID

The ID of the replication rule.

Source-Bucket

The name of the source bucket.

Dest-Bucket

The name of the destination bucket.

Replication-Mode

The replication mode (such as  REPLICATION_MODE_WCSM_BATCH, REPLICATION_MODE_LIVE).

Operation

The S3 operation that triggered replication (such as  S3_REPLICATE_EVENT_OBJECT_PUT).

Object-Key

The key (name) of the object that failed to replicate.

Object-Version

The version ID of the object.

Failure-Time

The timestamp (UTC) when the replication failure occurred.