# tinker session

## **tinker session**

Manage sessions.

### tinker session export-trace *SESSION_ID*

Export a session's timeline as a Perfetto trace (.pftrace).

Builds a trace of the session's training and sampling requests on the server and downloads it. Open the resulting file in https://ui.perfetto.dev to view the timeline.

**Options:**

- `-o, --output PATH` — Output file path (default: ./`<session-id>`.pftrace)
- `--url-only` — Print the signed download URL instead of downloading the trace

```bash
# Creates ./<session-id>.pftrace
tinker session export-trace <session-id>

# Custom output path
tinker session export-trace <session-id> --output my-session.pftrace

# Just print the signed download URL (expires after about an hour)
tinker session export-trace <session-id> --url-only
```