New to Stash? Please start here.

Monitoring Stash

Stash has native support for monitoring via Prometheus.

Monitoring Stash Operator

Stash operator exposes Prometheus native monitoring data via /metrics endpoint on :56790 port. You can setup a CoreOS Prometheus ServiceMonitor using stash-operator service.

Monitoring Backup Operation

Since backup operations are run as cron jobs, Stash can use Prometheus Pushgateway cache metrics for backup operation. The installation scripts for Stash operator deploys a Prometheus Pushgateway as a sidecar container. You can configure a Prometheus server to scrape this Pushgateway via stash-operator service on port :56789. Backup operations send the following metrics to this Pushgateway:

• restic_session_success{job="<restic.namespace>-<restic.name>", app="<workload>"}: Indicates if session was successfully completed
• restic_session_fail{job="<restic.namespace>-<restic.name>", app="<workload>"}: Indicates if session failed
• restic_session_duration_seconds_total{job="<restic.namespace>-<restic.name>", app="<workload>"}: Total seconds taken to complete restic session
• restic_session_duration_seconds{job="<restic.namespace>-<restic.name>", app="<workload>", filegroup="dir1", op="backup|forget"}: Total seconds taken to complete restic session

Grafana Dashboard

The dashboard can be downloaded directly from the repo or from Grafana.com. You can import the dashboard JSON file or through Grafana.com import by ID 4198.

The dashboard looks like this:

Next Steps

• Learn how to use Stash to backup a Kubernetes deployment here.
• Learn about the details of Restic CRD here.
• To restore a backup see here.
• Learn about the details of Recovery CRD here.
• To run backup in offline mode see here
• See the list of supported backends and how to configure them here.
• See working examples for supported workload types here.
• Learn about how to configure RBAC roles.
• Learn about how to configure Stash operator as workload initializer here.
• Want to hack on Stash? Check our contribution guidelines.