system

type CPUSnapshot struct {
	UsagePercent  float64 `json:"usagePercent"`
	UserPercent   float64 `json:"userPercent"`
	SystemPercent float64 `json:"systemPercent"`
	IdlePercent   float64 `json:"idlePercent"`
	IowaitPercent float64 `json:"iowaitPercent"`
	NumCPU        int     `json:"numCpu"`
}

type DiskCacheConfig struct {
	// Enabled 是否启用磁盘缓存
	Enabled bool
	// ThresholdMB 触发磁盘缓存的请求体大小阈值（MB）
	ThresholdMB int
	// MaxSizeMB 磁盘缓存最大总大小（MB）
	MaxSizeMB int
	// Path 磁盘缓存目录
	Path string
}

type DiskCacheStats struct {
	// 当前活跃的磁盘缓存文件数
	ActiveDiskFiles int64 `json:"active_disk_files"`
	// 当前磁盘缓存总大小（字节）
	CurrentDiskUsageBytes int64 `json:"current_disk_usage_bytes"`
	// 当前内存缓存数量
	ActiveMemoryBuffers int64 `json:"active_memory_buffers"`
	// 当前内存缓存总大小（字节）
	CurrentMemoryUsageBytes int64 `json:"current_memory_usage_bytes"`
	// 磁盘缓存命中次数
	DiskCacheHits int64 `json:"disk_cache_hits"`
	// 内存缓存命中次数
	MemoryCacheHits int64 `json:"memory_cache_hits"`
	// 磁盘缓存最大限制（字节）
	DiskCacheMaxBytes int64 `json:"disk_cache_max_bytes"`
	// 磁盘缓存阈值（字节）
	DiskCacheThresholdBytes int64 `json:"disk_cache_threshold_bytes"`
}

type DiskCacheType string

type DiskPathProvider func() []string

type DiskPathUsage struct {
	Path        string  `json:"path"`
	Total       uint64  `json:"total"`
	Used        uint64  `json:"used"`
	Free        uint64  `json:"free"`
	UsedPercent float64 `json:"usedPercent"`
	InodesTotal uint64  `json:"inodesTotal"`
	InodesFree  uint64  `json:"inodesFree"`
	InodesUsed  uint64  `json:"inodesUsed"`
}

type DiskSpaceInfo struct {
	// 总空间（字节）
	Total uint64 `json:"total"`
	// 可用空间（字节）
	Free uint64 `json:"free"`
	// 已用空间（字节）
	Used uint64 `json:"used"`
	// 使用百分比
	UsedPercent float64 `json:"used_percent"`
}

type GCSnapshot struct {
	NumGC              uint32  `json:"numGC"`
	NumForcedGC        uint32  `json:"numForcedGC"`
	PauseTotalNs       uint64  `json:"pauseTotalNs"`
	PauseTotalMs       float64 `json:"pauseTotalMs"`
	RecentPauseAvgMs   float64 `json:"recentPauseAvgMs"`
	RecentPauseMaxMs   float64 `json:"recentPauseMaxMs"`
	RecentPauseSamples int     `json:"recentPauseSamples"`
	GCCPUFraction      float64 `json:"gcCpuFraction"`
	NextGC             uint64  `json:"nextGC"`
	LastGCUnixNano     int64   `json:"lastGCUnixNano"`
	GCPerMinute        float64 `json:"gcPerMinute"`
}

type GaugeSetter func(name, help string, labels map[string]string, value float64)

type GoroutineSnapshot struct {
	NumGoroutine    int            `json:"numGoroutine"`
	NumGoroutineMax int            `json:"numGoroutineMax"`
	NumThread       int            `json:"numThread"`
	NumCgoCall      int64          `json:"numCgoCall"`
	ByState         map[string]int `json:"byState"`
	LeakSuspect     bool           `json:"leakSuspect"`
}

type HostMemorySnapshot struct {
	Total       uint64  `json:"total"`
	Available   uint64  `json:"available"`
	Used        uint64  `json:"used"`
	UsedPercent float64 `json:"usedPercent"`
	SwapTotal   uint64  `json:"swapTotal"`
	SwapUsed    uint64  `json:"swapUsed"`
	SwapPercent float64 `json:"swapPercent"`
}

type HostSnapshot struct {
	CPU     CPUSnapshot        `json:"cpu"`
	Load    LoadSnapshot       `json:"load"`
	Memory  HostMemorySnapshot `json:"memory"`
	Disks   []DiskPathUsage    `json:"disks"`
	Network NetSnapshot        `json:"network"`
	Process ProcessSnapshot    `json:"process"`
}

type LoadSnapshot struct {
	Load1  float64 `json:"load1"`
	Load5  float64 `json:"load5"`
	Load15 float64 `json:"load15"`
}

type NetSnapshot struct {
	BytesSent   uint64 `json:"bytesSent"`
	BytesRecv   uint64 `json:"bytesRecv"`
	PacketsSent uint64 `json:"packetsSent"`
	PacketsRecv uint64 `json:"packetsRecv"`
	DropIn      uint64 `json:"dropIn"`
	DropOut     uint64 `json:"dropOut"`
	ErrIn       uint64 `json:"errIn"`
	ErrOut      uint64 `json:"errOut"`
}

