Files
honeyDueAPI/internal/monitoring/collector.go
Trey t eb127fda20 Add real-time log monitoring and system stats dashboard
Implements a comprehensive monitoring system for the admin interface:

Backend:
- New monitoring package with Redis ring buffer for log storage
- Zerolog MultiWriter to capture logs to Redis
- System stats collection (CPU, memory, disk, goroutines, GC)
- HTTP metrics middleware (request counts, latency, error rates)
- Asynq queue stats for worker process
- WebSocket endpoint for real-time log streaming
- Admin auth middleware now accepts token in query params (for WebSocket)

Frontend:
- New monitoring page with tabs (Overview, Logs, API Stats, Worker Stats)
- Real-time log viewer with level filtering and search
- System stats cards showing CPU, memory, goroutines, uptime
- HTTP endpoint statistics table
- Asynq queue depth visualization
- Enable/disable monitoring toggle in settings

Memory safeguards:
- Max 200 unique endpoints tracked
- Hourly stats reset to prevent unbounded growth
- Max 1000 log entries in ring buffer
- Max 1000 latency samples for P95 calculation

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-12-09 10:26:40 -06:00

200 lines
4.6 KiB
Go

package monitoring
import (
"runtime"
"time"
"github.com/hibiken/asynq"
"github.com/rs/zerolog/log"
"github.com/shirou/gopsutil/v3/cpu"
"github.com/shirou/gopsutil/v3/disk"
"github.com/shirou/gopsutil/v3/load"
"github.com/shirou/gopsutil/v3/mem"
)
// Collector gathers system and runtime statistics
type Collector struct {
process string
startTime time.Time
statsStore *StatsStore
httpCollector *HTTPStatsCollector // nil for worker
asynqClient *asynq.Inspector // nil for api
stopChan chan struct{}
}
// NewCollector creates a new stats collector
func NewCollector(process string, statsStore *StatsStore) *Collector {
return &Collector{
process: process,
startTime: time.Now(),
statsStore: statsStore,
stopChan: make(chan struct{}),
}
}
// SetHTTPCollector sets the HTTP stats collector (for API server)
func (c *Collector) SetHTTPCollector(httpCollector *HTTPStatsCollector) {
c.httpCollector = httpCollector
}
// SetAsynqInspector sets the Asynq inspector (for Worker)
func (c *Collector) SetAsynqInspector(inspector *asynq.Inspector) {
c.asynqClient = inspector
}
// Collect gathers all system statistics
func (c *Collector) Collect() SystemStats {
stats := SystemStats{
Timestamp: time.Now().UTC(),
Process: c.process,
}
// CPU stats
c.collectCPU(&stats)
// Memory stats (system + Go runtime)
c.collectMemory(&stats)
// Disk stats
c.collectDisk(&stats)
// Go runtime stats
c.collectRuntime(&stats)
// HTTP stats (API only)
if c.httpCollector != nil {
httpStats := c.httpCollector.GetStats()
stats.HTTP = &httpStats
}
// Asynq stats (Worker only)
if c.asynqClient != nil {
asynqStats := c.collectAsynq()
stats.Asynq = &asynqStats
}
return stats
}
func (c *Collector) collectCPU(stats *SystemStats) {
// Get CPU usage percentage (this blocks for ~100ms to sample)
if cpuPercent, err := cpu.Percent(100*time.Millisecond, false); err == nil && len(cpuPercent) > 0 {
stats.CPU.UsagePercent = cpuPercent[0]
}
stats.CPU.NumCPU = runtime.NumCPU()
// Load averages (Unix only, returns 0 on Windows)
if avg, err := load.Avg(); err == nil {
stats.CPU.LoadAvg1 = avg.Load1
stats.CPU.LoadAvg5 = avg.Load5
stats.CPU.LoadAvg15 = avg.Load15
}
}
func (c *Collector) collectMemory(stats *SystemStats) {
// System memory
if vmem, err := mem.VirtualMemory(); err == nil {
stats.Memory.UsedBytes = vmem.Used
stats.Memory.TotalBytes = vmem.Total
stats.Memory.UsagePercent = vmem.UsedPercent
}
// Go runtime memory
var m runtime.MemStats
runtime.ReadMemStats(&m)
stats.Memory.HeapAlloc = m.HeapAlloc
stats.Memory.HeapSys = m.HeapSys
stats.Memory.HeapInuse = m.HeapInuse
}
func (c *Collector) collectDisk(stats *SystemStats) {
// Root filesystem stats
if diskStat, err := disk.Usage("/"); err == nil {
stats.Disk.UsedBytes = diskStat.Used
stats.Disk.TotalBytes = diskStat.Total
stats.Disk.FreeBytes = diskStat.Free
stats.Disk.UsagePercent = diskStat.UsedPercent
}
}
func (c *Collector) collectRuntime(stats *SystemStats) {
var m runtime.MemStats
runtime.ReadMemStats(&m)
stats.Runtime.Goroutines = runtime.NumGoroutine()
stats.Runtime.NumGC = m.NumGC
if m.NumGC > 0 {
stats.Runtime.LastGCPause = m.PauseNs[(m.NumGC+255)%256]
}
stats.Runtime.Uptime = int64(time.Since(c.startTime).Seconds())
}
func (c *Collector) collectAsynq() AsynqStats {
stats := AsynqStats{
Queues: make(map[string]QueueStats),
}
if c.asynqClient == nil {
return stats
}
queues, err := c.asynqClient.Queues()
if err != nil {
log.Debug().Err(err).Msg("Failed to get asynq queues")
return stats
}
for _, qName := range queues {
info, err := c.asynqClient.GetQueueInfo(qName)
if err != nil {
log.Debug().Err(err).Str("queue", qName).Msg("Failed to get queue info")
continue
}
stats.Queues[qName] = QueueStats{
Pending: info.Pending,
Active: info.Active,
Scheduled: info.Scheduled,
Retry: info.Retry,
Archived: info.Archived,
Completed: info.Completed,
Failed: info.Failed,
}
}
return stats
}
// StartPublishing begins periodic stats collection and publishing to Redis
func (c *Collector) StartPublishing(interval time.Duration) {
go func() {
ticker := time.NewTicker(interval)
defer ticker.Stop()
// Collect immediately on start
c.publishStats()
for {
select {
case <-ticker.C:
c.publishStats()
case <-c.stopChan:
return
}
}
}()
}
func (c *Collector) publishStats() {
stats := c.Collect()
if err := c.statsStore.StoreStats(stats); err != nil {
log.Debug().Err(err).Str("process", c.process).Msg("Failed to publish stats to Redis")
}
}
// Stop stops the stats publishing
func (c *Collector) Stop() {
close(c.stopChan)
}