17370845950

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 等注册到全局 promet

  

  heus.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。加这个环境变量可回退到更保守的内存归还策略。

• 该问题在内存限制严格（如 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，一个是空日志流），排查时容易分头撞墙。