config

type CPUMetricsConfig ¶

type CPUMetricsConfig types.CPUMetricsConfig

CPUMetricsConfig controls GET /integrations/metrics/cpu.

type DiskMetricsConfig ¶

type DiskMetricsConfig types.DiskMetricsConfig

DiskMetricsConfig controls GET /integrations/metrics/disk.

type DockerConfig ¶

type DockerConfig struct {
	Enabled    bool
	Containers DockerSectionConfig `toml:"containers"`
	Images     DockerSectionConfig `toml:"images"`
	Compose    DockerSectionConfig `toml:"compose"`
	Swarm      DockerSectionConfig `toml:"swarm"`
}

DockerConfig is the parsed and validated representation of docker.toml. Enabled is set to true only after a successful load — absent file means the docker integration is disabled (503), not an error.

func LoadDockerConfig(ctx context.Context, logger *zap.Logger) (DockerConfig, error)

type DockerSectionConfig ¶

type DockerSectionConfig struct {
	// Enabled gates all operations in this section.
	// If false, all endpoints in the section return 403 regardless of Allow.
	Enabled bool `toml:"enabled"`

	// Allow is the list of permitted operations within this section.
	// Valid values differ per section and are validated at startup.
	// An unknown value causes a fatal config error with the valid set listed.
	Allow []string `toml:"allow"`
}

DockerSectionConfig is the common shape for every docker.toml section. Enabled gates the entire section. Allow is the set of permitted operations within that section — validated at load time against the section's closed set of valid values.

func (s DockerSectionConfig) Permits(op string) bool

type HostMetricsConfig ¶

type HostMetricsConfig types.HostMetricsConfig

HostMetricsConfig controls GET /integrations/metrics/host.

type JournalConfig ¶

type JournalConfig struct {
	// Enabled gates the per-unit journal endpoint
	// (GET /integrations/systemd/units/{unit}/journal).
	Enabled bool `toml:"enabled"`

	// Priority is the minimum log severity to return.
	// Valid values: emerg, alert, crit, err, warning, notice, info, debug.
	// Defaults to "info" if omitted.
	Priority string `toml:"priority"`

	// Lines is the default number of journal lines returned per request.
	// Must be a positive integer. Defaults to 100 if omitted.
	Lines int `toml:"lines"`

	// SystemJournal permits GET /integrations/systemd/journal (system-wide).
	// Kept as a dedicated bool because it is a distinct endpoint, not an
	// operation variant of the per-unit journal.
	SystemJournal bool `toml:"system_journal"`
}

JournalConfig controls journal retrieval behaviour. It applies to both per-unit journal endpoints and the system-wide journal.

type MemoryMetricsConfig ¶

type MemoryMetricsConfig types.MemoryMetricsConfig

MemoryMetricsConfig controls GET /integrations/metrics/memory.

type MetricsConfig ¶

type MetricsConfig types.MetricsConfig

MetricsConfig is the parsed and validated representation of metrics.toml.

Each sub-section maps to one metrics endpoint group. Sections are independent — enabling disk does not require enabling cpu, and so on.

func LoadMetricsConfig(ctx context.Context, logger *zap.Logger) (MetricsConfig, error)

func (c MetricsConfig) ProcessLimit() int

type NetworkMetricsConfig ¶

type NetworkMetricsConfig types.NetworkMetricsConfig

NetworkMetricsConfig controls GET /integrations/metrics/network.

type PathRule ¶

type PathRule types.PathRule

type ProcessMetricsConfig ¶

type ProcessMetricsConfig types.ProcessMetricsConfig

ProcessMetricsConfig controls GET /integrations/metrics/processes.

type ResolvedIdentity ¶ added in v0.1.17

type ResolvedIdentity types.ResolvedIdentity

type SystemdConfig ¶

type SystemdConfig types.SystemdConfig

SystemdConfig is the parsed and validated representation of systemd.toml.

func LoadSystemdConfig(ctx context.Context, logger *zap.Logger) (SystemdConfig, error)

type UnitConfig ¶

type UnitConfig types.UnitConfig

UnitConfig controls which systemd unit operations are permitted.

type VarScope ¶

type VarScope types.VarScope

type VarsConfig ¶

type VarsConfig types.VarsConfig

VarsConfig is the parsed and validated representation of vars.toml.

func LoadVarsConfig(ctx context.Context, logger *zap.Logger) (VarsConfig, error)