WebSocket 및 SSE 기록
WS/SSE 기록은 프록시를 통과하는 모든 WebSocket 연결과 서버 전송 이벤트(Server-Sent Event) 스트림을 캡처합니다. 개별 메시지를 검사하고, 내용이나 방향으로 필터링하고, 메시지를 WS 재전송으로 보낼 수 있습니다.
연결 목록
왼쪽 패널에는 캡처된 모든 연결이 나열됩니다.
| 열 | 설명 |
|---|---|
| 호스트 | 이 연결의 원격 호스트. |
| 경로 | 업그레이드 또는 이벤트 스트림 경로. |
| 메시지 | 총 메시지 수(WebSocket) 또는 이벤트 수(SSE). |
| 시작 | 연결이 설정된 시점의 타임스탬프. |
| 종료 | 연결이 닫힌 시점의 타임스탬프. 아직 열려 있으면 빈칸. |
| TLS | 연결이 TLS를 사용했는지 여부. |
연결을 클릭하면 메시지 목록이 열립니다.
연결 필터링
연결 목록 위의 필터 입력란으로 보기를 좁힙니다.
- 호스트 - 호스트 열의 부분 문자열과 일치시킵니다.
- 경로 - 경로 열의 부분 문자열과 일치시킵니다.
- TLS - TLS 또는 비 TLS 연결만 표시합니다.
- 점검 범위 내 - 호스트가 현재 점검 범위와 일치하는 연결만 표시합니다.
- StreamQL - StreamQL 표현식을 입력하여 구조화된 필터링을 수행합니다.
StreamQL 입력란 옆의 AI 버튼을 클릭하여 자연어로 쿼리를 생성합니다.
메시지 목록
연결을 선택하면 중앙 패널에 해당 메시지가 열립니다.
| 열 | 설명 |
|---|---|
| 순번 | 연결의 첫 메시지를 1로 하는 순서 번호. |
| 방향 | C->S는 클라이언트에서 서버로, S->C는 서버에서 클라이언트로 전송. |
| 옵코드 | WebSocket 옵코드: text, binary, ping, pong, close. SSE 항목에는 이벤트 이름이 표시됩니다. |
| 크기 | 바이트 단위의 페이로드 크기. |
| 시간 | 메시지의 절대 타임스탬프. |
| 시간 차 | 이 연결의 이전 메시지 이후 경과 시간. |
메시지 필터링
메시지 목록 위의 필터 입력란을 사용합니다.
- 방향 - 클라이언트에서 서버로 또는 서버에서 클라이언트로 보내는 메시지만 표시합니다.
- 옵코드 - 특정 옵코드로 필터링합니다(예: 연결 유지 동작을 디버깅하려면
ping/pong만 표시하고, 불필요한 항목을 줄이려면 숨깁니다). - 내용 - 페이로드의 부분 문자열과 일치시킵니다.
- StreamQL - 구조화된 쿼리 표현식.
메시지 검사
메시지 행을 클릭하면 검사 패널에서 페이로드를 엽니다.
- 서식 정리 탭은 구문 강조와 접을 수 있는 노드로 JSON을 표시합니다.
- 원문 탭은 수정되지 않은 페이로드 바이트를 표시합니다.
- 바이너리 프레임은 16진수로 표시되며 가능한 경우 UTF-8 해석이 함께 표시됩니다.
- 닫기 프레임에는 페이로드에서 파싱한 상태 코드와 이유 문구가 포함됩니다.
메시지를 WS 재전송으로 보내기
메시지 행을 마우스 오른쪽 버튼으로 클릭하고 WS 재전송으로 보내기를 선택하면 WS 재전송에서 메시지를 엽니다. 해당 연결의 핸드셰이크 요청을 사용하여 재전송 연결을 설정합니다.
WS 재전송에서는 페이로드를 수정하여 다시 보내거나 연결 중인 통신에 새 메시지를 삽입할 수 있습니다.
WS 메시지 내보내기
- 연결 목록에서 연결을 선택합니다.
- 메시지 내보내기 컨트롤을 엽니다.
- JSON 또는 CSV를 선택합니다.
- 파일을 저장합니다.
내보내기에는 각 메시지의 순번, 방향, 옵코드, 타임스탬프, 페이로드가 포함됩니다.
연결 목록 위의 CSV 내보내기로 메시지 페이로드 대신 연결 메타데이터를 내보낼 수 있습니다. 캡처된 연결과 WS 재전송 세션은 별도 기록입니다. 재전송 응답은 WS 재전송 타임라인에 속하며 이 캡처 기록 목록에는 속하지 않습니다.