Golang服务监控与健康检查指南

通过实现健康检查接口、集成Prometheus监控、使用中间件收集数据及与Kubernetes探针联动，可构建完整的Golang微服务监控体系，保障系统稳定性。

在构建 Golang 微服务时，服务监控与健康检查是保障系统稳定运行的关键环节。它们帮助开发者及时发现服务异常、评估系统负载，并为自动化运维（如 Kubernetes 自愈）提供决策依据。下面从几个核心方面介绍如何在 Golang 项目中实现有效的监控与健康检查。

1. 健康检查接口（Health Check Endpoint）

一个标准的健康检查通常通过暴露 /healthz 或 /health HTTP 接口来实现，返回服务当前是否正常。

你可以使用 Go 的 net/http 包快速实现：

package main

import (
    "encoding/json"
    "net/http"
)

func healthHandler(w http.ResponseWriter, r *http.Request) {
    // 可在此加入数据库连接、缓存、依赖服务等检查
    data := map[string]string{
        "status": "ok",
        "service": "user-service",
    }
    w.Header().Set("Content-Type", "application/json")
    json.NewEncoder(w).Encode(data)
}

func main() {
    http.HandleFunc("/healthz", healthHandler)
    http.ListenAndServe(":8080", nil)
}

如果服务依赖数据库或 Redis，可以在检查中加入这些组件的状态判断，失败时返回 500 状态码。

2. 集成 Prometheus 进行指标监控

Prometheus 是微服务架构中最常用的监控系统。Golang 官方提供了 prometheus/client_golang 库支持指标采集。

步骤如下：

• 引入依赖：go get github.com/prometheus/client_golang/prometheus/promhttp
• 暴露指标接口，通常为 /metrics
• 注册自定义或内置指标（如请求计数、响应时间）

示例代码：

import (
    "net/http"
    "github.com/prometheus/client_golang/prometheus"
    "github.com/prometheus/client_golang/prometheus/promhttp"
)

var requestCounter = prometheus.NewCounter(
    prometheus.CounterOpts{
        Name: "http_requests_total",
        Help: "Total number of HTTP requests",
    },
)

func init() {
    prometheus.MustRegister(requestCounter)
}

func handler(w http.ResponseWriter, r *http.Request) {
    requestCounter.Inc()
    w.Write([]byte("Hello"))
}

func main() {
    http.Handle("/metrics", promhttp.Handler())
    http.HandleFunc("/", handler)
    http.ListenAndServe(":8080", nil)
}

启动后访问 :8080/metrics 即可看到指标数据，Prometheus 可配置 scrape_job 定期抓取。

3. 使用中间件收集监控数据

为了自动记录请求延迟、状态码等信息，可以编写 HTTP 中间件。

例如记录请求耗时：

func metricsMiddleware(next http.HandlerFunc) http.HandlerFunc {
    return func(w http.ResponseWriter, r *http.Request) {
        start := time.Now()
        next.ServeHTTP(w, r)
        duration := time.Since(start).Seconds()
        // 可将 duration 记录到 Prometheus histogram
        log.Printf("%s %s %v", r.Method, r.URL.Path, duration)
    }
}

将中间件应用到关键路由，即可实现无侵入式监控。

4. 与 Kubernetes 集成实现自动恢复

Kubernetes 通过 liveness 和 readiness 探针调用健康接口，决定是否重启或转发流量。

在 Deployment 中配置：

livenessProbe:
  httpGet:
    path: /healthz
    port: 8080
  initialDelaySeconds: 10
  periodSeconds: 10

readinessProbe:
  httpGet:
    path: /healthz
    port: 8080
  initialDelaySeconds: 5
  periodSeconds: 5

liveness 用于判断是否重启容器，readiness 用于控制是否接入流量。

基本上就这些。通过暴露健康接口、集成 Prometheus 指标、使用中间件增强可观测性，并结合 Kubernetes 探针，就能构建一套完整的 Golang 服务监控体系。不复杂但容易忽略细节，比如探针超时设置或指标命名规范，建议统一团队实践。