MariaDB 日誌指南:錯誤、慢查詢與 Galera 事件

找出 MariaDB 錯誤與慢查詢日誌的輸出位置,再用各節點的 WSREP 狀態和日誌重建 Galera 事件的時間線。

最佳實務
日誌事件收集與資料分析示意圖

Galera 節點重新加入叢集後,結帳查詢變慢了。錯誤日誌可以查狀態傳輸何時開始,慢查詢日誌可以找出超過門檻的 SQL。要確認節點現在是否就緒、複寫是否受流量控制影響,還要看 wsrep 狀態。把這些證據放到同一條時間線,才看得出事件如何發展。

以下慢查詢設定使用 MariaDB 10.11 起的名稱,檔案日誌範例已在單機 MariaDB 11.8 核對,Galera 部分依據官方文件。不同套件和代管服務可能覆寫預設值。

先找錯誤日誌實際寫到哪裡

在正在運作的 MariaDB 執行 SHOW VARIABLES LIKE 'log_error';。Unix 上未設定 log_error 時,伺服器把錯誤寫到 stderr。若由 systemd 收集,再用實際服務名稱查 journal,例如 journalctl -u mariadb;容器則看執行環境如何收集 stderr。

[mariadb]
log_error = /var/log/mariadb/error.log
log_warnings = 2

這段設定讓錯誤日誌寫入檔案。先建立上層目錄,讓 MariaDB 服務帳號能寫入目錄和已存在的檔案。MariaDB 文件所列的 log_warnings 預設值是 2,部署可能另外設定,而且它只影響部分警告。為了排查連線問題而暫時提高詳細程度時,先記下舊值。日誌輪替若搬動了檔案,要讓 MariaDB 重新開啟檔案再檢查輸出。錯誤日誌 · 日誌輪替

讓慢查詢日誌有清楚的統計範圍

先在受控環境用可寫入的路徑測試以下設定。log_output = FILE 同時會影響通用查詢日誌,變更前先查目前的輸出位置。

[mariadb]
log_output = FILE
log_slow_query = 1
log_slow_query_file = /var/log/mariadb/slow.log
log_slow_query_time = 1
log_queries_not_using_indexes = OFF
log_slow_rate_limit = 1

這份設定採用一秒門檻,明確關閉未使用索引時略過門檻的選項,也不對慢日誌取樣。仍要遵守伺服器其餘慢查詢條件。MariaDB 10.11 起使用 log_slow_query、log_slow_query_file 和 log_slow_query_time;之前的 slow_query_log、slow_query_log_file、long_query_time 在新版仍是別名。

log_slow_filter 可以依全表掃描、filesort 或隱含暫存表等特徵篩選。開啟 not_using_index 後,速度快但未使用索引的查詢也可能記錄。可用 log_slow_min_examined_row_limit 排除檢查行數太少的查詢。提高 log_slow_rate_limit 後,只能把日誌當成樣本。MariaDB 11.7 起,耗時超過 log_slow_always_query_time 的查詢可略過相關取樣限制。

log_slow_verbosity 可在檔案輸出加入細節。query_plan 記錄查詢計畫資訊,explain 可對支援的語句輸出 EXPLAIN。表格輸出不支援這些選項。檔案可以交給 mariadb-dumpslow 按相似語句彙總;表格輸出則查 mysql.slow_log。用其他分析器之前,先拿包含實際附加欄位的樣本測試解析。慢查詢日誌 · 伺服器變數 · mariadb-dumpslow

只在短時間內擷取通用查詢日誌

通用查詢日誌在伺服器收到語句時記錄,也會記錄連線和斷線。從一行記錄無法判定該語句是否成功,或交易是否提交。

SHOW GLOBAL VARIABLES
WHERE Variable_name IN ('general_log', 'general_log_file', 'log_output');

需要短期排查時,先記下原設定和目的地。在原本為 OFF、輸出已是 FILE 的測試環境,可用下列查詢確認日誌去向。

SET GLOBAL general_log = ON;
SELECT 1 AS learn_general_log_probe;
SET GLOBAL general_log = OFF;

結束後恢復原設定。把 log_output 改成 TABLE 也會影響慢查詢日誌,兩種日誌會各寫到對應的系統表。日誌可能包含 SQL 字面值,寫入量也可能很大,應限制存取及啟用時間。通用查詢日誌 · 寫入系統表

依備份和復原目標設定 binlog 保留期

以下為 MariaDB 10.6.1 或更新版本的檔案型 binlog 設定,604800 秒相當於七天。

[mariadb]
log_bin = /var/log/mariadb/mariadb-bin
binlog_expire_logs_seconds = 604800
max_binlog_size = 1G

實際保留期限應涵蓋基礎備份週期、時間點還原窗口,以及複本最久可能延遲或斷線的時間。過期可能在啟動或輪替時才檢查,未必到點就刪除。binlog 及其索引由 MariaDB 管理,不要用一般系統日誌輪替工具處理,也不要手動刪除。Binlog 管理

把 Galera 各節點的證據放到同一條時間線

在 donor 和 joiner 的錯誤日誌中找 WSREP 成員變更、SST 快照傳輸和 IST 增量傳輸。若 donor 還保留缺少的 writeset 歷史,就可能用 IST 補齊。SST 失敗時,還要查已設定的傳輸方法所產生的日誌。

SHOW GLOBAL STATUS
WHERE Variable_name IN (
  'wsrep_cluster_status',
  'wsrep_cluster_size',
  'wsrep_ready',
  'wsrep_connected',
  'wsrep_local_state_comment',
  'wsrep_local_recv_queue_avg',
  'wsrep_flow_control_paused'
);

在 Galera 部署中,用 wsrep_cluster_status 確認 Primary 元件,從 wsrep_ready 和 wsrep_local_state_comment 看節點就緒與同步狀態。wsrep_flow_control_paused 是上次 FLUSH STATUS 後因流量控制而暫停的時間比例,要配合接收佇列與其他節點的狀態判斷。

日誌已落盤時,可用觀測雲 DataKit 檔案採集(簡體中文)分開收集錯誤與慢查詢日誌。保留節點和叢集識別,先用樣本驗證多行 SQL 是否合成一筆,再確認事件時間與時區。Pipeline 可以統一時間欄位,主機時鐘仍要另外同步。接著可依節點或叢集,對重複出現的特定 WSREP 失敗建立日誌偵測。兩種日誌若需要不同留存,再核對日誌索引路由和儲存策略。Galera 狀態變數 · 觀測雲日誌偵測(簡體中文) · 日誌索引(簡體中文)

延伸閱讀

取得專屬方案

聯絡我們

加入社群

微信扫码
加入官方交流群

立即體驗

在线开通,按量计费,真正的云服务!

立即開始

选择观测云版本

代码托管平台