https://speedle.io/zh/tags/logging/ Recent content in Logging on Speedle Hugo -- gohugo.io zh-cn https://speedle.io/zh/docs/logging/ Mon, 01 Jan 0001 00:00:00 +0000 https://speedle.io/zh/docs/logging/ 概述 Speedle 使用了下面两个开源项目来处理日志, 1. https://github.com/sirupsen/logrus 2. https://github.com/natefinch/lumberjack Logrus 是一个针对 go 语言的结构化的日志处理器，它与 go 语言标准的 logger 库完全 API 兼容。因为 logrus 不支持对日志循环滚动处理（rotation），所以我们引入了另外一个开源项目 lumberjack。Logrus 与 lumberjack 之间通过 io.Writer 接口交互，如下图所示, 日志配置 可以通过两种方式对 Speedle 的日志模块进行配置，即命令行参数或者配置文件。 通过命令行参数配置日志 所有的命令行参数如下所示。前两个参数供 logrus 使用，其它的参数则是为 lumberjack 准备的。 --log-level string --log-formatter string --log-reportcaller bool --log-filename string --log-maxsize int --log-maxbackups int --log-maxage int --log-localtime bool --log-compress bool 上面每一个参数的详细信息包含在下面的表格中。所有的参数都收可选的。 如果所有参数都没有配置，那么日志消息默认会输出到标准错误输出（stderr），而且默认的日志级别是 info。 配置项 描述 默认值 –log-level 日志级别, 有效的日志级别包括：panic、fatal、error、warn、info、debug info –log-formatter 日志格式, 有效的日志格式包括：text、json text –log-reportcaller 用于控制是否将调用信息 (文件名, 行数和函数名)包含在日志消息中 false –log-filename 日志文件名 没有默认值。 如果没有配置，那么日志消息默认会输出到标准错误输出（stderr） –log-maxsize 每个日志文件的最大尺寸。 注意该参数只有在”–log-filename”已经配置的情况下才有效 100M –log-maxbackups 历史日志文件保留的最大数量。 注意该参数只有在”–log-filename”已经配置的情况下才有效 0, 保留所有历史日志文件（注意历史日志文件可能由于达到了 maxAge 设定的时间限制而被删除） –log-maxage 历史日志文件保留的最多天数。注意该参数只有在”–log-filename”已经配置的情况下才有效 0, 不删除任何历史日志文件（注意历史日志文件可能由于达到了 maxbackups 的限制而被删除） –log-localtime 用于控制在生成滚动日志文件时是否使用本地时间。注意该参数只有在”–log-filename”已经配置的情况下才有效 false, 使用 UTC 时间 –log-compress 用于控制在生成滚动日志文件时是否需要压缩。注意该参数只有在”–log-filename”已经配置的情况下才有效 false, 不压缩 下面是两个日志消息的示例，第一个使用 text 格式输出，第二个则是使用 json 格式输出，