accesslog.go RawHistoryFolder

1package out
2
3import "time"
4
5// AccessLogEntry represents a single HTTP access log record.
6// It is the neutral data contract between the access log middleware (adapters/in)
7// and the access log writer (adapters/out). Keeping it in the boundaries layer
8// prevents direct adapter-to-adapter coupling.
9type AccessLogEntry struct {
10	Time       time.Time
11	ClientIP   string
12	Method     string
13	Host       string
14	Path       string
15	Query      string
16	Status     int
17	BytesSent  int
18	DurationMS float64
19	UserAgent  string
20	Referer    string
21	RequestID  string
22	Proto      string
23}
24
25// AccessLogWriter writes HTTP access log entries to a configured sink.
26// *accesslog.Writer in internal/adapters/out/accesslog implements this interface.
27type AccessLogWriter interface {
28	Write(entry AccessLogEntry) error
29}
30
31// HealthCheckUserAgentPrefix is the User-Agent prefix set by Gordon's internal
32// health-check prober. Access log middleware uses this to filter out health-check
33// noise; the prober uses it to construct the full User-Agent string.
34const HealthCheckUserAgentPrefix = "Gordon-HealthCheck/"