文件首頁
MySQL Connector/J 開發者指南
相關文件 下載本手冊
PDF (US Ltr) - 1.2Mb
PDF (A4) - 1.2Mb


MySQL Connector/J 開發者指南  /  ...  /  除錯/效能分析

6.3.14 除錯/效能分析

  • logger

    用於記錄訊息的實作 'com.mysql.cj.log.Log' 的類別名稱。(預設為 'com.mysql.cj.log.StandardLogger',會記錄到 STDERR)。

    預設值 com.mysql.cj.log.StandardLogger
    版本從 3.1.1
  • profilerEventHandler

    實作介面 'com.mysql.cj.log.ProfilerEventHandler' 的類別名稱,將用於處理效能分析/追蹤事件。

    預設值 com.mysql.cj.log.LoggingProfilerEventHandler
    版本從 5.1.6
  • useNanosForElapsedTime

    對於測量經過時間的效能分析/除錯功能,驅動程式是否應該嘗試使用奈秒解析度?

    預設值 false
    版本從 5.0.7
  • maxQuerySizeToLog

    控制在執行效能分析或追蹤時記錄的查詢部分的最大長度。

    預設值 2048
    版本從 3.1.3
  • maxByteArrayAsHex

    預備語句中位元組陣列參數的最大大小,該參數在 'JdbcPreparedStatement.toString()' 內插時會轉換為十六進位常值。任何大於此值的位元組陣列都會以一般方式內插為 "** BYTE ARRAY DATA **"。

    預設值 1024
    版本從 8.0.31
  • profileSQL

    追蹤查詢及其執行/擷取時間到已設定的 'profilerEventHandler'。

    預設值 false
    版本從 3.1.0
  • logSlowQueries

    是否應該將耗時超過 'slowQueryThresholdMillis' 或由 'autoSlowLog' 監控偵測到的查詢報告給已註冊的 'profilerEventHandler'?

    預設值 false
    版本從 3.1.2
  • slowQueryThresholdMillis

    如果啟用 'logSlowQueries',查詢應該花費多長時間(以毫秒為單位)才會被記錄為緩慢?

    預設值 2000
    版本從 3.1.2
  • slowQueryThresholdNanos

    如果啟用 'logSlowQueries','useNanosForElapsedTime' 設定為 "true",並且此屬性設定為非零值,則驅動程式將使用此閾值(以奈秒為單位)來判斷查詢是否緩慢。

    預設值 0
    版本從 5.0.7
  • autoSlowLog

    是否不使用 'slowQueryThreshold*' 來判斷查詢是否緩慢到足以記錄,而是維護統計資料,讓驅動程式判斷超出第 99 個百分位數的查詢?

    預設值 true
    版本從 5.1.4
  • explainSlowQueries

    如果啟用 'logSlowQueries',驅動程式是否應該自動在伺服器上發出 'EXPLAIN',並將結果以 WARN 層級傳送到已設定的記錄器?

    預設值 false
    版本從 3.1.2
  • gatherPerfMetrics

    驅動程式是否應該收集效能指標,並每隔 'reportMetricsIntervalMillis' 毫秒透過已設定的記錄器報告它們?

    預設值 false
    版本從 3.1.2
  • reportMetricsIntervalMillis

    如果啟用 'gatherPerfMetrics',應該多久記錄一次(以毫秒為單位)?

    預設值 30000
    版本從 3.1.2
  • logXaCommands

    驅動程式是否應該將 'MysqlXaConnection' 送出的 XA 命令記錄到伺服器,記錄層級為 DEBUG?

    預設值 false
    版本從 5.0.5
  • traceProtocol

    是否應該以 TRACE 層級記錄網路通訊協定?

    預設值 false
    版本從 3.1.2
  • enablePacketDebug

    啟用時,將保留 'packetDebugBufferSize' 封包的環形緩衝區,並在驅動程式程式碼中關鍵區域擲回例外狀況時傾印。

    預設值 false
    版本從 3.1.3
  • packetDebugBufferSize

    當 'enablePacketDebug' 為「true」時,要保留的最大封包數。

    預設值 20
    版本從 3.1.3
  • useUsageAdvisor

    驅動程式是否應該向 'profilerEventHandler' 發出使用情況警告,建議正確且有效率地使用 JDBC 和 MySQL Connector/J?

    預設值 false
    版本從 3.1.1
  • resultSetSizeThreshold

    如果 'useUsageAdvisor' 為「true」,結果集應該包含多少列,驅動程式才會警告其大得可疑?

    預設值 100
    版本從 5.0.5
  • autoGenerateTestcaseScript

    驅動程式是否應該將其正在執行的 SQL(包括伺服器端預備語句)傾印到 STDERR?

    預設值 false
    版本從 3.1.9
  • openTelemetry

    驅動程式是否應產生 OpenTelemetry 追蹤並處理與 MySQL 伺服器的上下文傳播?此選項接受 "REQUIRED"、"PREFERRED" 和 "DISABLED" 等值。若設定為 "REQUIRED",則執行階段必須有 OpenTelemetry 程式庫可用,否則連線至 MySQL 伺服器將會失敗。設定為 "DISABLED" 將關閉 Connector/J 產生 OpenTelemetry 檢測功能。設定為 "PREFERRED" 則會在執行階段有 OpenTelemetry 程式庫可用的情況下啟用產生 OpenTelemetry 檢測功能,否則會發出警告。若未設定此屬性的值,則等同於將其設定為 "PREFERRED",但執行階段若沒有可用的 OpenTelemetry 程式庫則不會發出警告。Connector/J 完全依賴於呼叫應用程式中設定的 OpenTelemetry 輸出器,且不提供任何配置其自身輸出器的方法。

    預設值 PREFERRED (偏好)
    版本從 8.4.0