Skip to main content

Data deployment history

View previous data deployments run through Gearset

Written by Richard Terry

Much like metadata deployments, Gearset stores a history of your data deployments in the app. This allows you to easily see the status and details of your previous deployments. 

Viewing data deployment history

You can view previous data deployments on the data history page in the app.

You will find it under Sandbox seeding menu and then Data history:

Once on the page there are a number of ways to view and filter your deployments.

Setting a date range

The most important setting to set is the date range you are searching in.

When viewing the data history page only the records that are in the set date range will be searched, this means you can search for all "backup restores" but if they fall outside of the set date range they will not show.

You can adjust the set date range by selecting the calendar icon in the top right of the page, and then selecting the date range you wish to search.

Make sure you click apply at the end!

Filter Options

Filter options allow you to narrow down your search to just the type of deployments you are interested in seeing.

There are 3 main ways to filter your deployments

1: Deployment statuses

Data deployments will have one of four statuses:

  • Successful: all planned deployment steps were completed. Note that a deployment can be successful even if no records were deployed. Deployments that were set to continue on error will also be marked as successful if all steps were completed, even if there were errors that stopped some records from being deployed.

  • Partially deployed: some records were deployed, but not all planned deployment steps were completed (e.g. deployment was set to stop on error and some steps were cancelled).

  • Failed: no records were deployed and not all planned deployed steps were completed (e.g. the deployment failed at the retrieval step).

  • In progress: This deployment is currently in the process of running, once complete it will change to one of the other 3 options

2: Deployment Types

There are 6 main data deployment types in Gearset

3: Owners

Currently there is only one option here "my deployments", this will filter the history to only data deployments that have come from your account.

If you wish to search by another user, we recommend you enter there name into the "search" field to filter to just there deployments.

The search bar

The search bar allows you to filter by most other listed information.
this is most commonly used to search for

  • Source org name

  • Target org name

  • Name of a Gearset user

Viewing previous deployments

You can view more information about any previous data deployment by clicking the View button. This will open the post-deployment summary page where you can see all the steps carried out, and any errors that were encountered.

If you open the more options, you can then select "download results" to view the ID of the successful and unsuccessful data records deployed.

This will then download a zip file to your downloads filter with two CSV files showing all successfully deployed ID's and ID's that had errors.

Additional Questions?

If you have any questions about the above, please feel free to reach out in the in-app chat and we will be happy to help clarify any details!

Did this answer your question?