---
url: https://docs.ogmabox.com/fr/app/ws-sse-history.md
description: >-
  Examiner les connexions WebSocket, les messages et les événements envoyés par
  le serveur dans Ogma.
---

# Historique WebSocket et SSE {#websocket-and-sse-history}

L’historique WS / SSE capture toutes les connexions WebSocket et tous les flux d'événements envoyés par le serveur (Server-Sent Events) qui transitent par le proxy. Il permet d'examiner les messages individuellement, de les filtrer par contenu ou par direction et de les envoyer à Rejeu WebSocket.

## Liste des connexions {#connections-list}

Le panneau de gauche répertorie toutes les connexions capturées.

| Colonne | Description |
|--------|-------------|
| Hôte | Hôte distant de cette connexion. |
| Chemin | Chemin utilisé pour le passage à WebSocket ou pour le flux d'événements. |
| Messages | Nombre total de messages (WebSocket) ou d'événements (SSE). |
| Début (Started) | Horodatage de l'établissement de la connexion. |
| Fin (Ended) | Horodatage de la fermeture de la connexion ; vide si elle est encore ouverte. |
| TLS | Indique si la connexion utilisait TLS. |

Cliquez sur une connexion pour ouvrir sa liste de messages.

## Filtrer les connexions {#filtering-connections}

Utilisez la barre de filtres au-dessus de la liste des connexions pour restreindre l'affichage.

* **Hôte** : recherche une sous-chaîne dans la colonne des hôtes.
* **Chemin** : recherche une sous-chaîne dans la colonne des chemins.
* **TLS** : affiche uniquement les connexions TLS ou sans TLS.
* **Dans le périmètre** : affiche uniquement les connexions dont l'hôte correspond au périmètre actuel.
* **StreamQL** : saisissez une expression StreamQL pour effectuer un filtrage structuré.

Cliquez sur le bouton **IA** à côté du champ StreamQL pour générer une requête à partir d'une description en langage naturel.

## Liste des messages {#message-list}

La sélection d'une connexion ouvre ses messages dans le panneau central.

| Colonne | Description |
|--------|-------------|
| N° | Numéro de séquence, commençant à 1 pour le premier message de la connexion. |
| Sens | `C->S` pour les messages du client vers le serveur, `S->C` pour ceux du serveur vers le client. |
| Code d’opération | Code d'opération WebSocket : `text`, `binary`, `ping`, `pong` ou `close`. Les entrées SSE affichent le nom de l'événement. |
| Taille | Taille de la charge utile en octets. |
| Horodatage (Time) | Horodatage absolu du message. |
| Delta | Temps écoulé depuis le message précédent sur cette connexion. |

## Filtrer les messages {#filtering-messages}

Utilisez la barre de filtres au-dessus de la liste des messages.

* **Sens** : affiche uniquement les messages du client vers le serveur ou du serveur vers le client.
* **Code d’opération** : filtre par codes d'opération précis, par exemple pour n'afficher que `ping`/`pong` afin de déboguer le maintien de la connexion, ou pour les masquer et réduire le bruit.
* **Contenu** : recherche une sous-chaîne dans la charge utile.
* **StreamQL** : expression de requête structurée.

## Examiner un message {#inspecting-a-message}

Cliquez sur la ligne d'un message pour ouvrir sa charge utile dans le panneau d'inspection.

* L'onglet **Formaté** présente le JSON avec coloration syntaxique et des nœuds repliables.
* L'onglet **Brut** affiche les octets non modifiés de la charge utile.
* Les trames binaires sont affichées en hexadécimal, accompagnées d'une interprétation UTF-8 lorsque c'est possible.
* Les trames de fermeture incluent le code de statut et le motif extraits de la charge utile.

## Envoyer un message à Rejeu WebSocket {#sending-a-message-to-ws-replay}

Faites un clic droit sur la ligne d'un message et choisissez **Envoyer au rejeu WebSocket** pour l'ouvrir dans Rejeu WebSocket. La requête de négociation de la connexion est utilisée pour établir la connexion de rejeu.

Depuis Rejeu WebSocket, vous pouvez modifier la charge utile et la renvoyer, ou injecter de nouveaux messages dans une connexion active.

## Exporter les messages WebSocket {#exporting-ws-messages}

1. Sélectionnez la connexion dans la liste des connexions.
2. Ouvrez la commande d'export des messages.
3. Choisissez **JSON** ou **CSV**.
4. Enregistrez le fichier.

L'export comprend le numéro de séquence, la direction, le code d'opération, l'horodatage et la charge utile de chaque message.

Utilisez **Exporter en CSV** au-dessus de la liste des connexions pour exporter les métadonnées des connexions plutôt que les charges utiles des messages. Une connexion capturée et une session Rejeu WebSocket sont des enregistrements distincts ; les réponses aux messages rejoués figurent dans la chronologie de Rejeu WebSocket, et non dans cette liste d'historique capturé.

## Pages connexes {#related-pages}

* [Rejeu](./replay.md)
* [Rejeu WebSocket](./ws-replay.md)
* [Recherche](./search.md)
* [HTTPQL et StreamQL](../reference/httpql.md)