observability

type ContainerState struct {
	Exists  bool
	Running bool
	Hash    string
	Ports   Ports
}

type Ports struct {
	Grafana    int
	OTLP       int
	Prometheus int
}

type RulesOptions struct {
	// SLO is the availability objective in percent, for example 99.9.
	SLO float64
	// P95Threshold is the latency above which ForgeHighLatencyP95 fires.
	P95Threshold time.Duration
}

type Stack struct {
	Runner       execx.Runner
	Dir          string // state directory, see DefaultStateDir
	Name         string // container name, ContainerName when empty
	Volume       string // data volume, VolumeName when empty
	Network      string // user network, NetworkName when empty
	Image        string // Image when empty
	Ports        Ports
	Out          io.Writer     // progress lines, discarded when nil
	ReadyTimeout time.Duration // 90s when zero
	PollInterval time.Duration // 1s when zero
	// PortFree reports whether a host port is free. It checks 127.0.0.1 when nil.
	PortFree func(ctx context.Context, port int) bool
}

type Target struct {
	Name    string // becomes the job label
	Address string // host:port as seen from inside the container
	// Rewritten is true when ParseTarget replaced a loopback host with
	// host.docker.internal.
	Rewritten bool
}

type TargetHealth struct {
	Job       string
	URL       string
	Health    string
	LastError string
}