Skip to content

v0.5.0

Choose a tag to compare

@github-actions github-actions released this 22 Aug 20:08
· 12 commits to main since this release
refactor: rework Grafana dashboard around archive history

The "last backup" and "repository size" timeseries graphs were mostly
useless at the dashboard's default 6h window (at most 1-2 data points
given the default 4h METRICS_REFRESH_INTERVAL). Replace them with:

- An "Archive history" table and five single-metric bar charts (files,
  duration, original/compressed/deduplicated size) driven by the new
  borg_archive_* metrics from #7, one bar per archive so trends are
  visible regardless of the time window.
- Truncated (10 char), 45deg-rotated x-axis labels on the bar charts,
  since archive names are long; full names remain in the tooltip.
- "Last collection duration" converted from a timeseries to a stat
  panel, matching its "Last collection"/"Last collection error"
  siblings.
- Dropped the now-redundant top "Last backup for $repository" age row
  (superseded by the Summary table's colored age column) and the
  repository-total size graphs.

Also renames the "deduplicated size" columns/panels/metrics docs to
"Unique Data Added": verified against borg's own semantics (and
confirmed empirically against a live repo) that this stat is not "the
backup's size after dedup" but the data exclusively owned by that one
archive relative to the repository's *current* state - order-dependent,
can read 0 for a large valid backup, and can shift for older archives
as newer ones are created. Documented this caveat in the README next
to the two affected metrics.

The separate long-term-trend dashboard idea (using the existing
prometheus-longterm datasource) is tracked in #9 instead.