Connection::whenTransactionRunsLongerThan invoca un callback cuando el tiempo total transcurrido de una transacción supera el umbral indicado.
Esta página se basa en la implementación de Laravel Framework 13.x. Comprueba que la versión de Framework que usas incluye este método.
Registrar el callback
Para monitorizar las conexiones de base de datos de toda la aplicación, registra el callback en el métodoboot de un service provider. El umbral se expresa en milisegundos.
Connection: la conexión de base de datos monitorizadaTransactionCommitted|TransactionRolledBack: el evento que indica si la transacción se confirmó (commit) o se revirtió (rollback)float: el tiempo transcurrido medido (en milisegundos)
DB::connection('mysql'), solo monitorizas esa conexión. Para monitorizar varias conexiones, registra un callback en cada Connection.
Qué se mide
La medición empieza cuando comienza la transacción externa y termina cuando la transacción externa hace commit o rollback.0 a 1. Por eso, aunque una transacción interna funcione como savepoint, su tiempo de procesamiento se incluye en el tiempo transcurrido de la transacción externa. Este mecanismo no sirve para monitorizar una transacción interna con su propio umbral.
El callback se llama después de que el nivel de transacción vuelva a 0. Si el callback de DB::transaction lanza una excepción y se hace rollback, también recibes el evento TransactionRolledBack y el tiempo medido. Los mismos eventos se producen cuando llamas manualmente a beginTransaction / commit / rollBack.
Cómo indicar el umbral
Como primer argumento dewhenTransactionRunsLongerThan puedes pasar los siguientes tipos.
Normalmente basta con indicar los milisegundos directamente. Si prefieres expresarlo en unidades de tiempo, puedes usar
CarbonInterval.
0, todas las transacciones medidas activan el callback.
Distinguirlo de la lentitud del SQL
Laravel también ofrecewhenQueryingForLongerThan, que monitoriza el tiempo acumulado del SQL ejecutado dentro de una misma petición. Las dos API miden cosas distintas.
Si dentro de la transacción llamas a una API externa o hay esperas por bloqueos, el tiempo transcurrido de la transacción puede ser mayor que el tiempo acumulado del SQL. Registrar ambos facilita distinguir si el retraso viene del propio SQL o de otro trabajo dentro de la transacción.