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의 첫 번째 인수에는 다음 형식을 전달할 수 있습니다.
보통은 밀리초를 직접 지정하면 충분합니다. 시간 단위로 표현하고 싶다면
CarbonInterval을 사용할 수 있습니다.
0으로 하면 측정된 모든 transaction이 callback 대상이 됩니다.
SQL 지연과 구분하기
Laravel에는 하나의 request 안에서 실행된 SQL의 누적 시간을 모니터링하는whenQueryingForLongerThan도 있습니다. 두 API는 측정 대상이 다릅니다.
트랜잭션 안에서 외부 API를 호출하거나 락 대기가 발생하면 SQL 누적 시간보다 트랜잭션 경과 시간이 더 커질 수 있습니다. 두 가지를 모두 기록하면 지연이 SQL 자체 때문인지 트랜잭션 안의 다른 처리 때문인지 구분하기 쉬워집니다.