checkprometheus

type PrometheusChecker struct{}

type PrometheusConfig struct {
	// URL is the metrics endpoint (scrape mode) or the Prometheus server
	// base URL (promql mode).
	URL string `json:"url"`

	// Mode is "scrape" (default) or "promql".
	Mode string `json:"mode,omitempty"`

	// Metric is the metric (series) name to select, scrape mode only.
	// Histogram/summary families are addressed through their flattened
	// series names: `<name>_sum`, `<name>_count`, `<name>_bucket` (with an
	// `le` label), or `<name>` with a `quantile` label.
	Metric string `json:"metric,omitempty"`

	// Labels narrows the selection to series carrying at least these
	// label/value pairs (exact-match subset), scrape mode only.
	Labels map[string]string `json:"labels,omitempty"`

	// Query is the PromQL instant query, promql mode only.
	Query string `json:"query,omitempty"`

	// Operator is the comparison applied against the thresholds.
	Operator string `json:"operator,omitempty"`

	// WarningValue, when breached, yields StatusWarning (amber, counts as
	// up, never pages). A config with only a warning tier is valid — it can
	// never produce StatusDown, exactly like `warningDays` on domain/ssl.
	WarningValue *float64 `json:"warningValue,omitempty"`

	// CriticalValue, when breached, yields StatusDown (pages).
	CriticalValue *float64 `json:"criticalValue,omitempty"`

	// Match decides what happens when more than one series matches.
	Match string `json:"match,omitempty"`

	// OnMissing is the status reported when nothing matches.
	OnMissing string `json:"onMissing,omitempty"`

	// Headers are sent with the request (bearer/basic auth on the metrics
	// endpoint is routine). Same shape — and same at-rest handling — as the
	// HTTP check's `headers`: stored in the public config, not encrypted.
	Headers map[string]string `json:"headers,omitempty"`

	// Timeout caps the HTTP request; default 15s, max 60s.
	Timeout time.Duration `json:"timeout,omitempty"`
}