Cheolsu Proxy
  • 한국어

      • 세션 관리

      Cheolsu Proxy에서 캡처된 트래픽 데이터를 세션 단위로 관리하는 방법을 설명합니다.

      세션이란

      세션은 캡처된 HTTP/HTTPS 트래픽 데이터의 논리적인 모음입니다. 하나의 세션에는 프록시가 기록한 요청/응답 트랜잭션이 포함됩니다.

      세션을 활용하면 다음과 같은 작업이 가능합니다:

      • 작업 단위 분리: 서로 다른 디버깅 작업을 별도의 세션으로 관리
      • 트래픽 저장: 분석이 필요한 트래픽을 세션 파일로 저장하여 나중에 다시 확인
      • 공유: 저장된 세션 파일을 팀원에게 공유하여 동일한 트래픽을 함께 분석
      • 비교 분석: 변경 전/후의 트래픽을 각각 세션으로 저장하여 비교

      세션 저장

      캡처된 트래픽을 세션 파일로 저장하여 나중에 다시 불러올 수 있습니다.

      Desktop GUI

      1. 사이드바에서 세션 메뉴로 이동합니다
      2. 세션 저장 버튼을 클릭합니다
      3. 저장 경로와 파일 이름을 지정합니다

      세션 파일에는 캡처 시점의 모든 트랜잭션 데이터(요청, 응답, 헤더, 바디, 타이밍)가 포함됩니다.

      세션 불러오기

      이전에 저장한 세션 파일을 불러와서 트래픽을 다시 확인할 수 있습니다.

      Desktop GUI

      1. 사이드바에서 세션 메뉴로 이동합니다
      2. 세션 불러오기 버튼을 클릭합니다
      3. 저장된 세션 파일을 선택합니다
      4. 불러온 트래픽이 네트워크 대시보드에 표시됩니다

      세션을 불러오면 현재 캡처된 트래픽과 별도로 표시됩니다. 기존 데이터가 덮어씌워지지 않습니다.

      세션 관리

      세션 전환

      여러 세션 사이를 전환하며 작업할 수 있습니다. 세션 목록에서 원하는 세션을 선택하면 해당 세션의 트래픽이 네트워크 대시보드에 표시됩니다.

      세션 삭제

      더 이상 필요하지 않은 세션은 삭제하여 정리할 수 있습니다. 세션 목록에서 삭제할 세션을 선택한 후 삭제를 실행합니다.

      세션 초기화 (트래픽 클리어)

      현재 세션의 캡처된 트래픽 데이터를 모두 지울 수 있습니다. 새로운 디버깅 작업을 시작할 때 이전 트래픽을 깨끗하게 정리하고 싶을 때 사용합니다.

      Desktop GUI

      네트워크 대시보드에서 클리어 버튼을 클릭하면 현재 표시된 모든 트랜잭션이 제거됩니다.

      MCP Server

      MCP Server를 통해서도 트래픽을 초기화할 수 있습니다:

      clear_traffic 도구를 사용하여 캡처된 트래픽 데이터를 초기화합니다.

      자세한 내용은 MCP Server 문서를 참고하세요.

      사용 팁

      메모리 관리

      프록시가 장시간 동작하면 캡처된 트래픽이 계속 쌓여 메모리 사용량이 증가합니다. 다음 방법으로 메모리를 관리하세요:

      • 주기적인 클리어: 분석이 완료된 트래픽은 HAR로 내보내거나 세션으로 저장한 후 클리어합니다
      • 세션 분리: 한 번에 모든 트래픽을 캡처하기보다, 작업 단위로 세션을 나누어 관리합니다
      • 필터 활용: Cheolsu-Query로 관심 있는 트래픽만 표시하면, 전체 데이터가 메모리에 있더라도 분석 작업이 효율적입니다

      효율적인 세션 활용

      • 이슈별 세션: 버그 리포트나 이슈 티켓별로 세션을 만들면, 나중에 관련 트래픽을 쉽게 찾을 수 있습니다
      • 저장 습관: 중요한 트래픽은 분석 즉시 세션으로 저장하세요. 앱 종료나 클리어 시 저장하지 않은 데이터는 복구할 수 없습니다
      • HAR 병행 사용: 세션 파일은 Cheolsu Proxy 전용이지만, HAR 파일은 다른 도구에서도 열 수 있습니다. 팀원이 Cheolsu Proxy를 사용하지 않는다면 HAR 형식으로 공유하세요

      관련 문서