---
url: https://docs.ogmabox.com/ko/app/ws-sse-history.md
description: Ogma에서 WebSocket 연결, 메시지, 서버 전송 이벤트를 검사합니다.
---

# WebSocket 및 SSE 기록 {#websocket-and-sse-history}

WS/SSE 기록은 프록시를 통과하는 모든 WebSocket 연결과 서버 전송 이벤트(Server-Sent Event) 스트림을 캡처합니다. 개별 메시지를 검사하고, 내용이나 방향으로 필터링하고, 메시지를 WS 재전송으로 보낼 수 있습니다.

## 연결 목록 {#connections-list}

왼쪽 패널에는 캡처된 모든 연결이 나열됩니다.

| 열 | 설명 |
|--------|-------------|
| 호스트 | 이 연결의 원격 호스트. |
| 경로 | 업그레이드 또는 이벤트 스트림 경로. |
| 메시지 | 총 메시지 수(WebSocket) 또는 이벤트 수(SSE). |
| 시작 | 연결이 설정된 시점의 타임스탬프. |
| 종료 | 연결이 닫힌 시점의 타임스탬프. 아직 열려 있으면 빈칸. |
| TLS | 연결이 TLS를 사용했는지 여부. |

연결을 클릭하면 메시지 목록이 열립니다.

## 연결 필터링 {#filtering-connections}

연결 목록 위의 필터 입력란으로 보기를 좁힙니다.

* **호스트** - 호스트 열의 부분 문자열과 일치시킵니다.
* **경로** - 경로 열의 부분 문자열과 일치시킵니다.
* **TLS** - TLS 또는 비 TLS 연결만 표시합니다.
* **점검 범위 내** - 호스트가 현재 점검 범위와 일치하는 연결만 표시합니다.
* **StreamQL** - StreamQL 표현식을 입력하여 구조화된 필터링을 수행합니다.

StreamQL 입력란 옆의 **AI** 버튼을 클릭하여 자연어로 쿼리를 생성합니다.

## 메시지 목록 {#message-list}

연결을 선택하면 중앙 패널에 해당 메시지가 열립니다.

| 열 | 설명 |
|--------|-------------|
| 순번 | 연결의 첫 메시지를 1로 하는 순서 번호. |
| 방향 | `C->S`는 클라이언트에서 서버로, `S->C`는 서버에서 클라이언트로 전송. |
| 옵코드 | WebSocket 옵코드: `text`, `binary`, `ping`, `pong`, `close`. SSE 항목에는 이벤트 이름이 표시됩니다. |
| 크기 | 바이트 단위의 페이로드 크기. |
| 시간 | 메시지의 절대 타임스탬프. |
| 시간 차 | 이 연결의 이전 메시지 이후 경과 시간. |

## 메시지 필터링 {#filtering-messages}

메시지 목록 위의 필터 입력란을 사용합니다.

* **방향** - 클라이언트에서 서버로 또는 서버에서 클라이언트로 보내는 메시지만 표시합니다.
* **옵코드** - 특정 옵코드로 필터링합니다(예: 연결 유지 동작을 디버깅하려면 `ping`/`pong`만 표시하고, 불필요한 항목을 줄이려면 숨깁니다).
* **내용** - 페이로드의 부분 문자열과 일치시킵니다.
* **StreamQL** - 구조화된 쿼리 표현식.

## 메시지 검사 {#inspecting-a-message}

메시지 행을 클릭하면 검사 패널에서 페이로드를 엽니다.

* **서식 정리** 탭은 구문 강조와 접을 수 있는 노드로 JSON을 표시합니다.
* **원문** 탭은 수정되지 않은 페이로드 바이트를 표시합니다.
* 바이너리 프레임은 16진수로 표시되며 가능한 경우 UTF-8 해석이 함께 표시됩니다.
* 닫기 프레임에는 페이로드에서 파싱한 상태 코드와 이유 문구가 포함됩니다.

## 메시지를 WS 재전송으로 보내기 {#sending-a-message-to-ws-replay}

메시지 행을 마우스 오른쪽 버튼으로 클릭하고 **WS 재전송으로 보내기**를 선택하면 WS 재전송에서 메시지를 엽니다. 해당 연결의 핸드셰이크 요청을 사용하여 재전송 연결을 설정합니다.

WS 재전송에서는 페이로드를 수정하여 다시 보내거나 연결 중인 통신에 새 메시지를 삽입할 수 있습니다.

## WS 메시지 내보내기 {#exporting-ws-messages}

1. 연결 목록에서 연결을 선택합니다.
2. 메시지 내보내기 컨트롤을 엽니다.
3. **JSON** 또는 **CSV**를 선택합니다.
4. 파일을 저장합니다.

내보내기에는 각 메시지의 순번, 방향, 옵코드, 타임스탬프, 페이로드가 포함됩니다.

연결 목록 위의 **CSV 내보내기**로 메시지 페이로드 대신 연결 메타데이터를 내보낼 수 있습니다. 캡처된 연결과 WS 재전송 세션은 별도 기록입니다. 재전송 응답은 WS 재전송 타임라인에 속하며 이 캡처 기록 목록에는 속하지 않습니다.

## 관련 페이지 {#related-pages}

* [재전송](./replay.md)
* [WebSocket 재전송](./ws-replay.md)
* [검색](./search.md)
* [HTTPQL과 StreamQL](../reference/httpql.md)