Files
monlet/agent/internal/app/app.go
Stanislav Rossovskii d6f9335398
Some checks failed
ci / openapi (push) Failing after 7s
ci / agent (push) Failing after 5s
ci / server (push) Failing after 6s
ci / stack-smoke (push) Has been skipped
ci / web (push) Failing after 5s
Add cron schedules and sync docs
2026-06-23 19:18:01 +04:00

356 lines
9.1 KiB
Go

package app
import (
"context"
"errors"
"fmt"
"log/slog"
"sync"
"time"
"github.com/monlet/agent/internal/client"
"github.com/monlet/agent/internal/config"
"github.com/monlet/agent/internal/metrics"
"github.com/monlet/agent/internal/scheduler"
"github.com/monlet/agent/internal/spool"
)
type App struct {
Cfg *config.Config
AgentID string
Version string
Client *client.Client
Spool *spool.Spool
Metrics *metrics.Metrics
Log *slog.Logger
lastDropLog time.Time
cfgMu sync.RWMutex
schedulerMu sync.RWMutex
scheduler *scheduler.Manager
}
const (
dropReasonOverflowEvents = "spool_overflow_events"
dropReasonOverflowBytes = "spool_overflow_bytes"
dropReasonSendRejected = "send_non_retryable"
dropLogThrottle = 30 * time.Second
)
func (a *App) Run(ctx context.Context) error {
events := make(chan scheduler.Event, 256)
cfg := a.config()
// Account drops accumulated during spool Open (e.g. shrunk limits on restart).
a.recordSpoolDrops(a.Spool.Drops())
a.Metrics.ConfigLoadSuccess.Set(1)
a.Metrics.ChecksConfigured.Set(float64(len(cfg.Checks)))
a.Metrics.BuildInfo.WithLabelValues(a.Version, boolLabel(cfg.PushesToServer()), boolLabel(cfg.ExposesMetrics())).Set(1)
a.recordCheckScheduleMetrics(cfg.Checks)
var wg sync.WaitGroup
if cfg.ExposesMetrics() {
wg.Add(1)
go func() {
defer wg.Done()
if err := a.Metrics.Serve(ctx, cfg.Metrics.Listen); err != nil {
a.Log.Error("metrics server", "err", err)
}
}()
}
mgr := scheduler.NewManager(ctx, a.AgentID, events, scheduler.Hooks{
OnSkipped: func(id string) { a.Metrics.CheckSkipped.WithLabelValues(id).Inc() },
OnResult: func(ev scheduler.Event) {
a.Metrics.CheckRuns.WithLabelValues(ev.CheckID, ev.Status).Inc()
a.Metrics.CheckDuration.WithLabelValues(ev.CheckID).Observe(float64(ev.DurationMs) / 1000.0)
a.Metrics.CheckStatus.WithLabelValues(ev.CheckID).Set(metrics.StatusCode(ev.Status))
a.Metrics.CheckExitCode.WithLabelValues(ev.CheckID).Set(float64(ev.ExitCode))
ts := float64(ev.ObservedAt.Unix())
a.Metrics.CheckLastRun.WithLabelValues(ev.CheckID).Set(ts)
if ev.Status == "ok" {
a.Metrics.CheckLastSuccess.WithLabelValues(ev.CheckID).Set(ts)
}
},
OnEventChannelFull: func() { a.Metrics.EventsChannelFull.Inc() },
OnResourceLimitFailure: func(id string, resource string) {
a.Metrics.ResourceLimitApplyFailures.WithLabelValues(id, resource).Inc()
},
OnStopped: func(id string) { a.Metrics.DeleteCheck(id) },
})
mgr.Update(cfg.Checks)
a.schedulerMu.Lock()
a.scheduler = mgr
a.schedulerMu.Unlock()
wg.Add(1)
go func() {
defer wg.Done()
<-ctx.Done()
mgr.Stop()
mgr.Wait()
}()
if cfg.PushesToServer() {
wg.Add(1)
go func() {
defer wg.Done()
a.spoolWriter(ctx, events)
}()
wg.Add(1)
go func() {
defer wg.Done()
a.heartbeatLoop(ctx)
}()
wg.Add(1)
go func() {
defer wg.Done()
a.sendLoop(ctx)
}()
} else {
// drain scheduler events to avoid blocking it
wg.Add(1)
go func() {
defer wg.Done()
for {
select {
case <-ctx.Done():
return
case <-events:
}
}
}()
}
wg.Wait()
return nil
}
func (a *App) spoolWriter(ctx context.Context, events <-chan scheduler.Event) {
for {
select {
case <-ctx.Done():
return
case ev := <-events:
if err := a.Spool.Enqueue(ev); err != nil {
a.Log.Error("spool enqueue", "err", err)
}
a.recordSpoolDrops(a.Spool.Drops())
a.Metrics.SpoolDepth.Set(float64(a.Spool.Len()))
a.Metrics.SpoolBytes.Set(float64(a.Spool.Bytes()))
}
}
}
func (a *App) heartbeatLoop(ctx context.Context) {
attempt := 0
for {
cfg := a.config()
interval := cfg.Server.HeartbeatInterval.Duration
hb := client.HeartbeatRequest{
AgentID: a.AgentID,
ObservedAt: time.Now().UTC(),
Hostname: cfg.Hostname,
Features: client.AgentFeatures{
Push: cfg.PushesToServer(),
Metrics: cfg.ExposesMetrics(),
},
Labels: cfg.HeartbeatLabels(a.Version),
}
a.Metrics.SendAttempts.WithLabelValues("heartbeat").Inc()
err := a.Client.SendHeartbeat(ctx, hb)
if err != nil {
a.Metrics.SendFailures.WithLabelValues("heartbeat").Inc()
if errors.Is(err, context.Canceled) {
return
}
a.Log.Warn("heartbeat send failed", "err", err)
if client.Retryable(err) {
attempt++
if sleep(ctx, client.Delay(attempt)) {
return
}
continue
}
} else {
a.Metrics.LastHeartbeat.Set(float64(time.Now().Unix()))
}
attempt = 0
if sleep(ctx, interval) {
return
}
}
}
func (a *App) sendLoop(ctx context.Context) {
attempt := 0
for {
select {
case <-ctx.Done():
return
default:
}
interval := a.config().Server.BatchInterval.Duration
items, err := a.Spool.Peek(client.MaxBatchEvents)
if err != nil {
a.Log.Error("spool peek", "err", err)
}
if len(items) == 0 {
if sleep(ctx, interval) {
return
}
continue
}
evs := make([]scheduler.Event, len(items))
seqs := make([]uint64, len(items))
for i, it := range items {
evs[i] = it.Event
seqs[i] = it.Seq
}
a.Metrics.SendAttempts.WithLabelValues("events").Inc()
resp, err := a.Client.SendEvents(ctx, evs)
if err != nil {
a.Metrics.SendFailures.WithLabelValues("events").Inc()
if errors.Is(err, context.Canceled) {
return
}
a.Log.Warn("events send failed", "err", err)
if client.Retryable(err) {
attempt++
if sleep(ctx, client.Delay(attempt)) {
return
}
continue
}
// non-retryable: drop to avoid hot loop.
a.Metrics.EventsDropped.WithLabelValues(dropReasonSendRejected).Add(float64(len(seqs)))
a.Log.Warn("events dropped: server rejected batch", "count", len(seqs), "reason", dropReasonSendRejected)
a.Spool.Commit(seqs)
attempt = 0
continue
}
attempt = 0
a.Spool.Commit(seqs)
a.Metrics.EventsAccepted.Add(float64(resp.Accepted))
a.Metrics.EventsDedup.Add(float64(resp.Deduplicated))
a.Metrics.SpoolDepth.Set(float64(a.Spool.Len()))
a.Metrics.SpoolBytes.Set(float64(a.Spool.Bytes()))
}
}
// Reload applies a validated hot-reload config if immutable fields match.
func (a *App) Reload(newCfg *config.Config, newAgentID string) error {
oldCfg := a.config()
if err := validateReload(oldCfg, newCfg, a.AgentID, newAgentID); err != nil {
a.RecordReloadFailure()
return err
}
a.cfgMu.Lock()
a.Cfg = newCfg
a.cfgMu.Unlock()
a.Metrics.ConfigLoadSuccess.Set(1)
a.Metrics.ConfigReloadTotal.WithLabelValues("success").Inc()
a.Metrics.ConfigLastReloadSuccess.Set(float64(time.Now().Unix()))
a.Metrics.ChecksConfigured.Set(float64(len(newCfg.Checks)))
a.recordCheckScheduleMetrics(newCfg.Checks)
a.schedulerMu.RLock()
mgr := a.scheduler
a.schedulerMu.RUnlock()
if mgr != nil {
mgr.Update(newCfg.Checks)
}
return nil
}
// RecordReloadFailure updates config reload metrics after a failed reload attempt.
func (a *App) RecordReloadFailure() {
a.Metrics.ConfigLoadSuccess.Set(0)
a.Metrics.ConfigReloadTotal.WithLabelValues("failure").Inc()
}
func (a *App) recordCheckScheduleMetrics(checks []config.CheckConfig) {
for _, c := range checks {
if c.UsesInterval() {
a.Metrics.CheckInterval.WithLabelValues(c.ID).Set(c.Interval.Duration.Seconds())
} else {
a.Metrics.CheckInterval.DeleteLabelValues(c.ID)
}
}
}
func (a *App) config() *config.Config {
a.cfgMu.RLock()
defer a.cfgMu.RUnlock()
return a.Cfg
}
func validateReload(oldCfg, newCfg *config.Config, oldAgentID, newAgentID string) error {
if oldAgentID != newAgentID {
return fmt.Errorf("agent_id change requires restart")
}
if oldCfg.StateDir != newCfg.StateDir {
return fmt.Errorf("state_dir change requires restart")
}
if oldCfg.PushesToServer() != newCfg.PushesToServer() {
return fmt.Errorf("server.enabled change requires restart")
}
if oldCfg.Server.URL != newCfg.Server.URL {
return fmt.Errorf("server.url change requires restart")
}
if oldCfg.Server.HeartbeatInterval.Duration != newCfg.Server.HeartbeatInterval.Duration {
return fmt.Errorf("server.heartbeat_interval change requires restart")
}
if oldCfg.Server.BatchInterval.Duration != newCfg.Server.BatchInterval.Duration {
return fmt.Errorf("server.batch_interval change requires restart")
}
if oldCfg.ExposesMetrics() != newCfg.ExposesMetrics() {
return fmt.Errorf("metrics.enabled change requires restart")
}
if oldCfg.Metrics.Listen != newCfg.Metrics.Listen {
return fmt.Errorf("metrics.listen change requires restart")
}
return nil
}
// sleep returns true if context was cancelled while waiting.
func sleep(ctx context.Context, d time.Duration) bool {
t := time.NewTimer(d)
defer t.Stop()
select {
case <-ctx.Done():
return true
case <-t.C:
return false
}
}
func (a *App) recordSpoolDrops(d spool.DropStats) {
if d.OverflowEvents == 0 && d.OverflowBytes == 0 {
return
}
if d.OverflowEvents > 0 {
a.Metrics.EventsDropped.WithLabelValues(dropReasonOverflowEvents).Add(float64(d.OverflowEvents))
}
if d.OverflowBytes > 0 {
a.Metrics.EventsDropped.WithLabelValues(dropReasonOverflowBytes).Add(float64(d.OverflowBytes))
}
now := time.Now()
if now.Sub(a.lastDropLog) >= dropLogThrottle {
a.Log.Warn("spool drops",
"events_overflow", d.OverflowEvents,
"bytes_overflow", d.OverflowBytes,
)
a.lastDropLog = now
}
}
func boolLabel(v bool) string {
if v {
return "true"
}
return "false"
}