Connection::whenTransactionRunsLongerThan een callback aan wanneer de totale verstreken tijd van een transactie de opgegeven drempel overschrijdt.
Deze pagina is gebaseerd op de implementatie in Laravel Framework 13.x. Controleer of de Framework-versie die je gebruikt deze methode bevat.
Een callback registreren
Om de databaseverbindingen van de hele applicatie te monitoren, registreer je de callback in deboot-methode van een service provider. De drempel is in milliseconden.
Connection: de gemonitorde databaseverbindingTransactionCommitted|TransactionRolledBack: het event dat aangeeft of de transactie is gecommit of teruggedraaidfloat: de gemeten verstreken tijd (in milliseconden)
DB::connection('mysql'), dan monitor je alleen die verbinding. Om meerdere verbindingen te monitoren, registreer je op elke Connection een callback.
Wat er wordt gemeten
De meting begint wanneer de buitenste transactie start en eindigt wanneer de buitenste transactie wordt gecommit of teruggedraaid.0 naar 1 gaat. Ook als een binnenste transactie als savepoint werkt, telt de verwerkingstijd ervan dus mee in de verstreken tijd van de buitenste transactie. Met dit mechanisme kun je een binnenste transactie niet met een eigen drempel monitoren.
De callback wordt aangeroepen nadat het transaction level weer 0 is. Als de callback van DB::transaction een exception gooit en de transactie wordt teruggedraaid, ontvang je ook het event TransactionRolledBack en de gemeten tijd. Dezelfde events treden op wanneer je beginTransaction / commit / rollBack handmatig aanroept.
De drempel opgeven
Als eerste argument vanwhenTransactionRunsLongerThan kun je de volgende vormen meegeven.
Meestal volstaat het om milliseconden direct op te geven. Wil je de drempel liever in tijdseenheden uitdrukken, dan kun je
CarbonInterval gebruiken.
0 activeert elke gemeten transactie de callback.
Onderscheiden van trage SQL
Laravel heeft ookwhenQueryingForLongerThan, dat de cumulatieve tijd van de SQL binnen één request monitort. De twee API’s meten verschillende dingen.
Als je binnen een transactie een externe API aanroept of op locks wacht, kan de verstreken tijd van de transactie groter zijn dan de cumulatieve SQL-tijd. Door beide vast te leggen, kun je makkelijker onderscheiden of een vertraging door de SQL zelf komt of door ander werk binnen de transactie.