Linux系統中Swagger的日志記錄如何配置

在Linux系統中配置Swagger的日志記錄可以通過以下幾種方法實現：

使用Logrotate管理日志文件

Logrotate是一個在Linux系統上管理日志文件的工具，它可以自動分割、壓縮、刪除和郵件通知日志文件。對于Swagger Editor或Swagger UI，通常會在/var/log目錄下生成日志文件。

1. 安裝Logrotate（如果尚未安裝）：

sudo apt-get install logrotate

2. 配置Logrotate：

創建一個Logrotate配置文件，例如/etc/logrotate.d/swagger-editor：

/var/log/swagger-editor/*.log {
  daily
  missingok
  rotate 7
  compress
  delaycompress
  notifempty
  create 0644 root root
}

這個配置表示每天分割/var/log/swagger-editor/目錄下的.log文件，保留最近7天的日志文件，并對舊的日志文件進行壓縮。

3. 測試配置并強制旋轉日志：

sudo logrotate -d /etc/logrotate.d/swagger-editor # 測試配置文件是否有錯誤
sudo logrotate -f /etc/logrotate.d/swagger-editor # 強制旋轉日志文件

4. 手動運行Logrotate：

sudo logrotate /etc/logrotate.d/swagger-editor

使用Systemd管理日志

如果你的Swagger服務是通過Systemd管理的，那么可以使用journalctl命令來查看和管理日志。

1. 查看日志：

journalctl -u swagger-editor

這將顯示與swagger-editor相關的系統日志。

2. 清理日志：

只保留一周的日志：

sudo journalctl --vacuum-time=1w

只保留指定大小的日志：

sudo journalctl --vacuum-size=500M

使用自定義腳本管理日志

對于更復雜的日志管理需求，你可以編寫自定義腳本來管理Swagger相關的日志文件。例如，使用crontab定時執行日志清理腳本。

1. 創建清理腳本：

sudo vi /usr/local/bin/clean-swagger-logs.sh

內容示例：

#!/bin/bash
find /var/log/swagger-editor/ -mtime +7 | xargs rm -rf

2. 賦予腳本執行權限：

sudo chmod +x /usr/local/bin/clean-swagger-logs.sh

3. 定時執行腳本：

編輯crontab文件：

crontab -e

添加以下行以每天清理日志：

0 0 * * * /usr/local/bin/clean-swagger-logs.sh

集成日志庫

Swagger本身不提供日志記錄功能，但你可以將Swagger與現有的日志庫（如Logback、SLF4J等）集成。這樣，Swagger生成的日志信息可以被這些日志庫捕獲并記錄到指定的日志文件中。

例如，在Spring Boot應用程序中，可以在application.properties或application.yml中配置日志級別：

logging.level.io.swagger=DEBUG
logging.level.springfox=DEBUG
logging.level.org.springdoc=DEBUG

并配置Logback（logback-spring.xml）：

<configuration>
    <appender name="FILE" class="ch.qos.logback.core.FileAppender">
        <file>logs/swagger-api.log</file>
        <encoder>
            <pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg%n</pattern>
        </encoder>
    </appender>
    <logger name="io.swagger" level="DEBUG" additivity="false">
        <appender-ref ref="FILE"/>
    </logger>
    <root level="INFO">
        <appender-ref ref="FILE"/>
    </root>
</configuration>

通過以上方法，你可以在Linux系統上有效地管理Swagger的日志，確保系統的穩定運行和問題的快速排查。