Creating a backup job is a team owner feature, if you are not a team owner you will see this:

and we will need to ask your team owner to allow you become a team owner to create a job.

Data backup dashboard

On this dashboard you have an overview of the data backup jobs that you have set up. Only your account has the visibility of the jobs you set up. Each job represents a single org that is being backed up.

Add a new data backup job

You can add a new org to back up via the CREATE JOB button and choose between a standard job or a high frequency job.

A standard job will, every day, take a backup of the records in your org. High frequency jobs run every hour and are limited to 10 objects.

You can only back up orgs that you own the connections for and not those that have been delegated to you. 

You can configure the API usage limit, after which Gearset will stop trying to back up your data records to allow non-backup jobs to use your API call.

You set the time of day when the backup is run, and there is an option to run an initial backup job immediately regardless of when the jobs are set to run.

You can also set a retention policy for how long you want to keep the backup records.

There are notification settings that you can configure in the Notification settings tab - for example you can set up a daily email or post to Slack on the job's status.

The Smart alerts tab allows you to trigger notifications based on more advanced rules. For example, if you want to get alerted when more than 5% of your contacts change or are deleted.

You can choose which objects in your org you wish to backup or exclude from the job in the Filtering tab. If you're looking for a starting point, you can use our Recommended objects filter.

In the Objects to back up tab a warning will be displayed if your Salesforce profile doesn't have the Modify All Data or Query All Files permission enabled. You can still back up your organization without this permission, but be aware that without it there may be objects in your organization that you are not able to include in a backup and/or restore.

You can also choose to enable automated backup for any new objects and managed packages.

In the Unsupported objects tab we list the objects that will not be included in your backup. An object may be unsupported by the Salesforce API or may be something Gearset has yet to implement support for.

The Permissions tab allows you to assign View, Browse, Execute, Edit, Delete, Restore and Download permissions to individual members of your team

To create a high frequency job you can follow the same steps with the exception of not having to set a time for the backup to run and the limit of 10 objects for the filter.

Reviewing a data backup job

Once the job is set up, if you did not select the option to run the job after creation, it will show a pending status. Once it hits the scheduled run time, it will begin the first snapshot.

When the job is running, you'll see the status change to blue. The time that the run takes will vary depending on your org record size.

When the run is completed, it will change to green. You can view the history and statistics of the job by clicking View details. Jobs can also be run on demand by clicking Back up now.

If there are any issues running the job, you'll see more information about what went wrong.

Data history 

The job’s history page will tell you the details of each run, along with a visual representation of the changes to your records over time.

Clicking Use snapshot... will give you the following options:

  • Download data or Download metadata will give you the option to downloading the full org data or metadata from this run as a zip file export. If you download data from your backup job then it'll be shown in the Data download history tab.

  • Replicate snapshot allows you to replicate this run's data or metadata to a different org (or repository in the case of metadata).

View changes lets you drill down into the changes across each object for this run. There, you will have two options:

  • View records allows you to see a list of all the records changed for an individual objects, with the option to perform a quick record restore or configure a restore if you wish.

  • Restore allows you to restore deleted records using the new workflow. See how this works in our support article here.

Clicking on a job run row will expand it and show two more options:

  • Restore snapshot metadata lets you restore this orgs metadata to this org. See how this works in our support article here.

  • Restore snapshot data lets you restore this orgs data to this org. See how this works in our support article here.

The last column refers to the metadata differences and will show as either Identical or Different. Clicking one of these will redirect you to the Metadata history tab.

Metadata history

In this tab you will find all of the runs for the metadata backup. The options available here are very similar to the ones in a Monitoring job: Download org snapshot, download comparison report, explore permissions, view code analysis issues, view changes, deploy changes to another org or a repository and perform a roll back.

Object analysis

Switching to the Object analysis  tab will show the record changes by object for the chosen timeframe.

Selecting an object at the top will display how the records in that object have changed during each backup job run. To view more details on a specific run, click the run time link.

Audit history

If you delete a record from a data backup job, this is where you will find the details with the option to export as a CSV file as well.

Did this answer your question?