Session Recording

Recording Overview

Session recording captures everything that appears in your terminal, including commands, output, and timing information. Recordings can be played back to see exactly what happened during a session.

Use Cases

• Documentation - Record procedures for reference or training
• Troubleshooting - Review past sessions to diagnose issues
• Compliance - Maintain audit trails of privileged access
• Training - Create tutorials and demonstrations
• Incident Response - Capture sessions during incidents

What's Recorded

• All terminal output (commands and responses)
• Timing information for accurate playback
• Terminal dimensions at each point
• Session metadata (host, user, timestamps)

Starting a Recording

Manual Recording

1. Connect to a device
2. Click the record button in the status bar, or use Cmd/Ctrl+Shift+R
3. Optionally enter a description for the recording
4. The status bar will show a red recording indicator
5. Click the record button again to stop, or use Cmd/Ctrl+Shift+R

Auto-Recording

Configure sessions to automatically record every time you connect:

1. Open session settings (right-click tab → Session Settings)
2. Navigate to Recording
3. Enable Auto-record sessions
4. Optionally configure retention settings

Recording Settings

Playback

Opening a Recording

1. Go to File → Recordings
2. Browse or search for the recording
3. Double-click to open in the player

Player Controls

Search in Playback

Use Cmd/Ctrl+F to search within a recording. Search results show timestamps where the text appears, and you can click to jump to that point.

Managing Recordings

Recording Library

Access all recordings from File → Recordings. The library shows:

• Recording name and description
• Session host and user
• Date and duration
• File size

Organizing Recordings

Recordings can be organized with:

• Folders - Create folders to group related recordings
• Tags - Add tags for cross-cutting organization
• Favorites - Star important recordings for quick access

Exporting Recordings

Export recordings in various formats:

• Asciicast (.cast) - Standard format, compatible with asciinema
• Text Log (.log) - Plain text transcript
• HTML (.html) - Self-contained playable HTML file
• GIF (.gif) - Animated GIF for sharing

# Export to GIF example:
# 1. Open recording
# 2. File → Export → GIF
# 3. Configure options:
#    - Output file: my-session.gif
#    - Speed: 1x
#    - Quality: High
#    - Max width: 800px
# 4. Click Export

Enterprise Recording

When connected to a Controller, session recordings can be stored centrally for compliance and auditing.

Centralized Storage

• Recordings are uploaded to the Controller automatically
• Configurable retention policies per organization
• Searchable from the Admin UI
• Access controlled by user roles

Mandatory Recording

Administrators can enforce mandatory recording for specific:

• Device types (e.g., all production routers)
• Users or roles
• Connection methods (SSH proxy only)

Audit Integration

Enterprise recordings are linked to audit logs, providing:

• Who accessed which device and when
• Full session recording for review
• Command-level indexing for search
• Integration with SIEM systems