Work with batch uploads
On the Batch uploads page you can view and monitor the status of batch uploads that you create using the Batch API. You can use this as an alternative to retrieving the status by making a GET request.
The Batch uploads page lists all batches uploaded to your instance of Sitecore CDP in the past 30 days. For a batch to display here, you must first make the PUT request that allocates a batch upload location.
On this page, you can search, sort, and filter the list of uploads to find the one you're interested in. You can also view the details of each upload, including when it was created and last modified, and the total number of uploaded JSON records. For uploads with errors, you can also download the error log, which helps you identify the JSON records that need your attention before attempting another upload.
View the status of a batch upload
To view the status of a specific batch upload:
-
On the navigation menu, click Developer center > Batch uploads and then locate the upload you want to work with.
-
In the Status column, you can view the status of the upload:
-
Uploading - the batch reference is saved and the gzipped file can now be uploaded. The batch stays in this status until the file is fully uploaded. After receiving the file, Sitecore CDP validates it and changes the status to
file_uploaded. -
File uploaded - Sitecore CDP received the gzipped file, and the file is now in the processing queue.
-
Processing - Sitecore CDP is processing the gzipped file.
-
Success - Sitecore CDP successfully processed all JSON records in the gzipped file. You can now verify that CDP ingested the uploaded data.
-
Corrupted - the MD5 checksum or the size of the gzipped file does not match the values provided by the developer.
-
Error - Sitecore CDP did not process at least one JSON record in the gzipped file. You can download the error log to troubleshoot the issue.
-
View the details of a batch upload
To view the details of a specific batch upload:
-
On the navigation menu, click Developer center > Batch uploads and then click the upload you want to work with.
-
In the table rows that appear, you can view the details of the batch upload:
-
Status - the status of the upload, for example,
file_uploaded. -
Time to process (ms) - the time in milliseconds it took Sitecore CDP to process the upload.
-
Total count - the number of JSON records included in the upload.
-
Succeeded count - the number of JSON records Sitecore CDP successfully processed.
-
Failed count - the number of JSON records Sitecore CDP did not process.
-
Log - for uploads where Sitecore CDP did not process at least one JSON record, the link to the error log.
-
Download an error log
An error log is available for all batch uploads where Sitecore CDP did not process at least one JSON record.
To download the error log:
-
On the navigation menu, click Developer center > Batch uploads and then click the upload with the error status that you want to work with.
-
In the table rows that appear, in the Log row, click Download log. For information about the contents of the log, see Retrieve batch upload error log.
Search for a batch upload
You can search for a specific batch upload by its reference or status.
To search for a batch upload:
-
On the navigation menu, click Developer center > Batch uploads.
-
On the Batch uploads page, in the search field, enter the UUID of the batch upload. You generated this value before starting the upload.
Sort batch uploads
By default, batch uploads are sorted by their last modified date in descending order.
To sort batch uploads:
-
On the navigation menu, click Developer center > Batch uploads.
-
On the Batch uploads page, click the Modified table column. This changes the order the batch uploads are sorted by and displays the first page of results.
Filter batch uploads by status
You can filter batch uploads by status, for example, if you want to easily find all the uploads that failed.
To filter batch uploads by status:
-
On the navigation menu, click Developer center > Batch uploads.
-
On the Batch uploads page, click Status: All and then select a status, for example, Error. Only batch uploads with the selected status display.
-
To remove the selected filter, click Status > Clear.