Socket.IO Debugging

Debug Socket.IO connections, including the Engine.IO transport layer, namespaces, rooms, and event-based messaging.

Creating a Socket.IO session

1. Navigate to Realtime in the dashboard
2. Click New Session
3. Select Socket.IO as the protocol
4. Enter the server URL (e.g., https://my-app.com)
5. Optionally configure:
   • Namespace — the Socket.IO namespace to connect to (default: /)
   • Auth parameters — authentication data sent during the handshake
   • Transport — force polling or websocket (default: auto-upgrade)
6. Click Connect

Inspecting events

The dashboard displays Socket.IO events in real time:

Event stream

• Event name — the Socket.IO event name (e.g., message, chat:new, custom events)
• Direction — emitted (outgoing) or received (incoming)
• Data — the event payload
• Timestamp — when the event occurred
• Acknowledgment — whether the event expects an ack callback

Engine.IO details

View the underlying Engine.IO transport:

• Transport type — polling or WebSocket
• Upgrade events — when the connection upgrades from polling to WebSocket
• Ping/pong — heartbeat messages

Sending events

Emit custom events from the dashboard:

1. Enter the event name
2. Enter the payload (JSON)
3. Click Emit

Use cases

• Debug Socket.IO servers — inspect events without writing client code
• Namespace testing — verify namespace-specific event routing
• Auth debugging — test authentication handshakes
• Transport issues — diagnose polling-to-WebSocket upgrade failures