编辑“︁Gin日志系统”︁（章节）

= Gin日志系统 =

Gin框架的日志系统是开发者监控HTTP请求、调试应用程序和记录运行时信息的重要工具。本条目将详细介绍Gin的默认日志机制、自定义配置方法以及实际应用场景。

== 概述 ==
Gin使用内置的`gin.DefaultWriter`和`gin.DefaultErrorWriter`分别处理常规日志和错误日志，默认输出到`os.Stdout`。日志格式遵循Apache组合日志格式（Combined Log Format），包含以下字段：
* 客户端IP
* 时间戳
* HTTP方法
* 请求路径
* 协议版本
* 状态码
* 响应时间
* 用户代理

== 基础配置 ==
=== 默认日志示例 ===
<syntaxhighlight lang="go">
package main

import "github.com/gin-gonic/gin"

func main() {
    r := gin.Default() // 包含默认日志中间件
    r.GET("/ping", func(c *gin.Context) {
        c.String(200, "pong")
    })
    r.Run(":8080")
}
</syntaxhighlight>

请求`GET /ping`会产生如下日志：
<pre>
[GIN] 2023/07/15 - 10:00:00 | 200 |     1.2ms |        ::1 | GET     "/ping"
</pre>

=== 禁用日志 ===
<syntaxhighlight lang="go">
r := gin.New() // 不加载默认中间件
</syntaxhighlight>

== 自定义日志 ==
=== 修改输出目标 ===
<syntaxhighlight lang="go">
f, _ := os.Create("gin.log")
gin.DefaultWriter = io.MultiWriter(f, os.Stdout)
</syntaxhighlight>

=== 自定义日志格式 ===
使用`LoggerWithFormatter`中间件：
<syntaxhighlight lang="go">
r.Use(gin.LoggerWithFormatter(func(param gin.LogFormatterParams) string {
    return fmt.Sprintf("%s - [%s] \"%s %s\" %d %s\n",
        param.ClientIP,
        param.TimeStamp.Format(time.RFC1123),
        param.Method,
        param.Path,
        param.StatusCode,
        param.Latency,
    )
}))
</syntaxhighlight>

== 日志级别控制 ==
Gin支持通过环境变量控制日志级别：
<syntaxhighlight lang="bash">
export GIN_MODE=release  # 禁用调试日志
export GIN_MODE=debug    # 显示彩色日志（默认）
</syntaxhighlight>

== 高级应用 ==
=== 结构化日志 ===
集成Logrus等第三方库：
<syntaxhighlight lang="go">
import "github.com/sirupsen/logrus"

func setupLogrus() {
    log := logrus.New()
    gin.DefaultWriter = log.Writer()
    log.SetFormatter(&logrus.JSONFormatter{})
}
</syntaxhighlight>

=== 性能优化 ===
使用缓冲写入提高性能：
<syntaxhighlight lang="go">
buf := &bytes.Buffer{}
gin.DefaultWriter = io.MultiWriter(buf, os.Stdout)
</syntaxhighlight>

== 日志分析案例 ==
<mermaid>
pie
    title HTTP状态码分布
    "2xx" : 75
    "4xx" : 15
    "5xx" : 10
</mermaid>

数学公式示例（请求成功率计算）：
<math>
Success\ Rate = \frac{\sum{2xx}}{\sum{All\ Requests}} \times 100\%
</math>

== 最佳实践 ==
1. 生产环境应将日志写入文件并设置轮转
2. 敏感信息（如Authorization头）应过滤
3. 高并发场景建议使用异步日志
4. 结合监控系统（如Prometheus）实现实时告警

== 参见 ==
* Gin中间件机制
* Go标准库log包
* 分布式日志收集系统（ELK）

[[Category:后端框架]]
[[Category:Gin]]
[[Category:Gin基础]]