Documentation for automated readers A curated documentation index is available at: https://grafana.com/llms.txt
A complete documentation index is available at: https://grafana.com/llms-full.txt These indexes can help with page discovery before fetching individual documents.
This page is also available in Markdown, which may be easier for automated readers
and AI tools to parse than HTML. The Markdown version is available at
https://grafana.com/docs/plugins/grafana-sentry-datasource/latest/query-editor.md, or by sending
Accept: text/markdown to https://grafana.com/docs/plugins/grafana-sentry-datasource/latest/query-editor/. For broader
documentation discovery, the curated index is available at https://grafana.com/llms.txt
and the complete index is available at https://grafana.com/llms-full.txt.
The Sentry field names to fetch. Select from suggested fields or enter custom field names. Default fields: id, title, project, project.id, release, count(), epm(), last_seen(), level, event.type, platform. Tags are auto-completed.
Sort By
(Optional) The sort order for results. Options: Last Seen, Count, Events per minute, Failure rate, Level. You can also enter a custom sort field.
Sort Direction
(Optional) Ascending or Descending. Appears when a sort field is selected.
Limit
(Optional) The maximum number of results to return. Maximum: 100.
Event query examples
event.type:error – Show only error events.
event.type:error level:fatal – Show fatal error events.
event.type:transaction transaction.duration:>5000 – Show transactions slower than 5 seconds.
release:1.2.0 – Show events from a specific release.
tags[browser]:Chrome – Show events from Chrome browsers.
Use the Spans query type to retrieve span data from Sentry. This query type uses the same editor as Events but queries the Sentry spans API and provides span-specific field suggestions.
Field
Description
Query
(Optional) A Sentry search query to filter results. Run with Shift+Enter.
Fields
The span field names to fetch. Default fields: id, span.op, span.description, count(). Span attributes are auto-completed.
Sort By
(Optional) The sort order for results. You can also enter a custom sort field.
Sort Direction
(Optional) Ascending or Descending. Appears when a sort field is selected.
Limit
(Optional) The maximum number of results to return. Maximum: 100.
Span query examples
span.op:db – Show database spans.
span.op:http.client span.description:*api* – Show HTTP client spans with “api” in the description.
Events Stats
Use the Events Stats query type to retrieve time-series data for Sentry events, suitable for graphing trends over time. Results are filtered based on the dashboard time range.
Field
Description
Query
(Optional) A Sentry search query to filter results. Run with Shift+Enter.
Y-axis
(Required) One or more fields to plot on the y-axis. Enter field names and press Enter to add each one.
Group
(Optional) One or more fields or tags to group results by. Enter values and press Enter to add each one.
Sort By
(Optional) A field name to sort results by.
Limit
(Optional) The maximum number of result groups. Maximum: 10.
Events Stats use cases
Error trend monitoring: Set Y-axis to count() and Query to event.type:error to graph error volume over time.
Error rate by release: Set Y-axis to count(), Query to event.type:error, and Group to release to compare error rates across releases.
Transaction performance: Set Y-axis to p95(transaction.duration) to track the 95th percentile response time.
Spans Stats
Use the Spans Stats query type to retrieve time-series data for Sentry spans. This query type uses the same editor as Events Stats but queries the Sentry spans stats API.
Field
Description
Query
(Optional) A Sentry search query to filter results. Run with Shift+Enter.
Y-axis
(Required) One or more fields to plot on the y-axis. Enter field names and press Enter to add each one.
Group
(Optional) One or more fields or tags to group results by. Enter values and press Enter to add each one.
Sort By
(Optional) A field name to sort results by.
Limit
(Optional) The maximum number of result groups. Maximum: 10.
Spans Stats use cases
Database performance: Set Y-axis to p95(span.duration) and Query to span.op:db to track database query performance.
Slow HTTP calls by endpoint: Set Y-axis to avg(span.duration), Query to span.op:http.client, and Group to span.description to identify slow external calls.
Metrics
Use the Metrics query type to retrieve session-based metrics from Sentry, such as crash rates, error rates, and session counts.
Field
Description
Field
(Required) The session metric to query. Options include: session.crash_free_rate, session.crash_rate, session.crashed, session.errored, session.healthy, session.all, session.anr_rate, session.foreground_anr_rate, session.abnormal, count_unique(sentry.sessions.user), and user-specific variants.
Query
(Optional) A Sentry search query to filter results. Run with Shift+Enter.
Group By
(Optional) Group results by environment, project, session.status, or release.
Sort By
(Optional) Sort grouped results by a metric field or release. Appears only when a Group By value other than session.status is set.
Order
(Optional) Sort order: High to low or Low to high. Appears alongside Sort By.
Limit
(Optional) The maximum number of result groups. Default: 5, maximum: 10. Appears alongside Sort By.
Metrics use cases
Crash-free rate monitoring: Set Field to session.crash_free_rate and Group By to release to compare stability across releases.
Session health by environment: Set Field to session.healthy and Group By to environment to compare session health across staging and production.
ANR rate tracking: Set Field to session.anr_rate to monitor Application Not Responding rates on mobile apps.
Stats
Use the Stats query type to retrieve organization-level usage statistics from Sentry, such as event counts and quotas. Results are filtered based on the dashboard time range. The Environments filter is not available for this query type.
Field
Description
Field
(Required) The statistic to trend. Options: sum(quantity) or sum(times_seen).
Category Filter
(Required) The event category to filter by. Options: error, transaction, attachment, default, session, security.
Group By
(Optional) Group results by outcome, reason, or category.
Outcome Filter
(Optional) Filter by one or more outcomes: accepted, filtered, invalid, rate_limited, client_discard, abuse.
Reason Filter
(Optional) A comma-separated list of reasons to filter by.
Interval
(Optional) The time interval for grouping results. Format: [number][unit], where unit is m (minutes), h (hours), d (days), or w (weeks).
Stats use cases
Error quota monitoring: Set Field to sum(quantity), Category Filter to error, and Group By to outcome to track how many errors are accepted, filtered, or rate-limited.
Event consumption by project: Set Field to sum(quantity), Category Filter to error, and filter by specific projects to understand per-project quota usage.
Dropped event tracking: Set Field to sum(quantity), Category Filter to error, and Outcome Filter to rate_limited and client_discard to monitor events your organization is losing.
