resourceadvisor

type Action struct {
	Type ActionType `json:"type"`
	// Value is bytes, nano-CPUs or idle minutes, by Type. Current is the
	// value it replaces, 0 when none is set.
	Value        int64             `json:"value,omitempty"`
	Current      int64             `json:"current,omitempty"`
	Settings     map[string]string `json:"settings,omitempty"`
	Instructions string            `json:"instructions,omitempty"`
}

type ActionType string

type Evidence struct {
	Window        string             `json:"window"`
	WindowSeconds int64              `json:"window_seconds"`
	Samples       int                `json:"samples"`
	Unit          string             `json:"unit,omitempty"`
	P50           float64            `json:"p50,omitempty"`
	P95           float64            `json:"p95,omitempty"`
	P99           float64            `json:"p99,omitempty"`
	Max           float64            `json:"max,omitempty"`
	Limit         float64            `json:"limit,omitempty"`
	Numbers       map[string]float64 `json:"numbers,omitempty"`
	Series        []Point            `json:"series,omitempty"`
}

type Finding struct {
	ID       string            `json:"id"`
	Kind     Kind              `json:"kind"`
	Severity Severity          `json:"severity"`
	Resource Ref               `json:"resource"`
	Title    string            `json:"title"`
	Why      string            `json:"why"`
	Evidence Evidence          `json:"evidence"`
	Impact   Impact            `json:"impact"`
	Action   *Action           `json:"action,omitempty"`
	Params   map[string]string `json:"params,omitempty"`
}

type Impact struct {
	SavingMemoryBytes int64      `json:"saving_memory_bytes,omitempty"`
	SavingNanoCPUs    int64      `json:"saving_nano_cpus,omitempty"`
	SavingDiskBytes   int64      `json:"saving_disk_bytes,omitempty"`
	ExhaustionAt      *time.Time `json:"exhaustion_at,omitempty"`
	Risk              string     `json:"risk,omitempty"`
}

type Input struct {
	Now        time.Time
	Resources  []Resource
	Nodes      []Node
	Thresholds Thresholds
}

type Kind string

type Node struct {
	ID   string
	Name string
	// MemoryTotal is 0 when the node does not report host memory.
	MemoryTotal     float64
	MemoryAvailable []Sample
	SwapUsed        []Sample
	DiskUsed        []Sample
	DiskTotal       float64
	Reclaimable     *Reclaimable
	// NoIdentity marks a single server without a node record.
	NoIdentity bool
}

type OOM struct {
	At      time.Time
	Excerpt string
}

type Point struct {
	T time.Time `json:"t"`
	V float64   `json:"v"`
}

type Reclaimable struct {
	ImagesBytes     int64
	BuildCacheBytes int64
}

type Ref struct {
	Kind ResourceKind `json:"kind"`
	Name string       `json:"name"`
}

type Resource struct {
	Ref     Ref
	NodeID  string
	Engine  string
	Version string
	Image   string
	// MemoryLimit and NanoCPUs are the configured limits, 0 when unset.
	MemoryLimit int64
	NanoCPUs    int64
	Memory      []Sample
	CPUPercent  []Sample
	Restarts    int
	OOM         *OOM
	// Requests are per-tick request counts; only non-zero ticks are stored,
	// so they mean anything only when ServesTraffic is true.
	Requests      []Sample
	ServesTraffic bool
	SleepEnabled  bool
	Suspended     bool
	// LinkedApps counts apps wired to a database, -1 when unknown.
	LinkedApps int
}

type ResourceKind string

type Sample struct {
	At    time.Time
	Value float64
}

type Severity string

type Summary struct {
	Total             int            `json:"total"`
	BySeverity        map[string]int `json:"by_severity"`
	ByKind            map[string]int `json:"by_kind"`
	Actionable        int            `json:"actionable"`
	PendingData       int            `json:"pending_data"`
	SavingMemoryBytes int64          `json:"saving_memory_bytes"`
	SavingDiskBytes   int64          `json:"saving_disk_bytes"`
	TopSavings        []Finding      `json:"top_savings"`
}

type Thresholds struct {
	Window             time.Duration
	MinData            time.Duration
	MemoryHeadroom     float64
	CPUHeadroom        float64
	TightRatio         float64
	OverProvisionRatio float64
	RestartsTight      int
	GrowthMinFraction  float64
	GrowthMinFit       float64
	IdleWindow         time.Duration
	IdleCPUPercent     float64
	SleepIdleMinutes   int64
	TuningMinMemory    int64
	SmallDatabaseBytes int64
	SmallDatabaseCount int
	HostPressure       float64
	SwapWarnBytes      int64
	TopConsumerShare   float64
	DiskHorizon        time.Duration
	ReclaimableMin     int64
	DatabaseCPUFloor   int64
	CacheTTL           time.Duration
}