为什么使用结构化日志
机器可读的日志记录
为什么使用结构化日志 是 CoddyKit 上的免费 Go Academy 课时。 这是第 1 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Go Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Go Academy 课程共包含 4 节课。
机器可以读取的日志
传统日志是自由格式的字符串："user 42 logged in from 1.2.3.4"。它们便于人类阅读，但机器查询起来很困难。结构化日志记录会输出键值对，让日志聚合器能够可靠地进行筛选和聚合。
字符串日志的问题
解析自由文本很脆弱：
- 格式会随着时间推移而变化
- 正则表达式会在边界情况下失效
- 您无法轻松查询“所有 userID=42 的事件”
结构化日志会让每个字段都成为一等的、可查询的属性。
slog 位于标准库中
从 Go 1.21 开始，结构化日志记录位于标准库的 log/slog 包中。无需外部依赖。
import "log/slog"您的第一条结构化日志
最简单的调用会记录一条消息以及键值属性：
package main
import "log/slog"
func main() {
slog.Info("user logged in", "userID", 42, "ip", "1.2.3.4")
}读取输出
默认处理程序会输出类似下面的内容：
2009/11/10 23:00:00 INFO user logged in userID=42 ip=1.2.3.4
每个属性都是一个独立的 key=value 对，可直接供机器解析。
内置日志级别
slog 提供四个级别：Debug、Info、Warn、Error。每个级别都接收一条消息以及交替传入的键值属性。
slog.Warn("disk almost full", "freePct", 5)
slog.Error("db connection failed", "attempt", 3)键值对
属性以交替参数的形式传入：键、值、键、值。如果有一个多余的奇数位置参数，日志会使用特殊的 !BADKEY 标记记录它，因此请确保参数成对出现。
slog.Info("order placed", "orderID", 1001, "total", 49.99)用于生产环境的 JSON
在生产环境中，您通常会输出 JSON，以便日志采集器（Loki、ELK、CloudWatch）自动为字段建立索引。slog 提供了专门的 JSON 处理程序，下一课将介绍它。
与旧版 log 包比较
经典的 log 包只能打印字符串。slog 保持了熟悉的使用方式，同时增加了结构化数据、日志级别和可插拔的处理程序，而无需一次性改动整个代码库。
结构化日志何时最有价值
结构化日志在以下情况下最有价值：
- 您需要集中来自多个服务的日志
- 您要基于字段构建仪表板和告警
- 您需要通过 ID 关联请求
可运行：结构化输出
运行这段代码，查看默认输出中的结构化属性。
package main
import "log/slog"
func main() {
slog.Info("request handled",
"method", "GET",
"path", "/health",
"status", 200,
"ms", 12,
)
}快速检查
请测试您对结构化日志记录的理解。
回顾
您已了解结构化日志的重要性：
- 键值属性可供机器查询
log/slog位于标准库中（Go 1.21 及更高版本）- 内置级别：Debug、Info、Warn、Error
- 以交替的键、值对形式传入属性
下一步：选择文本处理程序还是 JSON 处理程序。
常见问题解答
「为什么使用结构化日志」课时是免费的吗？
是的 — 「为什么使用结构化日志」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Go Academy 课程的其余内容，请升级到 CoddyKit PRO。 Go Academy 课程共包含 4 节课。
「为什么使用结构化日志」这节课中我会学到什么？
机器可读的日志记录 你通过在浏览器中直接运行的动手代码来练习 Go Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 Go Academy 需要有经验吗？
无需任何先前经验。CoddyKit 上的 Go Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 1 节课，共 4 节。
「为什么使用结构化日志」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 Go Academy 课中编写并运行代码吗？
能。每节 Go Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。