Swagger 本身不提供日志功能,需借助框架或工具实现,Linux 下常用方案如下:
集成日志框架
logback-classic
依赖),通过 logback.xml
或 log4j2.xml
设置日志级别、输出格式及目标(文件/控制台)。nginx.conf
中配置 log_format
记录请求信息(如路径、状态码、响应时间),日志保存至 /var/log/nginx/
。系统日志管理
journalctl -u 服务名
查看日志,支持按时间、大小轮转。/etc/logrotate.d/
配置日志分割、压缩策略,例如保留 7 天日志并压缩旧文件。自定义日志记录
HandlerInterceptor
),记录请求/响应参数、状态码等。awk
/jq
处理日志文件,生成响应时间、错误率等统计报告。注意:需避免在日志中记录敏感信息(如 API 密钥),生产环境建议使用 INFO 级别,开发环境可启用 DEBUG。