Go应用容器化需暴露Prometheus指标并输出stdout日志：用promhttp.Handler挂载/metrics，禁用文件日志，设ENV GODEBUG=madvdontneed=1防OOM，探针与指标路径对齐。
Go 应用容器化后，监控不能只靠 docker stats 或宿主机指标——你需要从应用内部暴露可被 Prometheus 抓取的指标，并让日志能被统一采集（如通过 stdout 流式输出）。否则，指标断层、日志丢失、告警失灵是常态。
用 promhttp 暴露 Go 应用的 Prometheus 指标
Go 生态最轻量、最标准的方式是用 prometheus/client_golang 提供的 promhttp.Handler()。它不侵入业务逻辑，只需在 HTTP 服务中挂载一个路由即可。
- 必须将指标端点（如
/metrics）注册到 HTTP mux 中，且路径不能带重定向或中间件拦截（否则 Prometheus 抓取会失败） - 避免在
Handler()前加身份验证——Kubernetes Service 或 Ingress 层做访问控制更合理 - 自定义指标（如请求计数、延迟直方图）要用
prometheus.NewCounterVec等注册到全局prometheus.DefaultRegisterer，否则不会出现在/metrics输出里
package main
import (
"log"
"net/http"
"github.com/prometheus/client_golang/prometheus"
"github.com/prometheus/client_golang/prometheus/promhttp"
)
var (
httpRequests = prometheus.NewCounterVec(
prometheus.CounterOpts{
Name: "http_requests_total",
Help: "Total number of HTTP requests",
},
[]string{"method", "status"},
)
)
func init() {
prometheus.MustRegister(httpRequests)
}
func handler(w http.ResponseWriter, r *http.Request) {
httpRequests.WithLabelValues(r.Method, "200").Inc()
w.WriteHeader(200)
w.Write([]byte("OK"))
}
func main() {
http.HandleFunc("/", handler)
http.Handle("/metrics", promhttp.Handler()) // 注意：直接挂载，不包装
log.Println("Server starting on :8080")
log.Fatal(http.ListenAndServe(":8080", nil))
}
容器内日志必须走 os.Stdout，禁用文件写入
Kubernetes 和大多数日志采集器（Fluentd、Filebeat、Loki 的 Promtail）只监听容器的 stdout 和 stderr。任何写本地文件（如 logrus.SetOutput(os.OpenFile(...))）的行为都会导致日志不可见。
- 用
log.SetOutput(os.Stdout)或logrus.SetOutput(os.Stdout)替代文件句柄 - 结构化日志推荐用
zerolog或logrus，并确保时间字段为 RFC3339 格式（time.RFC3339），方便 Loki / Grafana 解析 - 禁止在日志内容中混入 ANSI 颜色码（如
\x1b[32m），某些采集器会截断或解析失败
Dockerfile 中要显式设置 ENV GODEBUG=madvdontneed=1
Go 1.19+ 默认使用 madvise(MADV_DONTNEED) 释放内存，但在容器中常被 cgroup v1 或低版本内核误判为“内存泄漏”，触发 OOMKilled。加这个环境变量可回退到更保守的内存归还策略。
立即学习“go语言免费学习笔记（深入）”；
- 该问题在内存限制严格（如
memory: 128Mi）、高并发短连接场景下高频出现 - 仅影响 Linux 容器，Windows/macOS Docker Desktop 不需要
- 不是性能优化项，而是稳定性兜底——不加可能导致 Pod 频繁重启，但监控指标本身看不出异常
FROM golang:1.22-alpine AS builder WORKDIR /app COPY . . RUN go build -o app . FROM alpine:latest RUN apk --no-cache add ca-certificates WORKDIR /root/ COPY --from=builder /app/app . ENV GODEBUG=madvdontneed=1 EXPOSE 8080 CMD ["./app"]
监控探针路径必须与健康检查对齐
Kubernetes 的 livenessProbe 和 readinessProbe 如果指向非指标路径（比如 /healthz），而 Prometheus 却只配置抓 /metrics，就会造成「Pod 一直存活，但指标长期中断」的假象。
- 建议复用同一 HTTP handler：/healthz 返回 200，/metrics 返回指标，二者共用底层健康逻辑（如 DB 连接检测）
- 不要让
/metrics包含耗时操作（如实时查 Redis），否则 Prometheus 抓取超时会反复重试，反而压垮应用 - 若用
promhttp.HandlerFor自定义 registry，请确认它没启用EnableOpenMetrics（旧版客户端默认关，新版可能开），否则格式不兼容旧版 Prometheus
最容易被忽略的是：指标暴露和日志输出看似独立，实则共享同一个约束——它们都依赖容器运行时对 stdout/stderr 和 HTTP 端口的透传能力。一旦在 K8s 中配错 securityContext（如禁用网络或重定向 stdout），两者会同时失效，但错误现象完全不同（一个是 503，一个是空日志流），排查时容易分头撞墙。
