Wazuh Dashboard 讀取 CDB list 逾時的調整

Jason Cheng 發布 2025.10.01

本文目錄

Wazuh 的 CDB list 越放越大之後，在網頁介面打開清單會一直轉圈圈，最後跳出逾時錯誤：

timeout of 20000ms exceeded

原因是 Dashboard 要透過 Wazuh Server API 讀取清單內容，清單太大、API 回得太慢，就被逾時切斷了。這個逾時有兩個地方會卡住，這篇整理調整方式。

兩層逾時

位置	設定	單位	預設
Wazuh Dashboard 等待 API 回應	`timeout`（`wazuh.yml`）	毫秒	`20000`（20 秒）
Wazuh Server API 處理請求	`intervals.request_timeout`（`api.yaml`）	秒	`10`

錯誤訊息是 timeout of 20000ms exceeded，代表是 Dashboard 等了 20 秒沒等到，要先調第一個；調了之後還是失敗，再看 API 這一層。

編輯 /usr/share/wazuh-dashboard/data/wazuh/config/wazuh.yml：

timeout: 60000

單位是毫秒，上面是 60 秒。官方文件說明低於 1500 的值會被忽略，改用預設值。

systemctl restart wazuh-dashboard

這個設定也可以在網頁介面「Dashboard management → App Settings → Configuration」直接修改，不用登入主機。

編輯 /var/ossec/api/configuration/api.yaml：

intervals:
  request_timeout: 120

單位是秒。API 處理任何請求超過這個時間就會中止，所以 Dashboard 的 timeout 調得再長，API 這邊先切斷也沒用。

systemctl restart wazuh-manager

注意：兩個設定的單位不同，Dashboard 是毫秒、API 是秒，很容易填錯。另外 Dashboard 的等待時間應該大於或等於 API 的處理時間，否則 API 還在處理，Dashboard 就先放棄了。

不要一口氣把逾時調到好幾分鐘。逾時的用意是避免一個慢請求把資源一直佔著，設太長，真的出問題時反而要等更久才知道。

Wazuh 的 GitHub 上也有人回報過，請求非常大的 CDB list 時 API 會逾時甚至當掉。清單大到一定程度，調逾時只是延後問題：

上傳大清單時遇到的大小限制，可以參考〈Wazuh 上傳 CDB list 的檔案大小限制〉。

timeout of 20000ms exceeded 是 Dashboard 的 20 秒等待時間，調 wazuh.yml 的 timeout；API 那邊的 request_timeout 也要一起放寬，而且注意單位。清單真的很大的話，拆分清單比一直調大逾時更實際。

Jason Cheng

企業開源技術顧問，專注架構規劃與實務導入