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 本身,还是来自事务内的其他处理。