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には、1回のrequest内で実行したSQLの累積時間を監視するwhenQueryingForLongerThan もあります。2つのAPIは計測対象が異なります。
トランザクション内で外部APIを呼び出していたり、ロック待ちが発生していたりすると、SQLの累積時間よりトランザクションの経過時間のほうが大きくなることがあります。両方を記録すると、遅延がSQLそのものによるものか、トランザクション内の別の処理によるものかを切り分けやすくなります。