Skip to content

Sync Logs (Run History)

Sync Logs (run history) is the operational record of every individual synchronization operation the pipeline has processed. Each row represents one entity record moving through the pipeline — its source ID, the instance that processed it, the operation performed, the final status, and any error message. Use Sync Logs to confirm that specific records reached the target system, count failures for a given entity type, or isolate the exact error message that caused a record to fail.

Sync Logs list showing rows with mixed statuses

In the left navigation, under Operations, select Sync Logs.

At the top of the page, five stat cards give an at-a-glance view of the records currently loaded:

CardDescription
Total OperationsCount of all rows matching the current filters
SuccessRecords that completed without error
Partial SuccessRecords where the main write succeeded but one or more sub-steps (such as image sync or metafield sync) reported a partial result
FailedRecords that could not be delivered to the target system
Success RatePercentage of successful operations out of the total

Each row carries one of the following status badges:

StatusColorMeaning
SuccessGreenThe record was written to the target system without error.
CompletedGreenAlternate success state used by some pipeline stages.
Partial SuccessAmberThe core write succeeded but at least one dependent sub-step (image, metafield, inventory) reported a partial result.
Partially FailedAmberA subset of sub-steps failed; the main record may still exist in the target system.
In ProgressBlueThe pipeline is actively processing this record.
ExtractingBlueThe source extractor is fetching data for this record.
FailedRedThe record could not be written and no further retries will be attempted automatically. Check the Details column for the error message.
Extraction FailedRedThe source extractor could not retrieve the record data.
ColumnDescription
StatusStatus badge for this record (see table above).
InstanceName of the integration job (instance) that processed this record.
Entity TypeThe type of entity — for example, item, bp, or order.
Source IDThe identifier of the record in the source system.
Target IDThe identifier assigned in the target system after a successful write. Blank if the write failed.
OperationWhether the pipeline created, updated, or deleted the record in the target system.
StartedDate and time when this record entered the pipeline.
DetailsError message, if any. Hover over a truncated message to read it in full.

Use the filter bar above the table to narrow results:

FilterValues
InstanceSelect a specific integration job, or leave blank to show all instances.
Entity TypeSelect a specific entity type. The list updates based on the selected instance.
Source IDEnter a partial or full source-system identifier to find a specific record.
LimitNumber of rows to load (default 100). Increase if you need to see older records.

Select Clear to reset all filters to their defaults.

Sync Logs shows per-record entries rather than grouped run summaries. To review all records from a single run (batch sync), filter by the instance and then look for records with the same Started timestamp cluster. For a grouped view of run outcomes with totals and correlation IDs, open the instance detail page from Instances in the navigation.

For records in a Failed or Partial state, the Details column contains the error message returned by the target system. Use this message to determine whether the failure is a data problem (such as a missing required field) or a connectivity problem (such as an authentication error).

Records that exhaust all automatic retries are moved to the Dead Letter Queue. See DLQ and Replay to replay or discard them.