TOOL API
search_ events
Search for events AND perform counts/aggregations - the ONLY tool for statistics and counts. Supports TWO query types: 1. AGGREGATIONS (counts, sums, averages): 'how many errors', 'count of issues', 'total tokens' 2. Individual events with timestamps: 'show me error logs from last hour' USE THIS FOR ALL COUNTS/STATISTICS: - 'how many errors today' → returns count - 'count of database failures' → returns count - 'total number of issues' → returns count - 'average response time' → returns avg() - 'sum of tokens used' → returns sum() ALSO USE FOR INDIVIDUAL EVENTS: - 'error logs from last hour' → returns event list - 'database errors with timestamps' → returns event list - 'trace spans for slow API calls' → returns span list Dataset Selection (AI automatically chooses): - errors: Exception/crash events - logs: Log entries - spans: Performance data, AI/LLM calls, token usage DO NOT USE for grouped issue lists → use search_issues <examples> search_events(organizationSlug='my-org', naturalLanguageQuery='how many errors today') search_events(organizationSlug='my-org', naturalLanguageQuery='count of database failures this week') search_events(organizationSlug='my-org', naturalLanguageQuery='total tokens used by model') search_events(organizationSlug='my-org', naturalLanguageQuery='error logs from the last hour') </examples> <hints> - If the user passes a parameter in the form of name/otherName, it's likely in the format of <organizationSlug>/<projectSlug>. - Parse org/project notation directly without calling find_organizations or find_projects. </hints>
Call information
- Tool slug
- sentry-mcp.search_events
- Provider
- Sentry
- Average response
- 0 ms
- Calls in 7 days
- 0
Input parameters
organizationSlugrequiredThe organization's slug. You can find a existing list of organizations you have access to using the `find_organizations()` tool.
naturalLanguageQueryrequiredNatural language description of what you want to search for
projectSlugThe project's slug. You can find a list of existing projects in an organization using the `find_projects()` tool.
regionUrlThe region URL for the organization you're querying, if known. For Sentry's Cloud Service (sentry.io), this is typically the region-specific URL like 'https://us.sentry.io'. For self-hosted Sentry installations, this parameter is usually not needed and should be omitted. You can find the correct regionUrl from the organization details using the `find_organizations()` tool.
limitMaximum number of results to return
includeExplanationInclude explanation of how the query was translated