Jetty

Documentation for Jetty

Shared Sessions and Live Presence

Jetty lets multiple team members view the same tunnel simultaneously. Presence indicators show who is watching, making it easy to collaborate on debugging and demos.

How it works

When you open a tunnel's monitor view in Bridge, Jetty tracks your presence automatically. Every few seconds, the dashboard sends a heartbeat that registers you as an active viewer. When you close the tab or navigate away, your presence expires within 15 seconds.

No setup is required. Presence tracking is enabled for all tunnels and all team members.

Live presence indicators

The tunnel monitor view displays avatar circles for everyone currently viewing the tunnel. Each circle shows the team member's profile photo (or their initial if no photo is set). A label below the avatars indicates how many people are watching:

  • 1 viewer: "Alice is viewing"
  • Multiple viewers: "3 people viewing"

Up to 8 avatars are shown inline. Hover over an avatar to see the viewer's name.

Shared session viewing

Multiple team members can open the same tunnel URL at the same time. Everyone sees the same live data:

  • Real-time tunnel status and heartbeat
  • Traffic statistics (requests, bytes in/out)
  • Request samples (if traffic inspection is enabled)
  • Tunnel notes, routing rules, and settings

The dashboard polls for updates every 5 seconds, so all viewers stay in sync without manual refreshing.

Use cases

  • Pair debugging: Two developers watch webhook traffic together while one makes code changes.
  • Client demos: Show a client the tunnel while walking them through the request flow.
  • Incident review: Multiple team members monitor a tunnel during an outage or integration test.
  • Onboarding: Walk a new team member through a live tunnel to explain the architecture.

For people outside your team (or who do not have a Jetty account), use the read-only observer link from the traffic inspector. Observer links:

  • Show the same traffic sample table (read-only)
  • Do not require login
  • Expire after 7 days (signed URL)
  • Do not show presence indicators (observers are anonymous)

To generate an observer link, open a tunnel with traffic inspection enabled and copy the signed URL shown below the sample table.

CLI presence

The CLI participates in presence tracking automatically. Each time jetty share sends a heartbeat to Bridge, it registers the authenticated user as a viewer. The heartbeat response includes a viewers array showing who else is watching:

{
  "data": { ... },
  "viewers": [
    {"id": 1, "name": "Alice", "avatar": null},
    {"id": 2, "name": "Bob", "avatar": "https://..."}
  ]
}

The CLI displays active viewers in its status output so you can see at a glance who is monitoring the same tunnel -- whether from Bridge or another CLI session.

You can also query viewers directly:

GET /api/tunnels/{tunnel}/viewers
Authorization: Bearer YOUR_TOKEN

Returns {"viewers": [...]} with the same format.

Privacy

Presence data is ephemeral. It is stored in the application cache with a 15-second TTL and is never written to the database. Jetty does not track how long a user viewed a tunnel or log presence history.

Only members of the same organization can see each other's presence on a tunnel.

Send feedback

Found an issue or have a suggestion? Let us know.