---
url: https://docs.ogmabox.com/zh-Hant/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)