로컬 로그 분석기란 무엇인가요?
현대 애플리케이션 로그는 규모가 커서 전체 파일을 한 번에 텍스트 영역에 넣어 확인하는 방식이 비효율적일 때가 많습니다. 실제로는 전체 편집기보다 먼저 형식, 에러 규모, 반복 문제, 타임스탬프 범위를 빠르게 파악하는 초기 분석이 더 중요할 수 있습니다.
로컬 로그 분석기는 그 첫 단계를 브라우저 안에서 처리합니다. 파일을 스트리밍으로 읽고, 로그 레벨과 JSON 행을 집계하며, 반복 메시지를 모아 JSON 보고서로 저장할 수 있습니다. 외부 서비스 업로드는 필요하지 않습니다.
큰 로그는 빠르게 보기 어렵고 외부 업로드도 부담스럽다
운영 또는 스테이징 로그는 매우 클 수 있어 브라우저에서 전체 내용을 한 번에 여는 것이 비효율적입니다.
로그에는 내부 주소, 스택 트레이스, 토큰, 운영 정보가 들어 있을 수 있어 외부 분석 서비스로 보내기 어렵습니다.
JSON 로그는 구조화되어 있어도, 사람이 빠르게 보려면 반복 오류와 시간 분포를 요약해 주는 단계가 필요합니다.
브라우저에서 스트리밍 분석하고 중요한 신호만 먼저 추린다
이 도구는 거대한 로그를 편집기처럼 전부 보여주기보다, 먼저 핵심 분석 정보를 추출하는 데 집중합니다.
일반 텍스트, JSONL, 혼합 로그를 구분하고 총 행 수, 타임스탬프, 로그 레벨, 잘못된 JSON 행을 요약합니다.
덕분에 민감한 로그를 외부로 보내지 않으면서도 초기 디버깅 단계를 더 빠르게 진행할 수 있습니다.
로컬 로그 분석기 사용 방법
- 1로그 파일 열기 - 장치에서 .log, .txt, .jsonl, .ndjson 파일을 선택합니다.
- 2분석 실행 - 브라우저 안에서 스트리밍 분석을 시작합니다.
- 3요약 확인 - 감지된 형식, 총 행 수, JSON 행, 타임스탬프, 로그 레벨 분포를 확인합니다.
- 4반복 패턴 보기 - 자주 반복되는 warning 또는 error를 빠르게 찾습니다.
- 5미리보기 필터 - 타임스탬프, 레벨, 메시지 조각으로 미리보기 행을 검색합니다.
- 6보고서 저장 - JSON 보고서를 다운로드하거나 지원 브라우저에서는 로컬에 바로 저장합니다.
핵심 기능
- 무료 사용
- 로그인 불필요
- 브라우저 내 처리
- 즉시 결과 제공
- 간단한 UI
장점
- 빠른 작업 처리
- 개인정보 보호
- 어떤 기기에서든 사용
- 설치 불필요
활용 사례
로컬 서버 로그 검토
애플리케이션이나 프록시 로그를 외부 서비스 없이 직접 엽니다.
JSON 로그 1차 점검
주요 필드, JSON 행 수, 잘못된 JSON 수를 빠르게 확인합니다.
장애 트리아지
반복 에러와 경고, 시간대 집중 현상을 초기에 파악합니다.
분석 결과 전달
간결한 JSON 보고서를 저장해 다른 엔지니어나 후속 작업에 넘깁니다.
팁과 흔한 실수
팁
- 먼저 이 도구로 전체 상황을 파악한 뒤, 더 깊은 검색이나 디버깅으로 넘어가면 효율적입니다.
- 혼합 로그에서는 유효 JSON과 무효 JSON이 함께 나오는 것이 자연스러울 수 있습니다.
- 반복 패턴은 실제 원인을 가리는 noisy warning이나 recurring error를 찾는 데 유용합니다.
흔한 실수
- 미리보기 표를 전체 로그 원문처럼 해석하는 것.
- 무효 JSON 행만 보고 파일 손상이라고 단정하는 것.
- 로컬 분석으로 충분한데도 민감한 로그를 외부 서비스로 올리는 것.
설명 노트
- 스트리밍 분석은 거대한 로그 전체를 한 번에 여는 것보다 메모리 부담이 낮습니다.
- JSONL은 보통 한 줄에 하나의 JSON 객체지만 실제 로그는 prefix와 stack trace가 섞이기 쉽습니다.
- 반복 패턴 검출은 초기 트리아지를 위한 휴리스틱입니다.
- 민감한 로그의 첫 점검 단계에는 로컬 브라우저 워크플로가 충분히 유효할 수 있습니다.
자주 묻는 질문
로그 파일이 업로드되나요?
아니요. 파일은 장치에 남고 분석은 브라우저 안에서 실행됩니다.
1GB 로그도 가능한가요?
대용량 파일을 위해 스트리밍 방식으로 설계되었지만 실제 속도는 브라우저와 장치 성능에 따라 달라집니다.
JSON 로그를 지원하나요?
네. JSON 행 수, 잘못된 JSON 행, 자주 보이는 JSON 필드를 확인할 수 있습니다.
왜 무효 JSON 행이 생기나요?
혼합 로그에는 prefix, stack trace, fragment가 포함되어 단일 JSON 객체로 파싱되지 않을 수 있습니다.
결과를 저장할 수 있나요?
네. JSON 보고서를 다운로드하거나 지원 브라우저에서는 로컬에 저장할 수 있습니다.
관련 도구
더 알아보기 개발자 도구
로컬 로그 분석기는 개발자 도구 카테고리에 포함됩니다. 다른 무료 온라인 도구도 함께 확인해 보세요.
전체 보기 개발자 도구