프로젝트 소개
LogWerk는 웹 서버 접근 로그를 분석하기 위한 클라이언트 전용 대시보드입니다. 전체 로그 분석 스택을 설치하거나 데이터를 클라우드 서비스로 업로드하지 않고도 빠르게, 개인적으로 트래픽을 이해해야 하는 개발자, 시스템 관리자, 사이트 운영자를 위해 설계되었습니다.
**핵심 기능**
- HTML5, ES6 모듈, Tailwind CSS, Chart.js를 사용해 100% 브라우저에서 실행 – 서버, 데이터베이스, 외부 API 불필요.
- 일반적인 로그 형식(Nginx/Apache Combined, Extended, vhost_combined, Common) 자동 감지 및 사용자 정의 RegEx 패턴 지원.
- 일반, 회전 또는 gzip 압축 로그 파일(`access.log`, `access.log.1`, `access.log.2.gz`) 직접 로드. Native `DecompressionStream` API로 디컴프레션 수행.
- 청킹 비동기 구문 분석으로 대규모 로그도 UI 동결 없이 처리.
- 대화형 분석: 시간별 트래픽, 상태 코드 분포, 상위 경로, IP, 브라우저, OS, 리퍼러, 콘텐츠 타입 분해, 히트맵 등.
- 고급 봇 감지: 70개 이상 크롤러(검색엔진, AI 봇, SEO 도구, 소셜 미디어 미리보기, 보안 스캐너) 식별, 제공사 및 목적 분류, "Humans Only" 토글 포함.
- 공통 공격 패턴,_SUSPECT_IP_, 실패한 로그인, 외부 사이트에서 발생한 404를 플래그 처리하는 보안 탭.
- 오프라인 Geo-IP 조회, 세션 재구성(IP + User-Agent 기준 요청 그룹화), 상세 요청 검사기.
- IP, 경로, 상태, 리퍼러, 사용자 에이전트, HTTP 메서드 등 강력한 필터링 및 검색; 결과는 CSV로 내보내기의 가능.
- IndexedDB를 통한 지속성 – 마지막으로 로드된 로그가 캐시되어 페이지 새로고침 시 복원.
- 다국어 UI(영어, 독일어, 프랑스어, 스페인어, 이탈리아어, 우크라이나어) 및 라이트/다크 테마 지원.
**시작하기**
모던 브라우저는 `file://`에서 모듈 로딩을 차단하므로, 간단한 정적 서버로 폴더를 제공합니다(예: `python3 -m http.server 8000`, `npx serve`, `php -S localhost:8000`). 서빙되는 URL을 열고 로그 파일을 드래그 앤 드롭하면 생성된 대시보드를 탐색할 수 있습니다.
**기술 스택**
- Tailwind CSS v3 (유틸리티 퍼스트 스타일링)
- Chart.js v4 (캔버스 기반 차트)
- Google Fonts (Inter / Outfit)
모든 자산은 기본적으로 CDN에서 로드되지만, 완전한 오프라인 빌드를 위해 vendoring 가능합니다.
**라이선스**
LogWerk는 MIT License로 출시되어 자유로운 사용, 수정, 배포를 허용합니다.
요약하면, LogWerk는 무거운 로그 분석 솔루션에 대한 빠르고 프라이버시를 존중하는 대안을 제공하며, Raw 접근 로그를 브라우저 내에서 직접 실행 가능한 인사이트로 변환합니다.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.