type OpsCounters struct {
	PanicTotal           uint64 `json:"panicTotal"`
	HTTP5xxTotal         uint64 `json:"http5xxTotal"`
	HTTP4xxTotal         uint64 `json:"http4xxTotal"`
	JWTVerifyFailTotal   uint64 `json:"jwtVerifyFailTotal"`
	DBReconnectTotal     uint64 `json:"dbReconnectTotal"`
	PreflightFailTotal   uint64 `json:"preflightFailTotal"`
	DependencyFailTotal  uint64 `json:"dependencyFailTotal"`
	FileIOErrorTotal     uint64 `json:"fileIoErrorTotal"`
	SSLCertLoadFailTotal uint64 `json:"sslCertLoadFailTotal"`
}

type PerformanceMonitorConfig struct {
	Enabled         bool
	CPUThreshold    int
	MemoryThreshold int
	DiskThreshold   int
}

type ProcessSnapshot struct {
	PID            int32   `json:"pid"`
	RSS            uint64  `json:"rss"`
	VMS            uint64  `json:"vms"`
	CPUPercent     float64 `json:"cpuPercent"`
	OpenFDs        int32   `json:"openFds"`
	MaxFDs         uint64  `json:"maxFds"`
	NumThreads     int32   `json:"numThreads"`
	CreateTimeUnix int64   `json:"createTimeUnix"`
}

type RuntimeMemorySnapshot struct {
	Alloc         uint64  `json:"alloc"`
	TotalAlloc    uint64  `json:"totalAlloc"`
	Sys           uint64  `json:"sys"`
	Lookups       uint64  `json:"lookups"`
	Mallocs       uint64  `json:"mallocs"`
	Frees         uint64  `json:"frees"`
	HeapAlloc     uint64  `json:"heapAlloc"`
	HeapSys       uint64  `json:"heapSys"`
	HeapIdle      uint64  `json:"heapIdle"`
	HeapInuse     uint64  `json:"heapInuse"`
	HeapReleased  uint64  `json:"heapReleased"`
	HeapObjects   uint64  `json:"heapObjects"`
	StackInuse    uint64  `json:"stackInuse"`
	StackSys      uint64  `json:"stackSys"`
	MSpanInuse    uint64  `json:"mSpanInuse"`
	MSpanSys      uint64  `json:"mSpanSys"`
	MCacheInuse   uint64  `json:"mCacheInuse"`
	MCacheSys     uint64  `json:"mCacheSys"`
	BuckHashSys   uint64  `json:"buckHashSys"`
	GCSys         uint64  `json:"gcSys"`
	OtherSys      uint64  `json:"otherSys"`
	NextGC        uint64  `json:"nextGC"`
	LastGC        uint64  `json:"lastGC"`
	PauseTotalNs  uint64  `json:"pauseTotalNs"`
	NumGC         uint32  `json:"numGC"`
	NumForcedGC   uint32  `json:"numForcedGC"`
	GCCPUFraction float64 `json:"gcCpuFraction"`
	EnableGC      bool    `json:"enableGC"`
}

type RuntimeSnapshot struct {
	GoVersion string                `json:"goVersion"`
	Memory    RuntimeMemorySnapshot `json:"memory"`
	GC        GCSnapshot            `json:"gc"`
	Goroutine GoroutineSnapshot     `json:"goroutine"`
}

type RuntimeTrendPoint struct {
	Ts          int64   `json:"ts"` // unix milliseconds
	HeapAlloc   uint64  `json:"heapAlloc"`
	HeapInuse   uint64  `json:"heapInuse"`
	HeapObjects uint64  `json:"heapObjects"`
	Sys         uint64  `json:"sys"`
	Goroutines  int     `json:"goroutines"`
	NumGC       uint32  `json:"numGC"`
	CPUUsage    float64 `json:"cpuUsage"`
	MemoryUsage float64 `json:"memoryUsage"`
	ProcessRSS  uint64  `json:"processRss,omitempty"`
}

type RuntimeTrendSnapshot struct {
	IntervalSeconds int                 `json:"intervalSeconds"`
	PersistDir      string              `json:"persistDir"`
	Points          []RuntimeTrendPoint `json:"points"`
	Summary         RuntimeTrendSummary `json:"summary"`
}

type RuntimeTrendSummary struct {
	SampleCount     int   `json:"sampleCount"`
	WindowMs        int64 `json:"windowMs"`
	HeapAllocDelta  int64 `json:"heapAllocDelta"`
	GoroutineDelta  int   `json:"goroutineDelta"`
	HeapAllocRising bool  `json:"heapAllocRising"`
	GoroutineRising bool  `json:"goroutineRising"`
	FirstTs         int64 `json:"firstTs,omitempty"`
	LastTs          int64 `json:"lastTs,omitempty"`
}

type SSRFProtection struct {
	AllowPrivateIp         bool
	DomainFilterMode       bool     // true: 白名单, false: 黑名单
	DomainList             []string // domain format, e.g. example.com, *.example.com
	IpFilterMode           bool     // true: 白名单, false: 黑名单
	IpList                 []string // CIDR or single IP
	AllowedPorts           []int    // 允许的端口范围
	ApplyIPFilterForDomain bool     // 对域名启用IP过滤
}

type SystemStatus struct {
	CPUUsage    float64
	MemoryUsage float64
	DiskUsage   float64
}