go标准库log包无法直发loki，因其不支持loki所需的标签、rfc3339nano时间戳及streams封装格式，直接post会因格式错误返回400或401；必须用loki push api规范构造json请求体，或通过promtail采集结构化日志。
为什么直接用 log 包发日志到 Loki 行不通
Go 标准库的 log 包只支持写文件、控制台或自定义 io.Writer，它不理解 Loki 的日志模型：标签（labels）、时间戳（timestamp）、流（stream）结构。直接把日志字符串 POST 到 /loki/api/v1/push 会失败——Loki 要求的是特定格式的 JSON（含 streams 数组），且需带 X-Scope-OrgID 或认证头（取决于部署方式）。
常见错误现象：400 Bad Request 带 "invalid stream"；或 401 Unauthorized 却没配 Authorization 头；更隐蔽的是时区错乱导致日志时间戳倒序被 Loki 拒收。
- 必须用 Loki 的 Push API 格式构造请求体，不能拼接纯文本
- 时间戳必须是纳秒级 Unix 时间（不是
time.Now().Unix()，得用time.Now().UnixNano()） - 每个日志条目必须嵌套在
streams数组里，且stream字段是 map[string]string（如{"job": "api-server", "level": "error"}）
用 promtail + filelog 是最稳的落地方式
别自己手写 HTTP 客户端往 Loki 推日志——除非你有强定制需求（比如动态打标、加密日志体）。生产环境推荐让 Go 进程照常写本地文件（如 ./logs/app.log），再用 promtail 监控该文件并转发。这是官方推荐路径，稳定、低侵入、支持重试/背压/标签注入。
关键配置点（promtail-config.yaml）：
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
server:
http_listen_port: 9080
positions:
filename: /tmp/positions.yaml
clients:
- url: http://loki:3100/loki/api/v1/push
scrape_configs:
- job_name: app-logs
static_configs:
- targets: [localhost]
labels:
job: go-app
env: prod
pipeline_stages:
- filelog:
class: "go-app"
paths:
- /var/log/go-app/*.log
- labels:
level:
- json:
expressions:
level: level
msg: msg
-
filelog阶段必须指定paths，且 Go 进程要有读权限；容器中注意挂载路径一致 - 若日志是 JSON 格式（如用
zerolog输出），加json阶段能自动提取字段为标签，比正则更可靠 -
labels阶段可静态注入，但动态标签（如 trace_id）需用regex或template阶段，别硬塞进日志行里
真要直连 Loki？用 github.com/grafana/loki/client 简化封装
如果必须绕过文件、实时推（比如 CLI 工具或调试脚本），直接调用官方 client 库比裸写 HTTP 更安全。它自动处理序列化、时间戳、批量打包、重试逻辑。
最小可行示例：
import (
"context"
"time"
loki "github.com/grafana/loki/client"
"github.com/grafana/loki/client/promtail/api"
)
<p>client := loki.NewClient(loki.Config{
URL: &url.URL{Scheme: "http", Host: "loki:3100"},
})
entry := api.Entry{
Timestamp: time.Now(),
Line: "failed to connect to DB",
}
err := client.Push(context.Background(), api.Stream{
Stream: map[string]string{"job": "go-migration", "level": "error"},
Entries: []api.Entry{entry},
})
</p>
- 注意
Stream是单个标签集对应一批日志，不是每条日志都带全量标签（否则体积爆炸） - 客户端默认批量发送（100 条或 1s 触发），高吞吐场景下别频繁新建
Client实例 - 若 Loki 启用了 Basic Auth，需在
URL中填凭证：http://user:pass@loki:3100，或手动设RoundTripper
标签设计不当会导致查询爆炸和存储浪费
Loki 不是全文检索引擎，它是基于标签的索引系统。把高基数字段（如 request_id、user_id）当标签打进去，会让索引膨胀、查询变慢，甚至触发 too many streams 错误。
- 只把用于过滤/分组的低基数字段做标签：例如
job、level、env、host - 高基数字段（
trace_id,user_id）留在日志行内，用{job="go-app"} |= "trace_id=abc123"查询 - 避免用时间戳、毫秒级数字、UUID 做标签值；Loki 会为每个唯一标签组合建索引流
- 标签名别用点号（
.）或空格，Grafana 查询语法不友好，且部分版本解析异常
标签是 Loki 的命门，不是越多越好，是越准越省。上线前先用 count_over_time({job="go-app"}[1h]) 看流数量是否合理——几百个是常态，上万就得砍标签了。
