Commands

explore

Query aggregate event data (Explore)

Usage

`sentry explore <target>`

Query aggregate event data (Explore)

Arguments:

Argument	Description
`<target>`	Target: <org>/<project>, <org>/, or <project>. Auto-detected if omitted.

Options:

Option	Description
`-F, --field <field>...`	API field or aggregate (repeatable). E.g., title, "count()", "p50(transaction.duration)"
`-d, --dataset <dataset>`	Dataset to query (errors, spans, metrics, logs) (default: "errors")
`-q, --query <query>`	Search query (Sentry search syntax)
`-s, --sort <sort>`	Sort field (prefix with - for desc, e.g., "-count()")
`-n, --limit <limit>`	Number of rows (1-100) (default: "25")
`-t, --period <period>`	Time range: "7d", "2026-03-01..2026-04-01", ">=2026-03-01" (default: "24h")
`-f, --fresh`	Bypass cache, re-detect projects, and fetch fresh data
`-c, --cursor <cursor>`	Navigate pages: "next", "prev", "first" (or raw cursor string)

All commands support --json for machine-readable output and --fields to select specific JSON fields.

Examples

Top errors (default)

# Top errors in the last 24 hours, scoped to a project
sentry explore my-org/cli

# All projects in an org
sentry explore my-org/

# Bare project slug (searches across orgs)
sentry explore cli

# Auto-detect from DSN/config
sentry explore

Spike analysis

# Errors with user impact for a specific UTC window
sentry explore my-org/cli -F title -F "count()" -F "count_unique(user)" \
  --period "2024-01-15T00:00:00Z/2024-01-16T00:00:00Z"

# Filter by specific error type (combines with auto-injected project filter)
sentry explore my-org/cli -F title -F "count()" \
  -q "error.type:TypeError" --period 1h

Span queries (performance)

# Span operation latency by route
sentry explore my-org/cli -F span.op -F "p50(span.duration)" \
  -F "p95(span.duration)" --dataset spans --period 1h

# Top spans by count
sentry explore my-org/cli -F span.op -F "count()" \
  --dataset spans --sort "-count()"

Metrics

# Custom metric aggregations
sentry explore my-org/cli -F transaction -F "avg(measurements.fcp)" \
  --dataset metrics --period 24h

Logs

# Log severity counts in the last hour
sentry explore my-org/cli -F severity -F "count()" \
  --dataset logs --period 1h

JSON output for scripting

# Pipe to jq for filtering
sentry explore my-org/cli -F title -F "count()" --json | jq '.data[:5]'

# Get raw data for analysis
sentry explore my-org/cli -F title -F "count()" -F "count_unique(user)" \
  --json --limit 100

Target Patterns

Target	Behavior
`<org>/<project>`	Auto-adds `project:<slug>` to query
`<org>/`	All projects in org (no project filter)
`<project>`	Searches for project across all accessible orgs
(omitted)	Auto-detect from DSN/config