Centos Swagger如何監控運行狀態

CentOS系統監控Swagger運行狀態的實用方法

一、基礎運行狀態檢查（快速驗證可用性）

• Web服務器日志分析：若Swagger UI或Swagger Editor已部署至Apache/Nginx等Web服務器，可通過查看錯誤日志快速識別運行異常。Apache日志默認路徑為/var/log/apache2/error.log，Nginx為/var/log/nginx/error.log，檢查是否有500 Internal Server Error、404 Not Found等錯誤信息。
• 瀏覽器直接訪問驗證：通過瀏覽器輸入Swagger UI的訪問地址（如http://your_server_ip/swagger-ui），查看是否能正常加載API文檔、發起請求并獲得響應。若頁面無法加載或響應超時，可能提示服務器未啟動、網絡問題或配置錯誤。

二、系統資源與進程監控（排查性能瓶頸）

• 常用命令行工具：使用top（實時顯示CPU、內存占用）、htop（增強版可視化）、vmstat（虛擬內存、進程及CPU活動）、iostat（磁盤I/O性能）、sar（歷史性能數據收集）等命令，監控CentOS系統的整體資源使用情況，判斷是否因系統資源不足導致Swagger運行緩慢。
• Netdata實時監控：安裝Netdata（sudo yum install netdata -y），通過其Web界面（http://your_server_ip:19999）實時查看CPU、內存、磁盤、網絡等指標，支持自定義監控項，可快速定位Swagger服務對系統資源的消耗。

三、專業監控方案（深度指標與告警）

• Prometheus + Grafana組合：
  • Prometheus：作為開源監控系統，通過node_exporter收集系統指標，通過swagger-exporter（若有）或自定義Exporter收集Swagger服務的性能指標（如請求速率、錯誤率、響應時間）；
  • Grafana：對接Prometheus數據源，創建可視化儀表板，展示Swagger API的關鍵指標（如QPS、成功率、延遲分布），支持設置告警規則（如錯誤率超過5%時發送郵件/短信通知）。
• APM工具集成：使用New Relic、Datadog或AppDynamics等應用性能管理工具，深度追蹤Swagger API的請求鏈路、性能瓶頸（如慢SQL、第三方接口調用延遲），提供更全面的運行狀態分析。

四、自定義腳本監控（靈活定制需求）

• Shell腳本+定時任務：編寫Shell腳本（如check_swagger.sh），使用curl命令定期發送請求到Swagger UI或API端點（如http://localhost:8080/api-docs），檢查響應狀態碼（應為200）和響應時間（如超過2秒則視為異常）。通過cron設置定時任務（如每5分鐘執行一次），并將結果輸出到日志文件或發送告警（如mail命令）。

五、基于Spring Boot的動態監控（若使用Spring Boot）

• 動態文檔與指標收集：若Swagger API基于Spring Boot框架，可通過@RestController和@RequestMapping注解自動生成Swagger文檔（如springfox-swagger2或springdoc-openapi）。集成Prometheus Client（micrometer-registry-prometheus），暴露/actuator/prometheus端點，收集API的請求速率、錯誤率、響應時間等指標。
• Phoenix平臺監控：使用Phoenix（靈活的開源監控平臺），支持監控HTTP接口（包括Swagger API），可配置實時數據收集、異常告警（如郵件、Slack通知），并提供可視化界面查看API運行狀態。