centos swagger监控与日志

CentOS下Swagger监控与日志管理指南

一、日志管理：配置与优化

1. 日志收集基础

Swagger本身不直接处理日志，需通过底层应用框架（如Spring Boot）或系统服务记录。日志通常存储在以下位置：

系统通用日志：/var/log/messages（含系统级Swagger服务日志）；
应用特定日志：如Spring Boot项目的logs/目录（需在应用配置中指定路径）；
Systemd服务日志：若Swagger以systemd服务运行（如swagger-editor），可通过journalctl查看。

2. 日志级别调整

通过应用日志框架控制日志详细程度（以Logback为例）：

编辑logback.xml（位于src/main/resources/），设置日志级别（DEBUG/INFO/WARN/ERROR）和输出目标（控制台/文件）。例如：

<configuration>
  <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
    <encoder>
      <pattern>%d{yyyy-MM-dd HH:mm:ss} %-5level %logger{36} - %msg%n</pattern>
    </encoder>
  </appender>
  <root level="INFO">
    <appender-ref ref="CONSOLE"/>
  </root>
</configuration>

Spring Boot项目还可通过application.properties快速配置：
```
logging.level.root=INFO
logging.file.name=logs/swagger.log
```

3. 日志轮转管理

使用logrotate工具防止日志文件过大，节省磁盘空间：

安装logrotate（若未安装）：
```
sudo yum install logrotate -y
```

创建Swagger专用配置文件（如/etc/logrotate.d/swagger-editor）：

/var/log/swagger-editor/*.log {
  daily          # 每日轮转
  missingok      # 忽略缺失文件
  rotate 7       # 保留7天日志
  compress       # 压缩旧日志（.gz格式）
  delaycompress  # 延迟压缩（避免当天日志被压缩）
  notifempty     # 空日志不轮转
  create 0644 root root  # 新日志文件权限
}

测试配置有效性：

sudo logrotate -d /etc/logrotate.d/swagger-editor  # 干运行（无实际操作）
sudo logrotate -f /etc/logrotate.d/swagger-editor  # 强制立即轮转

4. 日志查看与分析

实时查看：若Swagger服务通过systemd运行，使用journalctl过滤日志：

journalctl -u swagger-editor -f  # 实时跟踪swagger-editor服务日志
journalctl -u swagger-editor --since "2025-09-18"  # 查看指定日期后的日志

文本分析：使用grep、awk提取关键信息（如错误日志）：

grep "ERROR" /var/log/swagger-editor/*.log  # 查找所有错误日志
awk '/500/ {print $0}' /var/log/swagger-editor/*.log  # 提取HTTP 500错误

可视化分析：对于复杂场景，部署ELK Stack（Elasticsearch+Logstash+Kibana）或Splunk，实现日志收集、存储、分析与可视化。

二、监控方法：性能与可用性保障

1. 系统整体性能监控

通过基础命令监控系统资源占用，快速定位瓶颈：

实时进程监控：top（动态显示CPU/内存占用）、htop（增强版，支持鼠标操作）；
系统资源统计：vmstat 1（每秒刷新虚拟内存、CPU、进程状态）、iostat -x 1（磁盘I/O详情）、sar -u 1（CPU历史数据）；
综合监控工具：Nmon（图形化展示CPU、内存、磁盘、网络等指标，适合长期监控）。

2. Swagger服务性能监控

针对Swagger服务本身，使用专业工具监控关键指标（如请求延迟、吞吐量、错误率）：

Prometheus+Grafana：
- 部署Prometheus Exporter（如Spring Boot Actuator暴露/actuator/prometheus端点），收集Swagger服务指标；
- 配置Prometheus抓取端点数据，并通过Grafana创建仪表盘（展示请求量、响应时间、错误率等）；
Netdata：轻量级实时监控工具，支持自定义指标，可快速集成到Swagger服务中，提供可视化监控面板。

3. 安全监控与审计

安全事件检测：使用logwatch（自动化日志分析，发送每日安全报告）、fail2ban（防止暴力破解，自动封禁恶意IP）、ossec（入侵检测系统，监控异常行为）；
审计日志：通过auditd工具记录系统调用（如文件访问、进程执行），配置/etc/audit/auditd.conf开启审计，例如监控Swagger配置目录的修改：
```
sudo auditctl -w /path/to/swagger/config -p wa -k swagger_config_changes
```
日志将存储在/var/log/audit/audit.log中，可通过ausearch命令查询。