작동 원리 및 구조
원본 입력을 줄 단위로 분리(빈 줄 건너뛰기)한 뒤 각 레코드에 개별적으로 `JSON.parse()`를 실행해 손상된 한 줄이 전체 파싱을 깨뜨리지 않도록 보호합니다. 모든 객체 키를 통합해 표 컬럼을 구성하고 `field:value` 및 부분 문자열 검색 쿼리를 실시간으로 평가합니다.
단계별 사용 방법
상단 편집기에 스트리밍 `.ndjson` 또는 `.jsonl` 로그 줄을 붙여넣습니다.
정상/오류 줄 개수를 확인하고 필요 시 "Hide malformed lines" 옵션을 켜거나 끕니다.
일반 키워드(`timeout`) 또는 컬럼 쿼리(`service:billing status:429`)로 행을 필터링합니다.
`CSV`, `JSON Array`, `NDJSON` 중 출력 형식을 선택해 복사하거나 내보냅니다.
주요 기능 및 장점
- 줄별 독립 JSON 파싱으로 손상된 줄만 빨간색으로 격리 표시해 배치 작업이 중단되지 않음
- 로그마다 키 구성이 달라도 자동으로 스키마 컬럼을 통합해 깔끔한 표로 구성
- 파싱된 컬럼 전반에 대한 즉시 `key:value` 및 자유 텍스트 필터링 지원
- 필터링된 레코드를 표준 CSV, JSON 배열 또는 정제된 NDJSON으로 깔끔하게 내보내기
- 100% 브라우저 로컬 실행: 운영 요청 트레이스, IP 주소, 인증 로그도 외부 유출 없이 안전
계산 방식, 공식 및 기술 표준
세션당 최대 `10,000`개 레코드를 메모리 내에서 처리하며, 공백으로 구분된 `column:substring` AND 조건 필터링과 중첩 객체 셀의 재귀 `JSON.stringify` 표시를 지원합니다.
실제 활용 사례
- 장애 대응 시 JSON 형식 백엔드 로그(`pino`, `winston`, `slog`) 빠르게 점검
- 학습 전 OpenAI / Anthropic 파인튜닝 `.jsonl` 프롬프트 파일 정제 및 미리보기
- 버그 추적을 위해 `status:500` 오류 행만 추출해 CSV 스프레드시트로 정리
- 버퍼 플러시 누락으로 중간이 잘린 JSON 로그 라인 신속히 찾아내기
입출력 예시 및 엣지 케이스
Mixed Good & Corrupt Stream
4 valid log events + 1 truncated `{malformed json line` 4 valid parsed into columns [ts, level, service, latencyMs, status, msg] + line 4 highlighted inline
Corrupt lines remain visible for debugging until "Hide malformed" is checked.
Targeted Log Export
Filter: `service:worker` -> Format: CSV
CSV table containing only matching worker event rows
Missing optional keys in sparse rows render cleanly as blank CSV cells.
제한 사항 및 정확도 안내
- • 원활한 실시간 필터링 성능을 보장하기 위해 브라우저 입력창 기준 최대 `10,000`줄까지 지원합니다.
- • 로그 컬럼 내부의 중첩 하위 객체는 재귀적 dot 컬럼으로 펼치지 않고 직렬화된 JSON 문자열 형태로 CSV·표 셀에 표시됩니다.
브라우저 로컬 처리 및 개인정보 보호
일반 웹 변환기는 문서나 미디어 파일을 원격 서버에 업로드합니다. NDJSON / JSON Lines 로그 탐색기 & 필터 도구는 현재 브라우저 탭 내부에서만 실행됩니다:
입력 텍스트와 파일은 외부 서버로 전송되지 않고 기기 내에서 로컬로 계산됩니다.
도구에 붙여넣은 파일이나 데이터를 서버에 기록하거나 저장하지 않습니다.
작업 결과는 브라우저 탭 메모리에만 유지되며 탭을 닫거나 초기화하면 즉시 해제됩니다.
자주 묻는 질문 (FAQ)
`.jsonl` 파일 중 한 줄이 잘못된 JSON이면 어떻게 되나요?
배열 전체에 `JSON.parse()`를 거는 방식과 달리 줄마다 독립적으로 파싱하므로, 깨진 줄만 정확한 줄 번호·파서 오류와 함께 표시되고 나머지 정상 줄은 모두 렌더링됩니다.
`key:value` 필터링은 어떻게 동작하나요?
`level:error service:worker`처럼 입력하면 `level`에 `error`가 포함되고 `service`에 `worker`가 모두 포함된 행만 대소문자 구분 없이 일치합니다.
`.ndjson`을 표준 JSON `[...]` 배열로 변환할 수 있나요?
네. 내보내기 드롭다운에서 `JSON Array`를 선택한 뒤 복사 또는 내보내기 버튼을 누르시면 됩니다.
로그에 포함된 IP 주소나 액세스 토큰이 서버로 전송되나요?
절대 아닙니다. 모든 파싱, 필터링, CSV 생성은 사용자 브라우저 내 자바스크립트에서만 실행됩니다.