obs

package
v0.5.8 Latest Latest
Warning

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

Go to latest
Published: Sep 2, 2026 License: AGPL-3.0 Imports: 7 Imported by: 0

Documentation

Overview

Package obs owns Subflux's observability surface: the Prometheus registry (exposition prefix "subflux_") and every counter, gauge and histogram it serves — searches, downloads, imports, scans, the HTTP transport, and the bbolt store. The collectors are unexported, so a caller records through a named method and cannot register, rename or delete a series.

Named obs, not metrics: the github.com/cplieger/metrics library it wraps owns that name, and while this package was called metrics the collision forced every reference to the library through an extmetrics alias. The rename removed the collision, so the library is imported plainly.

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type Metrics

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

Metrics holds all application metrics.

func New

func New() *Metrics

New creates a new Metrics instance.

func (*Metrics) AdaptiveSkip

func (m *Metrics) AdaptiveSkip()

AdaptiveSkip records an item skipped by adaptive search.

func (*Metrics) Handler

func (m *Metrics) Handler() http.HandlerFunc

Handler returns an HTTP handler that serves Prometheus metrics.

func (*Metrics) RecordBackupSuccess

func (m *Metrics) RecordBackupSuccess(dur time.Duration)

RecordBackupSuccess records a successful backup's timestamp and duration.

func (*Metrics) RecordDownload

func (m *Metrics) RecordDownload(provider subflux.ProviderID, err error)

RecordDownload records a download attempt, routing to the success or error counter.

func (*Metrics) RecordEmbeddedDetectorError

func (m *Metrics) RecordEmbeddedDetectorError()

RecordEmbeddedDetectorError counts a failed embedded track probe. The search engine excludes context cancellations before calling this.

func (*Metrics) RecordHTTP

func (m *Metrics) RecordHTTP(rm webhttp.RequestMetric)

RecordHTTP records one HTTP request. It takes webhttp's named-field record rather than four positional values so the two adjacent strings cannot be transposed on the way to a metric label.

func (*Metrics) RecordImport

func (m *Metrics) RecordImport(source subflux.PollKey)

RecordImport records an import detected.

func (*Metrics) RecordPanic

func (m *Metrics) RecordPanic()

RecordPanic records one HTTP handler panic recovered by the webhttp.Recoverer middleware. Wired as Recoverer's WithPanicHook so a recovered 500 also increments a monitorable counter.

func (*Metrics) RecordReconcile

func (m *Metrics) RecordReconcile(deleted int, reset int64, dur time.Duration)

RecordReconcile records metrics from a reconcile pass.

func (*Metrics) RecordScan

func (m *Metrics) RecordScan(items, found int, dur time.Duration)

RecordScan records scan completion.

func (*Metrics) RecordSearch

func (m *Metrics) RecordSearch(provider subflux.ProviderID, dur time.Duration, err error)

RecordSearch records a search attempt for a provider.

func (*Metrics) RecordStoreFileSize

func (m *Metrics) RecordStoreFileSize(bytes int64)

RecordStoreFileSize records the current bbolt database file size.

func (*Metrics) RecordStoreFreelistBytes

func (m *Metrics) RecordStoreFreelistBytes(bytes int64)

RecordStoreFreelistBytes records the reclaimable freelist bytes.

func (*Metrics) SetConfigured

func (m *Metrics) SetConfigured(ok bool)

SetConfigured records whether a valid configuration is active. It sets the subflux_configured gauge to 1 when configured (background automation running) and 0 in unconfigured mode (scheduler/poller/backup goroutines skipped), enabling a level-triggered "stuck unconfigured" alert.

func (*Metrics) SetPollCursorsDirty

func (m *Metrics) SetPollCursorsDirty(n int)

SetPollCursorsDirty records how many poll cursors currently have a failing durable persist (0 when healthy).

func (*Metrics) TotalSearches

func (m *Metrics) TotalSearches() int64

TotalSearches returns the cumulative search count across all providers.

Jump to

Keyboard shortcuts

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