ranetrace-laravel

Ranetrace Laravel은 Laravel 애플리케이션을 Ranetrace 플랫폼에 통합하여 포괄적인 웹 애플리케이션 모니터링을 제공하는 Composer 패키지입니다. 에러 추적, 웹사이트 분석, 중앙집중형 로깅, 모니터링이라는 네 가지 주요 기능을 제공합니다. 에러 추적을 위해 Laravel의 예외 처리기에 연동되어 비처리 예외를 보고하며 수동 에러 캡처도 지원합니다. JavaScript 에러 추적은 Blade 지시문을 통해 window 에러, promise 거부, 콘솔 에러를 탐색 기록(breadcrumbs)과 함께 캡처합니다. 이벤트 추적은 프라이버시 우선 데이터 처리와 함께 사용자 정의 이벤트 및 이커머스 구매를 지원합니다. 웹사이트 분석은 자동으로 등록되는 미들웨어를 사용해 광범위한 봇 및 크롤러 필터링과 함께 페이지 방문을 추적합니다. 클라이언트 사이드 스크립트나 쿠키가 필요 없으며, 방문자는 소금 추가 원방향 해시로만 식별됩니다. 중앙집중형 로깅은 ranetrace 로그 채널을 등록하여 기존 Laravel 로그 채널과 병렬로 사용할 수 있으며, notice 이상 수준의 로그를 캡처합니다. 패키지에는 캡처한 텔레메트리를 로컬 버퍼에 저장해 배치 단위로 Ranetrace에 전송하는 scheduled artisan 명령어(ranetrace:work)가 포함되어 있습니다. Ranetrace가 호스팅하는 MCP 서버는 AI 에이전트가 오류를 조사하고 모니터 판정을 에디터에서 직접 읽을 수 있게 합니다. 연결은 정적 토큰이 아닌 OAuth 승인을 사용하며 단일 웹사이트에 스코프됩니다. 읽기 전용 및 쓰기 가능한 연결은 별도로 지원됩니다. /ranetrace 경로에서 로컬 진단 대시보드를 확인할 수 있어 버퍼 상태, 구성 현황, 파이프라인 상태를 검사할 수 있습니다. 기본값은 로컬 환경에만 접근이 제한되며, Gate 정의를 통해 확장이 가능합니다.