Golang HTTP接口日志记录与分析示例-Golang-PHP中文网

Golang HTTP接口日志记录与分析示例

P粉602998670

发布： 2025-10-09 10:02:02

原创

998人浏览过

答案：通过中间件记录HTTP请求日志并使用结构化日志库如zap输出JSON格式日志，便于后续分析。1. 使用自定义responseWriter捕获状态码；2. 在中间件中记录IP、方法、URI、状态码、耗时和User-Agent；3. 接入zap等库实现结构化日志；4. 利用grep、awk、jq等工具进行高频接口、错误请求、慢响应和IP访问量分析。

golang http接口日志记录与分析示例

在 Golang 中开发 HTTP 接口时，记录和分析请求日志是调试、监控和安全审计的重要手段。一个良好的日志系统能帮助你快速定位问题、了解用户行为，并为性能优化提供数据支持。下面通过一个简单但实用的示例，展示如何实现 HTTP 接口的日志记录与基本分析。

使用中间件记录 HTTP 请求日志

Go 的 http.Handler 支持中间件模式，我们可以通过封装 handler 来实现统一的日志记录。

以下是一个基础的日志中间件：

func loggingMiddleware(next http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        start := time.Now()

        // 记录原始信息
        ip := r.RemoteAddr
        method := r.Method
        uri := r.URL.RequestURI()
        userAgent := r.Header.Get("User-Agent")

        // 包装 ResponseWriter 以获取状态码
        rw := &responseWriter{ResponseWriter: w, statusCode: http.StatusOK}

        // 调用实际处理函数
        next.ServeHTTP(rw, r)

        // 日志输出
        log.Printf(
            "ip=%s method=%s uri=%s status=%d duration=%v user_agent=%q",
            ip, method, uri, rw.statusCode, time.Since(start), userAgent,
        )
    })
}

// 自定义 ResponseWriter 获取状态码
type responseWriter struct {
    http.ResponseWriter
    statusCode int
}

func (rw *responseWriter) WriteHeader(code int) {
    rw.statusCode = code
    rw.ResponseWriter.WriteHeader(code)
}

登录后复制

接入日志中间件到 HTTP 服务

将上述中间件应用到你的路由中，可以对所有请求进行统一记录。

立即学习“go语言免费学习笔记（深入）”；

func main() {
    mux := http.NewServeMux()

    mux.HandleFunc("/api/hello", func(w http.ResponseWriter, r *http.Request) {
        w.Header().Set("Content-Type", "application/json")
        w.WriteHeader(http.StatusOK)
        json.NewEncoder(w).Encode(map[string]string{
            "message": "Hello, World!",
        })
    })

    // 使用中间件包装 mux
    loggedMux := loggingMiddleware(mux)

    log.Println("Server starting on :8080...")
    http.ListenAndServe(":8080", loggedMux)
}

登录后复制

访问 /api/hello 后，控制台会输出类似：

芦笋演示

一键出成片的录屏演示软件，专为制作产品演示、教学课程和使用教程而设计。

查看详情

2025/04/05 10:00:00 ip=127.0.0.1:56789 method=GET uri=/api/hello status=200 duration=123.45µs user_agent="curl/7.68.0"

登录后复制

结构化日志与分析建议

默认的 log 包输出的是文本日志，不利于后续分析。推荐使用 zap 或 logrus 等支持结构化日志的库。

例如使用 zap：

import "go.uber.org/zap"

var logger *zap.Logger

func init() {
    var err error
    logger, err = zap.NewProduction()
    if err != nil {
        panic(err)
    }
}

// 在中间件中替换 log.Printf 为：
logger.Info("http_request",
    zap.String("ip", ip),
    zap.String("method", method),
    zap.String("uri", uri),
    zap.Int("status", rw.statusCode),
    zap.Duration("duration", time.Since(start)),
    zap.String("user_agent", userAgent),
)

登录后复制

输出将是 JSON 格式，便于被 ELK、Loki 等系统采集和查询。

简单日志分析技巧

有了结构化日志后，你可以进行一些基础分析：

统计高频接口：grep '"uri":"/api/' logs.json | awk '{print $8}' | sort | uniq -c | sort -nr
查看错误请求：grep '"status":5' logs.json
分析响应慢的请求：jq 'select(.duration > 1)' logs.json
按 IP 统计访问量：grep '"ip"' logs.json | awk '{print $6}' | sort | uniq -c

基本上就这些。通过中间件记录日志，再配合结构化输出，就能为 Go 服务构建一个轻量但有效的日志体系。不复杂但容易忽略。

以上就是Golang HTTP接口日志记录与分析示例的详细内容，更多请关注php中文网其它相关文章！