storage

package
v0.18.1 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Aug 6, 2026 License: MIT Imports: 7 Imported by: 0

Documentation

Overview

Package storage persists aggregated traffic into SQLite and answers the ranking / time-series queries the API exposes. It uses the pure-Go modernc.org/sqlite driver so the binary needs no system SQLite.

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type IfaceUsage added in v0.12.0

type IfaceUsage struct {
	Iface string
	Rx    uint64
	Tx    uint64
}

IfaceUsage is one interface's total rx/tx over a queried range.

type Store

type Store struct {
	// contains filtered or unexported fields
}

Store is a handle to the netscope database.

func Open

func Open(path string) (*Store, error)

Open opens (creating if needed) the SQLite database at path and applies the schema and connection pragmas. If the existing database is corrupt (e.g. after power loss), it is quarantined aside and a fresh one is created — otherwise a fatal Open error would brick the daemon in a launchd KeepAlive crash loop until someone manually deletes the file.

func (*Store) AddIfaceUsage added in v0.12.0

func (s *Store) AddIfaceUsage(iface string, day int64, rx, tx uint64) error

AddIfaceUsage folds rx/tx bytes into the given interface's daily total. day is unix seconds at local midnight. A no-op when iface is empty or both are zero.

func (*Store) AppTimeSeries added in v0.5.0

func (s *Store) AppTimeSeries(app string, since, until time.Time, step time.Duration) ([]types.TimePoint, error)

AppTimeSeries returns one app's rx/tx bucketed into intervals of step over [since, until). Empty intervals are omitted.

func (*Store) Apps

func (s *Store) Apps(since, until time.Time) ([]types.AppTraffic, error)

Apps returns per-app totals over [since, until), ranked by total bytes.

func (*Store) Checkpoint added in v0.5.0

func (s *Store) Checkpoint()

Checkpoint flushes the WAL back into the main database and truncates it, so the WAL file can't grow without bound. Best-effort.

func (*Store) Close

func (s *Store) Close() error

Close closes the underlying database.

func (*Store) Domains

func (s *Store) Domains(since, until time.Time) ([]types.DomainStat, error)

Domains returns per-domain totals over [since, until), ranked by total bytes.

func (*Store) DomainsForApp added in v0.5.0

func (s *Store) DomainsForApp(app string, since, until time.Time) ([]types.DomainStat, error)

DomainsForApp returns per-domain totals for a single app over [since, until), ranked by total bytes — backs the dashboard's per-app drill-down.

func (*Store) EnforceSizeCap added in v0.5.0

func (s *Store) EnforceSizeCap(maxBytes int64) (bool, error)

EnforceSizeCap is the disk safety net: independent of time-based retention, it drops the oldest data (a day at a time) until the database fits under maxBytes. It checkpoints + vacuums between steps so on-disk size reflects each deletion. Returns whether anything was removed. A non-positive cap disables it.

func (*Store) FlushApps

func (s *Store) FlushApps(bucket int64, apps []types.AppTraffic) error

FlushApps adds the per-app counters for the given bucket. Repeated flushes to the same bucket accumulate rather than overwrite.

func (*Store) FlushDomains

func (s *Store) FlushDomains(bucket int64, domains []types.DomainStat) error

FlushDomains adds the per-domain counters for the given bucket.

func (*Store) IfaceUsageAllSince added in v0.12.0

func (s *Store) IfaceUsageAllSince(sinceDay int64) ([]IfaceUsage, error)

IfaceUsageAllSince returns per-interface totals for every interface with usage on or after sinceDay (unix seconds at local midnight), most-used first.

func (*Store) Purge

func (s *Store) Purge(before time.Time) (bool, error)

Purge deletes samples older than before, for retention management. It reports whether any rows were actually removed (so the caller can decide to VACUUM).

func (*Store) SizeOnDisk added in v0.5.0

func (s *Store) SizeOnDisk() int64

SizeOnDisk returns the total bytes the database occupies, including the WAL and shared-memory side files (which can dominate between checkpoints).

func (*Store) TimeSeries

func (s *Store) TimeSeries(since, until time.Time, step time.Duration) ([]types.TimePoint, error)

TimeSeries returns rx/tx totals bucketed into intervals of step over [since, until). Empty intervals are omitted.

func (*Store) Vacuum added in v0.5.0

func (s *Store) Vacuum() error

Vacuum rebuilds the database, reclaiming pages freed by deletes so the file actually shrinks on disk. It rewrites the whole file, so call it sparingly.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL