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

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.