Connection::whenTransactionRunsLongerThan appelle un callback lorsque la durée totale d’une transaction dépasse le seuil indiqué.
Cette page s’appuie sur l’implémentation de Laravel Framework 13.x. Vérifiez que la version du Framework que vous utilisez inclut cette méthode.
Enregistrer le callback
Pour surveiller les connexions de base de données de toute l’application, enregistrez le callback dans la méthodeboot d’un service provider. Le seuil est exprimé en millisecondes.
Connection: la connexion de base de données surveilléeTransactionCommitted|TransactionRolledBack: l’événement indiquant si la transaction a été validée (commit) ou annulée (rollback)float: la durée mesurée (en millisecondes)
DB::connection('mysql'), vous ne surveillez que cette connexion. Pour surveiller plusieurs connexions, enregistrez un callback sur chaque Connection.
Périmètre de la mesure
La mesure commence au démarrage de la transaction externe et se termine lorsque la transaction externe est validée ou annulée.0 à 1. Ainsi, même lorsqu’une transaction interne fonctionne comme un savepoint, son temps de traitement est inclus dans la durée de la transaction externe. Ce mécanisme ne permet pas de surveiller une transaction interne avec son propre seuil.
Le callback est appelé une fois que le niveau de transaction est revenu à 0. Si le callback de DB::transaction lève une exception et que la transaction est annulée, vous recevez aussi l’événement TransactionRolledBack et la durée mesurée. Les mêmes événements sont émis lorsque vous appelez manuellement beginTransaction / commit / rollBack.
Spécifier le seuil
Le premier argument dewhenTransactionRunsLongerThan accepte les formes suivantes.
En général, indiquer directement des millisecondes suffit. Si vous préférez exprimer le seuil en unités de temps, utilisez
CarbonInterval.
0, chaque transaction mesurée déclenche le callback.
Distinguer d’un SQL lent
Laravel fournit aussiwhenQueryingForLongerThan, qui surveille le temps cumulé du SQL exécuté au cours d’une même requête. Les deux API ne mesurent pas la même chose.
Si la transaction appelle une API externe ou attend des verrous, sa durée peut dépasser le temps SQL cumulé. En enregistrant les deux, vous distinguez plus facilement un retard dû au SQL lui-même d’un retard dû à un autre traitement dans la transaction.