Core Concepts

Core Concepts

Overview

Core entities:

• Channel
• Subsystem (SID)
• Backend
• Context

---

Channel

Primary logging entity.

• has level
• can be enabled/disabled
• routes to backends

---

Subsystem (SID)

Additional classification tag.

• used for filtering
• not enabled/disabled directly

---

Backend

Defines where logs go.

• console
• file
• debug

Supports:

• async
• format (text/json/xml)

---

Context

Internal representation of a log message.

Contains:

• message
• metadata
• structured fields

---

Message Flow

1. log call
2. channel check
3. context creation
4. formatting
5. backend dispatch

---

Principles

• minimal overhead when disabled
• runtime control
• separation of concerns