---
url: https://docs.ogmabox.com/pt/app/ws-sse-history.md
description: >-
  Inspecione conexões WebSocket, mensagens e eventos enviados pelo servidor no
  Ogma.
---

# Histórico WebSocket e SSE {#websocket-and-sse-history}

Histórico WS/SSE captura todas as conexões WebSocket e fluxos de eventos enviados pelo servidor (Server-Sent Events) que passam pelo proxy, permitindo inspecionar mensagens individuais, filtrar por conteúdo ou direção e enviar mensagens para Reenvio WS.

## Lista de conexões {#connections-list}

O painel esquerdo lista todas as conexões capturadas.

| Coluna | Descrição |
|--------|-------------|
| Host | O host remoto desta conexão. |
| Caminho | O caminho de upgrade ou fluxo de eventos. |
| Mensagens | Contagem total de mensagens (WebSocket) ou eventos (SSE). |
| Início | Timestamp de quando a conexão foi estabelecida. |
| Fim | Timestamp de quando a conexão fechou, ou vazio se ainda estiver aberta. |
| TLS | Se a conexão usou TLS. |

Clique em uma conexão para abrir sua lista de mensagens.

## Filtrar conexões {#filtering-connections}

Use a barra de filtro acima da lista de conexões para restringir a visualização.

* **Host**: correspondência de substring com a coluna de host.
* **Caminho**: correspondência de substring com a coluna de caminho.
* **TLS**: mostrar apenas conexões TLS ou sem TLS.
* **No escopo**: mostrar apenas conexões cujo host corresponde ao escopo atual.
* **StreamQL**: digite uma expressão StreamQL para filtragem estruturada.

Clique no botão **Assistência de IA** ao lado da entrada StreamQL para gerar uma consulta em linguagem natural.

## Lista de mensagens {#message-list}

Selecionar uma conexão abre suas mensagens no painel central.

| Coluna | Descrição |
|--------|-------------|
| Sequência | Número de sequência, começando em 1 para a primeira mensagem da conexão. |
| Direção | `C->S` para cliente para servidor, `S->C` para servidor para cliente. |
| Opcode | Opcode WebSocket: `text`, `binary`, `ping`, `pong` ou `close`. Entradas SSE mostram o nome do evento. |
| Tamanho | Tamanho do payload em bytes. |
| Hora | Timestamp absoluto da mensagem. |
| Delta | Tempo desde a mensagem anterior nesta conexão. |

## Filtrar mensagens {#filtering-messages}

Use a barra de filtro acima da lista de mensagens.

* **Direção**: mostrar apenas mensagens de cliente para servidor ou de servidor para cliente.
* **Opcode**: filtrar por opcodes específicos (por exemplo, mostrar apenas `ping`/`pong` para depurar o comportamento de manutenção da conexão, ou ocultá-los para reduzir o ruído).
* **Conteúdo**: correspondência de substring com o payload.
* **StreamQL**: expressão de consulta estruturada.

## Inspecionar uma mensagem {#inspecting-a-message}

Clique em qualquer linha de mensagem para abrir seu payload no painel de inspeção.

* A aba **Formatado** renderiza JSON com destaque de sintaxe e nós recolhíveis.
* A aba **Bruto** mostra os bytes do payload sem modificação.
* Quadros binários são exibidos em hexadecimal com uma interpretação UTF-8 ao lado quando possível.
* Quadros de fechamento incluem o código de status e a frase de motivo extraídos do payload.

## Enviar uma mensagem para Reenvio WS {#sending-a-message-to-ws-replay}

Clique com o botão direito em qualquer linha de mensagem e escolha **Enviar para Reenvio WS** para abrir a mensagem no Reenvio WS. A requisição de handshake da conexão é usada para estabelecer a conexão de reenvio.

No Reenvio WS, você pode modificar o payload e reenviá-lo ou injetar novas mensagens em uma conexão ativa.

## Exportar mensagens WS {#exporting-ws-messages}

1. Selecione a conexão na lista de conexões.
2. Abra o controle de exportação de mensagens.
3. Escolha **JSON** ou **CSV**.
4. Salve o arquivo.

A exportação inclui número de sequência, direção, opcode, timestamp e payload de cada mensagem.

Use **Exportar CSV** acima da lista de conexões para exportar metadados das conexões em vez dos payloads das mensagens. Uma conexão capturada e uma sessão de Reenvio WS são registros separados; as respostas de reenvio pertencem à linha do tempo do Reenvio WS, não a esta lista de histórico capturado.

## Páginas relacionadas {#related-pages}

* [Reenvio](./replay.md)
* [Reenvio WebSocket](./ws-replay.md)
* [Pesquisa](./search.md)
* [HTTPQL e StreamQL](../reference/httpql.md)