TECH 으로 돌아가기
TECH HACKER NEWS 6분 읽기 37 READS

캡처 파일만 올리면 장애 원인을 짚어준다 — 오픈소스 PcapAnalyzer 살펴보기

캡처 파일만 올리면 장애 원인을 짚어준다 — 오픈소스 PcapAnalyzer 살펴보기
SOURCE IMAGE · HACKER NEWS

네트워크 장애를 추적할 때 가장 많은 시간을 잡아먹는 일은 결국 패킷 캡처를 열어 한 줄씩 훑어보는 작업이다. Wireshark에 익숙한 엔지니어라도 수십만 패킷 속에서 재전송, 핸드셰이크 실패, 지연 구간을 눈으로 찾아내는 데는 긴 시간이 든다. PcapAnalyzer는 이 과정을 자동화하려는 오픈소스 프로젝트다. .pcap이나 .pcapng 캡처 파일(gzip 압축본 포함)을 업로드하면 무엇이 실패하고 있는지, 왜 그런지, 다음으로 무엇을 확인해야 하는지를 정리해 보여준다. 라이선스는 Apache 2.0이며 현재 상태는 베타다.

셀프 호스팅과 27개 탐지기

이 도구의 핵심 설계 원칙은 '캡처 파일이 네트워크 밖으로 나가지 않는다'는 점이다. 애플리케이션은 사용자의 장비에서 직접 실행되며, 기본적으로 127.0.0.1에만 바인딩된다. 패킷 캡처에는 내부 IP 구조, 인증 흐름, 때로는 민감한 페이로드가 담기기 때문에 외부 SaaS 분석 서비스에 올리기 꺼려지는 경우가 많은데, 셀프 호스팅 방식은 이런 우려를 구조적으로 차단한다.

이름이 가리키는 27개의 '문제 탐지기(problem detector)'가 기능의 중심이다. 각 탐지기가 어떤 임계값으로 어떤 이상을 잡아내는지에 대한 상세한 기술 레퍼런스(JSON 스키마, 탐지기 임계값, 한계, API 오류 코드)는 저장소의 README.es.md 문서에 정리되어 있다. 다만 이 기술 문서가 스페인어로만 제공된다는 점은 한국을 비롯한 비스페인어권 사용자에게는 분명한 진입 장벽이다. 영어권 사용자를 위한 QUICKSTART.md에는 설치, AI 설정, 문제 해결 방법이 담겨 있다.

실행 방식과 AI 연동

설치에는 두 가지 경로가 있다. Docker와 Docker Compose를 이용하는 방식에서는 스크립트가 무작위 액세스 토큰을 한 번만 생성해 보여주고 .env 파일에 저장한 뒤 앱을 띄운다. 빌드가 끝나면 http://localhost:8080에 접속해 우측 상단 'API token' 필드에 토큰을 붙여넣고 캡처를 올리거나, 제공되는 샘플 캡처를 바로 시험해볼 수 있다. Windows에서는 Git Bash나 WSL에서 스크립트를 실행해야 한다. 또 다른 경로는 Python 3.9 이상, Node 20 이상, 그리고 Wireshark와 함께 설치되는 tshark를 직접 갖추는 방식으로, 이 경우 http://localhost:5173에서 동일한 토큰을 입력한다. tshark가 PATH에 없다면 TSHARK_PATH 환경변수로 바이너리 경로를 지정하면 된다.

제품명에 'AI investigation'이 들어가 있듯, 탐지 결과에 대한 조사를 AI로 보조하는 기능도 있다. 다만 개발자는 이 부분을 명확한 보안 주의사항과 함께 안내한다. API가 사용자의 AI 계정을 사용할 수 있으므로, 인증을 거치는 리버스 프록시 없이 앱을 네트워크에 노출해서는 안 된다는 것이다. 로컬 전용 바인딩과 토큰 인증은 그 전제 위에서 의미를 갖는다.

실무에서 어떻게 볼 것인가

한국의 네트워크·인프라 담당자 관점에서 이 도구의 쓸모는 '일차 분류(triage)' 단계에 있다. 장애 신고가 들어왔을 때 재전송이 문제인지, TLS 협상이 깨진 것인지, 특정 구간의 지연인지를 빠르게 좁혀주는 용도라면 Wireshark를 열기 전 단계에서 시간을 아낄 수 있다. 캡처가 내부에 머문다는 점은 금융·공공처럼 데이터 반출 규제가 엄격한 환경에서 특히 현실적인 장점이다.

동시에 한계도 분명히 해둘 필요가 있다. 개발자 스스로 밝히듯 이 소프트웨어는 베타 단계이며, 지금까지 합성 테스트 픽스처와 공개 샘플 캡처로만 검증되었다. 가장 가치 있는 피드백은 '실제 문제를 놓친 캡처'나 '없는 문제를 있다고 보고한 캡처'라고 명시할 만큼, 탐지 정확도는 아직 검증이 진행 중인 상태다. 따라서 탐지 결과를 최종 판단이 아니라 가설로 다루고 원본 패킷으로 교차 확인하는 운용이 바람직하다. 이슈를 제보할 때 실제 자격증명이나 고객 데이터가 담긴 캡처를 그대로 첨부하지 말고 익명화하거나 패턴만 설명하라는 안내도, 패킷 데이터를 다루는 도구를 쓸 때 늘 유념해야 할 기본 수칙을 다시 상기시킨다.

끝으로 라이선스 구조도 참고할 만하다. PcapAnalyzer 본체는 Apache 2.0이지만, 분석의 실제 엔진 역할을 하는 tshark/Wireshark는 GPL 소프트웨어로서 별도 프로그램으로 실행되며 PcapAnalyzer와 함께 배포되지는 않는다. 즉 사용자가 Wireshark를 직접 설치해야 하는 구조이며, 라이선스 경계도 그 지점에서 나뉜다. 사내 도구로 도입을 검토한다면 이 의존 관계와 베타라는 성숙도를 함께 저울질하는 것이 합리적이다.

SOURCE · HACKER NEWS
원문 전체 보기 → https://github.com/sebaandrada-cell/PcapAnalyzer
SHARE
NEXT · CHOOSE

변화를 읽었다면,
내가 만들 수익 구조를 고릅니다.

정보를 더 모으는 데서 멈추지 않고, 광고·외주·판매·중개·구독 중 내 상황에 맞는 출발점을 정해보세요.

21가지 수익 구조 살펴보기 →
처리 중...