Timeline¶
The timeline bar is your control center for navigating through your data. Whether streaming live data or analyzing recordings.
Overview¶
The timeline displays:
- Time Range - Total available data span
- Time Window - Currently visible portion (highlighted)
- Playback Controls - Play/pause for live data
- Navigation Controls - Move through time
Time Window Management¶
Understanding Time Windows¶
The highlighted area between markers represents your viewing window:
- Left Marker - Window start time
- Right Marker - Window end time
- Window Duration - Time span being displayed
- Position - Where the window sits in available data
Synchronized Navigation¶
When multiple panels are present:
- All panels follow the same time window
- Measurements align across panels
- Zoom affects all visualizations
Time Format Display¶
The timeline adapts its format based on zoom level:
Zoom Level | Format | Example |
---|---|---|
Years | YYYY | 2024 |
Months | MMM YYYY | Jan 2024 |
Days | DD MMM | 15 Jan |
Hours | HH : mm | 14:30 |
Minutes | HH : mm : ss | 14:30:45 |
Seconds | HH : mm : ss.SSS | 14:30:45.123 |
Adjusting the Window¶
Resize the Window¶
Drag the markers:
- Left marker - Change start time
- Right marker - Change end time
- Both markers - Maintain duration, change position
Precise adjustment:
- Hover for exact timestamp tooltip
- Hold shift while dragging for fine control
- Double-click marker to enter specific time
Move the Window¶
Three ways to shift the window without changing its size:
- Drag the highlighted area - Click and drag the shaded region
- Use navigation buttons - Click ◀ ▶ arrows
- Keyboard navigation - Use arrow keys
Live Mode Controls¶
Playback Control¶
Control real-time data streaming:
- Play (▶) - Stream live data
- Pause (⏸) - Freeze current view
- Pulsing indicator - Shows active streaming
- Auto-scroll - Timeline follows current time
Quick toggle: Press space to play/pause
Trace Mode Navigation¶
Full Timeline Control¶
When viewing recorded traces:
- Fixed range - Beginning to end of recording
- Instant jump - Click anywhere to navigate
- Scrubbing - Drag to scan through data
- Bookmarks - Mark important moments
Navigation Techniques¶
Keyboard Navigation¶
Action | Windows/Linux | Mac | Description |
---|---|---|---|
Play/Pause | space | space | Toggle data streaming |
Step Left | left | left | Move backward in time |
Step Right | right | right | Move forward |
Mouse Navigation¶
- Click timeline - Jump to time
- Drag markers - Adjust window
- Scroll wheel - Zoom in/out
- Middle-click drag - Pan through time
Next Steps¶
-
Create time-based visualizations
-
Configure timeline behavior