halilcosdu/laravel-slower

어떤 프로젝트인가요?

핵심 기능

• 01DB::listen 훅을 통해 설정 가능한 임계값보다 오래 걸리는 쿼리를 캡처합니다.
• 02반복되는 쿼리 형태를 지문 기준으로 그룹화하고 발생 횟수와 실행 시간을 기록합니다.
• 03각 쿼리를 실행한 라우트, 컨트롤러 액션, 잡 또는 명령과 코드 위치를 기록합니다.
• 04파라미터화된 SQL과 스키마 정보를 OpenAI, Anthropic, Gemini 또는 사용자 지정 드라이버로 보내 권장 사항을 받습니다.
• 05검색, 필터, 클릭 한 번으로 실행하는 AI 분석 기능을 갖춘 대시보드를 제공합니다.
• 06샘플링, 요청별 캡처 한도, 대기열 기반 백그라운드 분석을 지원합니다.

활용 사례

• 성능을 튜닝할 때 Laravel 앱에서 가장 자주 발생하는 느린 쿼리를 찾습니다.
• 각 쿼리에 직접 EXPLAIN을 실행하지 않고 인덱스 및 쿼리 재작성 제안을 받습니다.
• 프로덕션에서 새로운 느린 쿼리 형태가 나타나면 팀에 알립니다.
• 샘플링과 한도를 활용해 트래픽이 많은 환경에서도 느린 쿼리 로그를 계속 수집합니다.

빠른 시작

1. 1

   Composer로 패키지를 설치합니다

   composer require halilcosdu/laravel-slower
2. 2

   마이그레이션을 게시합니다

   php artisan vendor:publish --tag="slower-migrations"
3. 3

   마이그레이션을 실행한 다음 로컬 환경에서 /slower를 엽니다

   php artisan migrate

사용 전 알아둘 점

• !PHP 8.3 이상 및 Laravel 11, 12 또는 13이 필요합니다.
• !AI 추천 기능을 사용하려면 유료 LLM 제공업체의 API 키가 필요하며, 분석을 실행할 때마다 요금이 부과됩니다.
• !viewSlower gate를 정의하기 전까지 대시보드는 기본적으로 로컬 환경에서만 액세스할 수 있습니다.

포함된 컬렉션

토픽

자주 묻는 질문

laravel-slower은(는) 무엇인가요?

느린 DB 쿼리를 수집하고 반복 쿼리를 그룹화한 뒤, LLM으로 인덱스와 쿼리 재작성 방안을 제안하는 대시보드 내장 Laravel 패키지입니다. Laravel Slower는 Laravel의 쿼리 리스너에 연결해 설정한 밀리초 임계값을 초과하는 모든 쿼리를 기록합니다. 이때 바인딩 값, 연결 정보, 쿼리를 실행한 라우트·잡·artisan 명령도 함께 저장합니다. 반복되는 쿼리는 지문을 기준으로 그룹화해 자주 발생하는 느린 쿼리 형태를 먼저 확인할 수 있습니다.

laravel-slower은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

laravel-slower은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

laravel-slower은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. laravel-slower의 마지막 커밋은 2026년 10월 19일입니다.

laravel-slower은(는) 어디에 사용할 수 있나요?

성능을 튜닝할 때 Laravel 앱에서 가장 자주 발생하는 느린 쿼리를 찾습니다. 각 쿼리에 직접 EXPLAIN을 실행하지 않고 인덱스 및 쿼리 재작성 제안을 받습니다. 프로덕션에서 새로운 느린 쿼리 형태가 나타나면 팀에 알립니다. 샘플링과 한도를 활용해 트래픽이 많은 환경에서도 느린 쿼리 로그를 계속 수집합니다.

laravel-slower는 어떻게 설치하나요?

Composer로 패키지를 설치합니다: composer require halilcosdu/laravel-slower 마이그레이션을 게시합니다: php artisan vendor:publish --tag="slower-migrations" 마이그레이션을 실행한 다음 로컬 환경에서 /slower를 엽니다: php artisan migrate

laravel-slower은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/halilcosdu/laravel-slower