monitoring

type LokiConfig struct {
	// RetentionPeriod is how long logs are kept. Loki accepts Go-style
	// durations (e.g. "720h" = 30d, "2160h" = 90d).
	RetentionPeriod string
	// MaxChunkAge caps how long a chunk can stay open before forced flush.
	MaxChunkAge string
	// MultiTenantEnabled, when true, runs Loki in multi-tenant mode with
	// per-tenant isolation. Each nSelf project becomes a tenant.
	MultiTenantEnabled bool
	// RuleEngineEnabled turns on the Loki rule engine for log-based alerts.
	RuleEngineEnabled bool
}

type OTELCollectorConfig struct {
	// TempoEndpoint is the OTLP HTTP endpoint the collector forwards to.
	// Default: http://tempo:4318.
	TempoEndpoint string

	// OTLPGRPCPort is the gRPC port the collector exposes to apps.
	// Default: 4317.
	OTLPGRPCPort int

	// OTLPHTTPPort is the HTTP port the collector exposes to apps.
	// Default: 4318.
	OTLPHTTPPort int
}

type PrometheusConfig struct {
	// ScrapeInterval is the global default (e.g. "15s").
	ScrapeInterval string
	// EvaluationInterval is how often Prometheus evaluates alert rules.
	EvaluationInterval string
	// ExternalLabels apply to every time series (useful for multi-cluster).
	ExternalLabels map[string]string
	// AlertmanagerURL is the Alertmanager host:port; empty disables alerting.
	AlertmanagerURL string
	// RuleFiles are paths (inside the container) to load alert rules from.
	RuleFiles []string
	// Targets is the full list of scrape targets.
	Targets []ScrapeTarget
}

type PromtailConfig struct {
	// LokiURL is the Loki push endpoint. Inside the docker network this is
	// typically "http://loki:3100/loki/api/v1/push".
	LokiURL string
	// TenantID is the X-Scope-OrgID sent with every push. Empty in
	// single-tenant mode; required when Loki is multi-tenant.
	TenantID string
	// ProjectName is the nSelf project name; attached as a static label on
	// every line so operators can distinguish multiple projects on one host.
	ProjectName string
}

type ScrapeTarget struct {
	// JobName uniquely identifies the target in Prometheus. Use the plugin
	// name (e.g. "ai", "mux") or the service name (e.g. "postgres", "nginx").
	JobName string

	// ServiceName is the docker-compose service name resolved via the Docker
	// network DNS. Prometheus scrapes <ServiceName>:<Port><Path>.
	ServiceName string

	// Port is the plugin's HTTP port as declared in plugin.json.
	Port int

	// Path is the metrics endpoint. Defaults to /metrics if empty.
	Path string

	// Interval overrides the global scrape_interval when set. Empty = global.
	Interval string

	// Labels are additional static labels attached to every scraped series.
	// Common use: {"plugin": "ai", "tier": "pro"}.
	Labels map[string]string

	// BearerToken, when set, is sent as an Authorization: Bearer header.
	// Used by Hasura /v1/metrics which requires HASURA_GRAPHQL_METRICS_SECRET.
	BearerToken string
}

type TempoConfig struct {
	// RetentionPeriod is how long traces are kept. Accepts Go-style durations
	// (e.g. "168h" = 7d, "720h" = 30d). Default: 168h (7 days).
	RetentionPeriod string

	// StoragePath is the bind-mount path inside the Tempo container where
	// trace data is persisted. Default: /var/tempo.
	StoragePath string

	// HTTPPort is the Tempo HTTP port used for UI + /api/v1/push ingress.
	// Default: 3200.
	HTTPPort int

	// OTLPGRPCPort is the gRPC port Tempo listens on for OTLP spans from the
	// OTEL Collector. Default: 4317.
	OTLPGRPCPort int
}