---
url: https://docs.ogmabox.com/zh/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。
* **原始**标签页显示未经修改的载荷字节。
* 二进制帧以十六进制显示，并在可能时同时显示 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)