效能擷取功能會收集執行個體指標資料,並將資料傳送至 Cloud Logging 的 mysql-performance-capture.log 檔案。
如要進一步瞭解如何在 Cloud Logging 查看記錄,請參閱「使用 Logs Explorer 查看記錄」。
事前準備
如要查看效能擷取記錄,您必須具備適當權限,才能在 Cloud Logging 中查看專案和執行個體的記錄。
必要角色和權限
如要取得查看效能擷取記錄所需的權限,請要求管理員在執行個體的專案中,授予您記錄檢視者 (roles/logging.viewer) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。
查看效能擷取記錄
如要查看效能擷取記錄,請按照下列步驟操作:
-
前往 Cloud de Confiance 控制台的「Cloud Logging」頁面。
- 按一下「所有資源」,然後選取「Cloud SQL 資料庫」。
- 選取 Cloud SQL 執行個體。
篩選記錄檔名稱:
logName="projects/PROJECT_ID/logs/cloudsql.googleapis.com%2Fmysql-performance-capture.log"
將 PROJECT_ID 替換為專案 ID。
記錄酬載採用字串格式,包含擷取的指令輸出內容,例如跨多個記錄行的
SHOW ENGINE INNODB STATUS。
查看成效擷取記錄中的資料
每個效能擷取記錄都是由您為執行個體定義的效能事件觸發。下表將效能擷取記錄項目與設定門檻建立關聯,並說明您可以在項目記錄中查看的成效資料報表。
| 效能擷取記錄項目 | 說明 | 觸發條件 | 報表名稱 |
|---|---|---|---|
| 執行中的查詢 | 擷取資料庫負載指標,包括依狀態分組的連線和交易數量、依執行階段時間長度 (<2 秒、2 至 10 秒、≥10 秒) 分組的執行中查詢數量,以及執行時間最長的 50 項交易或查詢的詳細資訊。這份報表有助於找出高負載時段,以及查詢速度緩慢的特定項目。 如要進一步瞭解如何解讀 InnoDB 交易和程序相關資料,請參閱 MySQL 說明文件中的「 INFORMATION_SCHEMA INNODB_TRX 資料表」和「processlist 資料表」。
|
|
activequeries |
| InnoDB 狀態 | 提供效能事件發生時,InnoDB 儲存引擎狀態的相關資訊。這對於診斷鎖定爭用、交易問題、緩衝集區問題和歷程記錄清單長度增長至關重要。要尋找的關鍵字:
|
innodbstatus |
|
| 複製分析 | 包含複製診斷資訊,包括 SHOW REPLICA STATUS 的輸出內容、GTID 集,以及效能結構定義工具的詳細資料。這份報告也包含中繼記錄中的前五個事件,這些事件是在效能事件發生時的執行位置之後。這份報表可用於診斷複製錯誤或延遲。如要進一步瞭解 SHOW REPLICA STATUS 輸出內容和副本套用工具執行緒,請參閱 MySQL 說明文件中的 SHOW REPLICA STATUS 陳述式和監控複製套用工具工作站執行緒。 |
|
replicastatus |
| 交易分析 | 追蹤中的長時間執行交易詳細資料。 如要進一步瞭解如何解讀 InnoDB 交易資料,請參閱 MySQL 說明文件中的「 INFORMATION_SCHEMA INNODB_TRX 資料表」。 |
長時間執行的交易 | LongRunningTransactions |
| 自動終止交易 | 在目前探測週期中終止的長時間執行交易詳細資料。 |
自動終止資料 | AutoTerminateTransaction |
篩選效能擷取記錄中的資料
如果效能擷取功能根據 Cloud SQL 執行個體設定的門檻偵測到問題,監控代理程式會將與執行個體和報表類型相關聯的標籤記錄項目傳送至 Cloud Logging。
為協助您整理記錄,並將記錄項目與執行個體觀察到的效能問題建立關聯,您可以依標籤篩選效能擷取記錄項目。
每個記錄項目都會標上以下兩個標籤:
事件時間或
labels.EVENT_TIME:表示效能擷取項目記錄的時間。格式為不重複的時間戳記字串YYYY-MM-DDTHH:MM:SSZ。例如:2025-10-16T13:12:07Z。檔案名稱或
labels.FILE_NAME:用於識別報表類型,以及由效能事件觸發的效能擷取記錄項目序號。格式為INSTANCE_TYPE_SEQUENCE_NUMBER_REPORT_TYPE。例如primary_1_activequeries,這是執行中查詢報表的第一個效能擷取記錄項目。
篩選器示例
本節提供範例,說明如何篩選 mysql-performance-capture.log 檔案,找出特定記錄項目進行分析。
在下列範例中,請替換下列項目:
- PROJECT_ID:Cloud SQL 執行個體的專案 ID
- TIMESTAMP:觸發效能事件的時間戳記,格式為
YYYY-MM-DDTHH:MM:SSZ。例如:2025-10-16T13:12:07Z
依特定成效事件篩選
如要依特定效能事件篩選,請使用 labels.EVENT_TIME 標籤尋找相關記錄項目。
舉例來說,如要取得特定效能事件的報告,請在 Logging Logs Explorer 查詢建立工具中,使用下列查詢。
取得特定事件的所有報表
logName="projects/PROJECT_ID/logs/cloudsql.googleapis.com%2Fmysql-performance-capture.log" labels.EVENT_TIME="TIMESTAMP"
取得特定事件的 InnoDB 報表
logName="projects/PROJECT_ID/logs/cloudsql.googleapis.com%2Fmysql-performance-capture.log" labels.EVENT_TIME="TIMESTAMP" labels.FILE_NAME=~"innodbstatus"
僅取得特定事件所有報表類型的第一筆記錄項目
logName="projects/PROJECT_ID/logs/cloudsql.googleapis.com%2Fmysql-performance-capture.log" labels.EVENT_TIME="TIMESTAMP" labels.FILE_NAME=~"_1_"
篩選檔案名稱
取得所有事件的全部activequeries報表
這項一般查詢可用於查看任何效能事件期間,執行中查詢的狀態。
logName="projects/PROJECT_ID/logs/cloudsql.googleapis.com%2Fmysql-performance-capture.log" labels.FILE_NAME=~"activequeries"
更改下列內容:
- PROJECT_ID:Cloud SQL 執行個體的專案 ID
比較特定事件的第一個和第三個innodbstatus報表
logName="projects/PROJECT_ID/logs/cloudsql.googleapis.com%2Fmysql-performance-capture.log" labels.EVENT_TIME="TIMESTAMP" (labels.FILE_NAME="primary_1_innodbstatus" OR labels.FILE_NAME="primary_3_innodbstatus")
更改下列內容:
- PROJECT_ID:Cloud SQL 執行個體的專案 ID
- TIMESTAMP:觸發效能事件的時間戳記,格式為
YYYY-MM-DDTHH:MM:SSZ。例如:2025-10-16T13:12:07Z
找出特定時間後發生的任何事件的第一個 activequeries 報表
logName="projects/PROJECT_ID/logs/cloudsql.googleapis.com%2Fmysql-performance-capture.log" labels.FILE_NAME="primary_1_activequeries" timestamp > "TIMESTAMP"
更改下列內容:
- PROJECT_ID:Cloud SQL 執行個體的專案 ID
- TIMESTAMP:時間戳記,格式為
YYYY-MM-DDTHH:MM:SSZ。例如:2025-10-16T13:12:07Z
在任何 InnoDB 狀態報表中搜尋特定文字
logName="projects/PROJECT_ID/logs/cloudsql.googleapis.com%2Fmysql-performance-capture.log" labels.FILE_NAME=~"innodbstatus" textPayload:"SEARCH_TEXT"
更改下列內容:
- PROJECT_ID:Cloud SQL 執行個體的專案 ID
- SEARCH_TEXT:要搜尋的文字。例如:
SEMAPHORE WAITS