sentry trace list

List recent traces in a Sentry project

Usage

sentry trace list [<org>/<project>]

List recent traces from Sentry projects.

Target Specification

sentry trace list               # auto-detect from DSN or config
sentry trace list <org>/<proj>  # explicit org and project
sentry trace list <project>     # find project across all orgs

Flags

--limit · number · default: "20"

Number of traces to retrieve (1-1000)

Alias: -n

--query · string

Search query using Sentry search syntax to filter traces

Alias: -q

--sort · string · default: "date"

Sort order for traces. Valid values:

• date - Most recent first (default)
• duration - Slowest first

Alias: -s

--cursor · string

Pagination cursor. Use last to continue from the last page.

The cursor is automatically saved between invocations, allowing you to paginate through results.

Alias: -c

--json · boolean · default: "false"

Output as JSON

Examples

List last 20 traces

sentry trace list

Show more traces

sentry trace list --limit 50

Sort by slowest first

sentry trace list --sort duration

Filter by transaction name

sentry trace list -q "transaction:GET /api/users"

Paginate through results

# First page
sentry trace list --limit 100

# Next page
sentry trace list -c last

Output as JSON

sentry trace list --json

Output

Human-readable format

Displays a table with:

• Trace ID (first 8 characters)
• Transaction name
• Duration
• Timestamp

Footer shows pagination info and next page command.

JSON format

Returns an object with:

• data - Array of trace objects
• nextCursor - Cursor for the next page (if available)
• hasMore - Boolean indicating if more results exist

Notes

• The cursor is automatically persisted between invocations
• Pagination state is keyed by org/project and active filter flags (sort, query)
• Use sentry trace view <TRACE_ID> to view the full span tree for a specific trace