Connection::whenTransactionRunsLongerThan 會在交易整體的經過時間超過指定門檻時呼叫 callback。
本頁以 Laravel Framework 13.x 的實作 為基礎。請確認你使用的 Framework 版本包含此方法。
註冊 callback
若要監控整個應用程式的資料庫連線,請在 service provider 的boot 方法中註冊。門檻的單位是 毫秒。
Connection: 受監控的資料庫連線TransactionCommitted|TransactionRolledBack: 表示交易是 commit 還是 rollback 的 eventfloat: 量測到的經過時間(毫秒)
DB::connection('mysql') 這樣指定連線名稱,就能只監控特定連線。若要監控多個連線,請在各個 Connection 上分別註冊 callback。
量測範圍
量測在外層交易開始時開始,並在外層交易 commit 或 rollback 時結束。0 變成 1 時保存開始時間。因此,即使內層 transaction 以 savepoint 方式運作,內層的處理時間也會計入外層交易的經過時間。這並不是以獨立門檻監控內層 transaction 的機制。
callback 會在 transaction level 回到 0 之後呼叫。即使 DB::transaction 的 callback 拋出例外並 rollback,也能收到 TransactionRolledBack event 與量測時間。手動呼叫 beginTransaction / commit / rollBack 時也會觸發相同的 event。
門檻的指定方式
whenTransactionRunsLongerThan 的第 1 個參數可以傳入以下形式。
通常直接指定毫秒就足夠了。若想以時間單位表示,可以使用
CarbonInterval。
0 時,所有量測到的 transaction 都會觸發 callback。
與 SQL 延遲區分
Laravel 也提供whenQueryingForLongerThan,用來監控單一 request 內執行之 SQL 的累計時間。兩個 API 的量測對象不同。
若在交易內呼叫外部 API 或發生鎖定等待,交易的經過時間可能會大於 SQL 的累計時間。同時記錄兩者,就更容易區分延遲是來自 SQL 本身,還是交易內的其他處理。