建立目前伺服器狀態的報告,以供診斷之用。
此程序會藉由操作 sql_log_bin 系統變數的階段作業值,在執行期間停用二進位記錄。這是一項受限操作,因此程序需要足夠的權限才能設定受限的階段作業變數。請參閱第 7.1.9.1 節「系統變數權限」。
為 diagnostics() 收集的資料包含下列資訊
來自
metrics檢視的資訊(請參閱第 30.4.3.21 節「metrics 檢視」)來自其他相關
sys綱要檢視的資訊,例如判斷第 95 個百分位數的查詢的檢視如果 MySQL 伺服器是 NDB 叢集的一部分,則來自
ndbinfo綱要的資訊複寫狀態(來源和複本)
某些 sys 綱要檢視會計算為初始值(選用)、整體值和差異值
初始檢視是
diagnostics()程序開始時的檢視內容。此輸出與差異檢視所使用的開始值相同。如果diagnostics.include_raw組態選項為ON,則會包含初始檢視。整體檢視是
diagnostics()程序結束時的檢視內容。此輸出與差異檢視所使用的結束值相同。一律會包含整體檢視。差異檢視是從程序執行開始到結束的差異。最小值和最大值分別是來自結束檢視的最小值和最大值。它們不一定反映受監控期間的最小值和最大值。除了
metrics檢視之外,差異只會在第一次和最後一次輸出之間計算。
in_max_runtime INT UNSIGNED:最長資料收集時間,以秒為單位。使用NULL來收集預設的 60 秒資料。否則,請使用大於 0 的值。in_interval INT UNSIGNED:資料收集之間的睡眠時間,以秒為單位。使用NULL來睡眠預設的 30 秒。否則,請使用大於 0 的值。in_auto_config ENUM('current', 'medium', 'full'):要使用的 Performance Schema 組態。允許的值為current:使用目前的儀器和消費者設定。medium:啟用某些儀器和消費者。full:啟用所有儀器和消費者。
注意啟用的儀器和消費者越多,對 MySQL 伺服器效能的影響就越大。請謹慎使用
medium設定,尤其是full設定,它會對效能造成很大的影響。使用
medium或full設定需要SUPER權限。如果選擇
current以外的設定,則會在程序結束時還原目前的設定。
可以使用下列組態選項或其對應的使用者定義變數來修改 diagnostics() 操作(請參閱第 30.4.2.1 節「sys_config 資料表」)
debug,@sys.debug如果此選項為
ON,則會產生除錯輸出。預設值為OFF。diagnostics.allow_i_s_tables,@sys.diagnostics.allow_i_s_tables如果此選項為
ON,則允許diagnostics()程序在 Information Schema 的TABLES表格上執行表格掃描。如果表格數量眾多,這可能會耗費大量資源。預設值為OFF。diagnostics.include_raw,@sys.diagnostics.include_raw如果此選項為
ON,則diagnostics()程序輸出會包含從查詢metrics視圖所取得的原始輸出。預設值為OFF。statement_truncate_len,@sys.statement_truncate_len由
format_statement()函數傳回的語句最大長度。超出此長度的語句會被截斷。預設值為 64。
建立一個診斷報告,該報告每 30 秒開始一次迭代,並使用目前的 Performance Schema 設定執行最多 120 秒
mysql> CALL sys.diagnostics(120, 30, 'current');若要將 diagnostics() 程序執行的輸出擷取到檔案中,請使用 mysql 用戶端 tee 和 filenamenotee 命令(請參閱 第 6.5.1.2 節「mysql 用戶端命令」)
mysql> tee diag.out;
mysql> CALL sys.diagnostics(120, 30, 'current');
mysql> notee;