[betegon]

When Explore rejects count(span), log min/max(timestamp), or an unsupported function, the current API error gives callers little guidance on recovering within the CLI.

Add dataset-aware hints tied to the explicit --field or --sort expression that reached the request, retaining the backend diagnostic. Log timestamp hints explain that timestamp_precise aggregates return Unix nanoseconds. Unknown failures and invalid defaults or generated metric expressions keep their original API error classification. Queries are neither rewritten nor retried.

Before / after

Counting spans

sentry explore example-org/example-project --dataset spans \
  -F span.op -F 'count(span)' --sort '-count(span)'

Before: the API diagnostic says span is invalid for parameter 1 in count, without explaining the correction.

After: the error identifies --field "count(span)" and dataset spans, preserves the backend detail, and adds:

Use count() to count spans; replace count(span) in --field and any matching --sort. The argument to count is an attribute, not the dataset name.

The caller can retry with:

sentry explore example-org/example-project --dataset spans \
  -F span.op -F 'count()' --sort '-count()'

Finding the earliest log time

sentry explore example-org/ --dataset logs -F 'min(timestamp)'

Before: the API reports that timestamp has the wrong type for min.

After: the error identifies the rejected field and dataset, preserves the backend detail, and adds:

Use min(timestamp_precise) / max(timestamp_precise) for the earliest / latest log time. These return Unix timestamps in nanoseconds, not formatted timestamps.

The caller can retry with:

sentry explore example-org/ --dataset logs -F 'min(timestamp_precise)'

Validation: 15 regression cases covering recovery, error identity, generated input, and pagination state; full repository typecheck and lint; three authenticated read-only API probes confirming the expected validation exit code and recovery messages.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment

Project	Deployment	Actions	Updated
sentry-local	Skipped		Oct 26, 2026 1:28pm UTC