Zum Hauptinhalt springen
Wenn Sie langsame Transaktionen untersuchen, reicht die Ausführungszeit von SQL allein nicht aus. Sie müssen auch den Anwendungscode innerhalb der Transaktion und die Wartezeit auf Datenbanksperren betrachten. In Laravel 13.x ruft Connection::whenTransactionRunsLongerThan einen Callback auf, wenn die gesamte Laufzeit einer Transaktion einen festgelegten Schwellenwert überschreitet.
Diese Seite basiert auf der Implementierung in Laravel Framework 13.x. Prüfen Sie, ob Ihre Framework-Version diese Methode enthält.

Callback registrieren

Um die Datenbankverbindungen der gesamten Anwendung zu überwachen, registrieren Sie den Callback in der boot-Methode eines Service Providers. Der Schwellenwert wird in Millisekunden angegeben.
Der Callback erhält drei Argumente.
  • Connection: die überwachte Datenbankverbindung
  • TransactionCommitted|TransactionRolledBack: das Event, das angibt, ob die Transaktion committet oder zurückgerollt wurde
  • float: die gemessene Laufzeit (in Millisekunden)
Wenn Sie einen Verbindungsnamen angeben, etwa DB::connection('mysql'), überwachen Sie nur diese Verbindung. Um mehrere Verbindungen zu überwachen, registrieren Sie für jede Connection einen Callback.

Gemessener Bereich

Die Messung beginnt, wenn die äußere Transaktion startet, und endet, wenn die äußere Transaktion committet oder zurückgerollt wird.
Laravel speichert die Startzeit nur, wenn der Transaction Level von 0 auf 1 steigt. Auch wenn eine innere Transaktion als Savepoint läuft, ist ihre Verarbeitungszeit daher in der Laufzeit der äußeren Transaktion enthalten. Mit diesem Mechanismus lässt sich eine innere Transaktion nicht mit einem eigenen Schwellenwert überwachen. Der Callback wird aufgerufen, nachdem der Transaction Level wieder 0 ist. Wenn der Callback von DB::transaction eine Exception wirft und die Transaktion zurückgerollt wird, erhalten Sie ebenfalls das Event TransactionRolledBack und die gemessene Zeit. Dieselben Events treten auch auf, wenn Sie beginTransaction / commit / rollBack manuell aufrufen.

Schwellenwert angeben

Als erstes Argument von whenTransactionRunsLongerThan können Sie folgende Formen übergeben. In der Regel genügt es, Millisekunden direkt anzugeben. Wenn Sie den Wert lieber in Zeiteinheiten ausdrücken, können Sie CarbonInterval verwenden.
Geprüft wird, ob die Laufzeit größer als der Schwellenwert ist. Ist die Laufzeit genau gleich dem Schwellenwert, wird der Callback nicht aufgerufen. Bei einem Schwellenwert von 0 löst jede gemessene Transaktion den Callback aus.

Von langsamem SQL unterscheiden

Laravel bietet außerdem whenQueryingForLongerThan, das die kumulierte Zeit der innerhalb eines Requests ausgeführten SQL-Abfragen überwacht. Die beiden APIs messen unterschiedliche Dinge. Wenn innerhalb einer Transaktion externe APIs aufgerufen werden oder auf Sperren gewartet wird, kann die Laufzeit der Transaktion größer sein als die kumulierte SQL-Zeit. Wenn Sie beides erfassen, können Sie leichter unterscheiden, ob eine Verzögerung vom SQL selbst oder von anderer Arbeit innerhalb der Transaktion stammt.

Hinweise für den Betrieb

Der Callback wird während der Verarbeitung von Commit oder Rollback aufgerufen. Beschränken Sie ihn daher auf Monitoring. Logs und Metriken sind in Ordnung, aber führen Sie keine weiteren Schreibvorgänge über dieselbe Verbindung und keine langsamen externen Aufrufe aus. Wenn Sie innerhalb einer Transaktion externe APIs aufrufen, wird auch deren Wartezeit mitgemessen. Prüfen Sie, ob Sie externe Aufrufe aus der Transaktion herausverlagern können. Das reduziert nicht nur Benachrichtigungen, sondern verkürzt auch die Dauer, in der Sperren gehalten werden.

Verwendete Primärquellen

Zuletzt geändert am 20. November 2026