logs.go RawHistoryFolder

1package domain
2
3import "time"
4
5// LogSource identifies the workload that emitted a log record.
6// A zero LogSource is Gordon itself.
7type LogSource struct {
8	App     string
9	Service string
10}
11
12// IsGordon reports whether the record belongs to Gordon itself.
13func (s LogSource) IsGordon() bool {
14	return s.App == ""
15}
16
17// ServiceName is the unique exported service name, "<app>.<service>".
18// Service names alone collide across apps (many apps have "web").
19func (s LogSource) ServiceName() string {
20	if s.IsGordon() {
21		return "gordon"
22	}
23	return s.App + "." + s.Service
24}
25
26// Log stream names for container output.
27const (
28	LogStreamStdout = "stdout"
29	LogStreamStderr = "stderr"
30)
31
32// Log types distinguish record families sharing one source.
33const (
34	LogTypeContainer = "container"
35	LogTypeAccess    = "access"
36)
37
38// LogSeverity is a coarse, exporter-neutral severity.
39type LogSeverity int
40
41// Severities. The zero value means unspecified.
42const (
43	LogSeverityUnspecified LogSeverity = iota
44	LogSeverityInfo
45	LogSeverityWarn
46	LogSeverityError
47)
48
49// ContainerLogLine is one demultiplexed line of container output.
50type ContainerLogLine struct {
51	Time   time.Time
52	Stream string
53	Body   string
54}
55
56// LogRecord is one exported log record.
57type LogRecord struct {
58	Time     time.Time
59	Source   LogSource
60	Type     string
61	Severity LogSeverity
62	Body     string
63	// Stream is stdout or stderr for container output, empty otherwise.
64	Stream string
65	// Attributes carry per-record metadata (status, path...).
66	Attributes map[string]string
67}