go应用应直接调用loki http api发日志，需构造含streams包裹、rfc3339nano时间戳、line字段的json或protobuf格式请求，避免硬嵌promtail；动态注入labels如job、pod名，调试时用/loki/api/v1/series验证series创建。
Go 应用怎么把日志直接发给 Loki（不用 Promtail）
可以直接用 loki-logfmt 或 promtail 的 client 库，但更轻量、更可控的方式是走 Loki 的 HTTP API。Loki 官方推荐的 Go 客户端是 github.com/grafana/loki/pkg/logproto，但它只提供 protobuf 结构，不带 HTTP 封装；实际发日志得自己拼 /loki/api/v1/push 请求。
常见错误是直接序列化 log lines 当作 JSON body 发过去——Loki 要的是压缩后的 Protobuf（或特定格式的 JSON 数组），且必须带 streams 包裹、每条 entry 必须有 ts（RFC3339 时间戳）和 line 字段。
- 用
log.New或zerolog/zap接自定义io.Writer，在 Write 时攒批、加时间戳、打包成 Loki 要的 JSON 格式 - 别用
time.Now().Unix()，必须用time.Now().UTC().Format(time.RFC3339Nano)，否则 Loki 拒收 - 单次 POST 的
streams最好不超过 10~20 条，太大容易超时或被 nginx 413 - 务必设
User-Agent: go-loki-client，某些 Loki 网关靠这个识别客户端做限流放行
为什么不该在 Go 里硬塞 Promtail 进程
Promtail 是独立二进制，设计目标是主机级日志采集（读文件、journal、syslog），不是嵌入 Go 进程的库。强行 fork + pipe + tail -f 日志文件，会引入三重问题：文件轮转竞争、进程生命周期不同步、错误信号难透传。
典型现象是：应用重启后 Promtail 丢几秒日志，或者 rotated file not found 报错持续刷屏。更麻烦的是，K8s 里一个 Pod 启多个容器时，Promtail 容器和 Go 应用容器之间得靠 emptyDir 共享路径，权限、挂载时机、symlink 处理全是坑。
立即学习“go语言免费学习笔记（深入）”；
- 除非你明确需要采集
/var/log/xxx.log这类外部文件，否则 Go 应用日志就该由 Go 自己发出去 - Promtail 的
scrape_configs里写static_configs+targets: ['localhost:3500']是无效的——它不支持 pull 模式，只支持 push 或文件监听 - 想复用 Promtail 的 label 提取能力？不如在 Go 里用
logfmt格式打日志，再用 Loki 的pipeline_stages解析，更稳定
用 zap 或 zerolog 打日志时怎么加 Loki 必需的 labels
Loki 靠 labels 做索引和查询，job 和 host 是基础，但 Go 应用启动时往往不知道 pod name 或 namespace。硬编码或从环境变量读容易漏、错、滞后。
正确做法是在日志写入前动态注入：zap 用 zap.Fields 注入全局字段，zerolog 用 logger.With().Str() 构建 root logger。关键是要把 labels 变成 logger 实例的“上下文”，而不是每次 Info() 都重复传。
-
job建议固定为服务名（如my-api），不要用os.Args[0]，后者在容器里常是/app -
host别用os.Hostname()，K8s 下返回的是 node 名，应优先取DOWNWARD_API_POD_NAME环境变量 - 避免在每条日志里塞
trace_id这种高基数 label——Loki 不擅长查高基数字段，改用 log 内容里写trace_id=xxx，再靠 pipeline 提取为临时字段 - 如果用了
zap.String("error", err.Error())，记得加zap.Error(err)替代——后者会自动展开 stack，且不会因err==nilpanic
本地调试时怎么确认日志真到了 Loki
最可靠的验证方式不是看 Grafana 是否显示，而是直连 Loki API 查 /loki/api/v1/series。很多问题卡在 label 不匹配导致 series 创建失败，结果日志静默消失。
比如你打了 job="my-api"，但 Loki 查询时写了 {job="my-api"} 却没结果，大概率是 label 没生效——可能因为推送的 JSON 里 stream 对象没包对，或 Prometheus remote_write 配置覆盖了你的 job 标签。
- curl -G "http://localhost:3100/loki/api/v1/series" --data-urlencode 'match[]={job="my-api"}' --data-urlencode 'start=1h' 看返回有没有 series ID
- 如果返回空数组，立刻检查你发的 POST body 里
streams[0].stream是否含{"job": "my-api"}，注意不是顶层字段 - 用
curl -v看响应头有没有X-Scope-OrgID，没有说明请求根本没进 Loki，可能被前面的 auth proxy 拦了 - 别依赖
loki-canary这类工具——它只测 endpoint 连通性，不验数据落盘
label 拼写、时间戳精度、JSON 嵌套层级，这三个地方出错，日志就等于没发出去。其他都好调，就这三处最容易反复折腾。
