backup_metrics.go RawHistoryFolder

1package out
2
3import (
4	"context"
5	"time"
6
7	"github.com/bnema/gordon/internal/domain"
8)
9
10// BackupMetrics records backup outcomes.
11// Implementations must be safe for concurrent use.
12type BackupMetrics interface {
13	// RecordBackupRun counts one finished backup run. A successful run
14	// also becomes the target's last success.
15	RecordBackupRun(ctx context.Context, run domain.BackupRunRecord)
16	// ObserveStoredBackup reports an existing stored backup as a success
17	// without counting a run, so the last success survives a restart.
18	// Older records never replace a newer one.
19	ObserveStoredBackup(run domain.BackupRunRecord)
20	// RetainBackupTargets forgets the last success of every target of kind
21	// that is not in targets, so a removed app or backup declaration stops
22	// being reported. targets is the declaration read at asOf: a target
23	// updated after asOf is kept, since it may have been declared since.
24	RetainBackupTargets(kind domain.BackupKind, targets []domain.BackupTargetRef, asOf time.Time)
25}