Snapshot and Restore

edit

Snapshot and Restore lets you back up a running Elasticsearch cluster using data and state snapshots. Snapshots are important because they provide a copy of your data in case something goes wrong. If you need to roll back to an older version of your data, you can restore a snapshot from the repository.

To get started, open the main menu, then click Stack Management > Snapshot and Restore. With this UI, you can:

  • Register a repository for storing your snapshots
  • View a list of your snapshots and drill down into details
  • Restore data into your cluster from a snapshot
  • Create a policy to automate snapshot creation and deletion
  • Delete a snapshot to free storage space

Snapshot list

Before using this feature, you should be familiar with how snapshots work. Snapshot and Restore is a good source for more detailed information.

Required permissions

edit

The minimum required permissions to access Snapshot and Restore include:

  • Cluster privileges: monitor, manage_slm, cluster:admin/snapshot, and cluster:admin/repository
  • Index privileges: all on the monitor index if you want to access content in the Restore Status tab

To add privileges, open the main menu, then click Stack Management > Roles.

Register a repository

edit

A repository is where your snapshots live. You must register a snapshot repository before you can perform snapshot and restore operations.

Kibana supports three repository types out of the box: shared file system, read-only URL, and source-only. For more information on these repositories and their settings, see Repositories. To use other repositories, such as S3, see Repository plugins.

The Repositories view displays a list of registered repositories. Click a repository name to view information about the repository, verify its status, or clean it up.

Repository list

View your snapshots

edit

A snapshot is a backup taken from a running Elasticsearch cluster. You’ll find an overview of your snapshots in the Snapshots view, and you can drill down into each snapshot for further investigation.

Snapshot details

If you don’t have any snapshots, you can create them using the create snapshot API.

Restore a snapshot

edit

The information stored in a snapshot is not tied to a specific cluster or a cluster name. This enables you to restore a snapshot made from one cluster to another cluster. You might use the restore operation to:

  • Recover data lost due to a failure
  • Migrate an Elasticsearch cluster to a new version
  • Move data from one cluster to another cluster

To get started, go to the Snapshots view, find the snapshot, and click the restore icon in the Actions column. The Restore wizard presents options for the restore operation, including which data streams and indices to restore and whether to change index settings. You can restore an existing index only if it’s closed and has the same number of shards as the index in the snapshot.

Once you initiate the restore, you’re navigated to the Restore Status view, where you can track the current state for each shard in the snapshot.

Snapshot details

Create a snapshot lifecycle policy

edit

Use a snapshot lifecycle policy to automate the creation and deletion of cluster snapshots. Taking automatic snapshots:

  • Ensures your Elasticsearch data is backed up on a regular basis
  • Ensures a recent and relevant snapshot is available if a situation arises where a cluster needs to be recovered
  • Allows you to manage your snapshots in Kibana, instead of using a third-party tool

If you don’t have any snapshot policies, follow the Create policy wizard. It walks you through defining when and where to take snapshots, the settings you want, and how long to retain snapshots.

Snapshot details

An overview of your policies is on the Policies view. You can drill down into each policy to examine its settings and last successful and failed run.

You can perform the following actions on a snapshot policy:

  • Run a policy immediately without waiting for the scheduled time. This action is useful before an upgrade or before performing maintenance.
  • Edit a policy and immediately apply changes to the schedule.
  • Delete a policy to prevent any future snapshots from being taken. This action does not cancel any currently ongoing snapshots or remove any previously taken snapshots.

Snapshot details

Delete a snapshot

edit

Delete snapshots to manage your repository storage space. Find the snapshot in the Snapshots view and click the trash icon in the Actions column. To delete snapshots in bulk, select their checkboxes, and then click Delete snapshots.