Sentry Server

Overview

The Sentry server provides comprehensive error tracking and performance monitoring capabilities. Built by Sentry, this server enables AI assistants to access error data, manage issues, analyze performance traces, and help teams maintain healthy applications.

Getting Started

1. 1
   Connect to Sentry

   Add the Sentry server to your Civic environment through the server directory.

2. 2
   Authenticate with Sentry

   Connect your Sentry account using OAuth to access your organizations and projects.

3. 3
   Test Connection

   Start with whoami to verify authentication and find organizations to see your available data.

What You Can Do

Error Tracking

Monitor, analyze, and resolve application errors and exceptions across projects

Performance Monitoring

Analyze traces, identify bottlenecks, and optimize application performance

Issue Management

Assign issues, update status, and manage the resolution workflow

Team Collaboration

Create teams, find projects, and coordinate error resolution efforts

Use Cases

Error Investigation & Resolution

• Issue Analysis: Get detailed stacktraces, error context, and affected user data
• Root Cause Analysis: Analyze error patterns and identify common failure points
• Resolution Tracking: Update issue status, assign to team members, and track fixes
• Event Attachments: Access screenshots, log files, and diagnostic data

Performance Optimization

• Trace Analysis: Examine detailed performance traces and identify slow operations
• Bottleneck Detection: Find database queries, API calls, and operations causing delays
• Resource Monitoring: Track memory usage, response times, and throughput metrics
• Trend Analysis: Search events and perform aggregations to understand patterns

Release Management

• Release Tracking: Monitor which versions contain specific errors
• Deployment Analysis: Compare error rates between releases and environments
• Version Health: Identify problematic releases and plan rollbacks
• Environment Comparison: Analyze differences between staging and production

Team Management

• Organization Setup: Manage organizations and access controls
• Team Creation: Set up teams for different projects and responsibilities
• Project Discovery: Find and organize projects across your organization
• Workflow Management: Assign issues and track resolution progress

---

Available Tools (12)

Authentication & Discovery (4 tools)

Essential tools for authentication and exploring your Sentry environment.

Account & Organization Management

whoami

Identify the authenticated user and get account information

• Use Cases: Verify authentication, get user ID for assignments

find_organizations

List all organizations you have access to in Sentry

• Use Cases: Discover available organizations, get organization slugs

find_teams

List teams within a specific organization

• Parameters: organizationSlug (required), regionUrl (optional)

find_projects

List projects within a specific organization

• Parameters: organizationSlug (required), regionUrl (optional)

info

Organization Slugs: Found via find_organizations, these are required for most other operations.

Error & Issue Management (3 tools)

Comprehensive tools for managing and resolving application issues.

get_issue_details

Get detailed information about specific issues including stacktraces and context

• Input Methods: Issue ID (e.g., 'PROJECT-123'), Issue URL, or event ID
• Use Cases: Analyze specific errors, understand failure context

update_issue

Change issue status, assignment, and resolution state

• Status Options: resolved, resolvedInNextRelease, unresolved, ignored
• Assignment: Assign to users ('user:123') or teams ('team:456')

get_event_attachment

Download attachments from events (screenshots, logs, diagnostic files)

• Parameters: organizationSlug, projectSlug, eventId, attachmentId
• Use Cases: Access diagnostic data, screenshots, and log files

warning

When updating issues, use numeric IDs for assignment (e.g., 'user:123456' or 'team:789').

Performance & Monitoring (2 tools)

Advanced tools for performance analysis and application monitoring.

get_trace_details

Analyze performance traces with span breakdown and statistics

• Input: Trace ID (32-character hex string)
• Output: High-level overview, span details, performance metrics

search_events

The primary tool for statistics and event search - supports both aggregations and individual events

• Aggregation Queries: "how many errors this week", "count of timeouts"
• Event Search: "show me errors from last hour", "find database exceptions"
• Natural Language: Use plain English to describe what you're looking for

note

Trace IDs: 32-character hexadecimal strings (e.g., 'a4d1aae7216b47ff8117cf4e09ce9d0a').

Release & Team Management (3 tools)

Tools for managing releases, teams, and organizational structure.

find_releases

List and search releases across projects

• Parameters: organizationSlug (required), projectSlug, query (optional)
• Use Cases: Find recent releases, check deployment status

create_team

Create new teams for organizing projects and responsibilities

• Parameters: organizationSlug (required), name (required)
• Use Cases: Set up teams for new projects, organize development efforts

tip

Release Management: Use find_releases with query parameters to search for specific version patterns.

---

Configuration Requirements

Authentication Setup

The Sentry server uses OAuth2 authentication with Sentry's API:

Authentication Flow

1. OAuth Authorization: Authenticate via Sentry's OAuth flow
2. Organization Access: Ensure you have appropriate permissions in target organizations
3. API Permissions: Verify your account has API access enabled
4. Regional URLs: Some operations may require region-specific URLs

Required Permissions

• Read Access: View issues, events, traces, and project data
• Write Access: Update issues, create teams (if using management tools)
• Organization Access: Access to organizations you want to monitor
• Project Access: View and manage specific projects

Best Practices

Error Investigation Workflow

1. Start with Search: Use search_events with natural language queries to find relevant errors
2. Get Issue Details: Use get_issue_details for specific issues that need investigation
3. Analyze Context: Review stacktraces, user context, and related events
4. Track Resolution: Use update_issue to assign, resolve, or prioritize issues

Performance Monitoring

1. Trace Analysis: Use get_trace_details for specific slow requests or transactions
2. Pattern Detection: Use search_events for performance aggregations and trends
3. Release Comparison: Compare performance across releases using find_releases
4. Bottleneck Identification: Focus on spans with high duration or error rates

Team Collaboration

1. Organization Setup: Use find_organizations and find_teams to understand structure
2. Project Discovery: Use find_projects to map applications and ownership
3. Issue Assignment: Use update_issue with team assignments for collaborative resolution
4. Status Tracking: Maintain clear issue status to track resolution progress

warning

Always verify organization and project slugs using the discovery tools before performing operations on specific resources.

---

Guardrails

In addition to the 14 universal guardrails, this server has 15 server-specific guardrails across 12 operations.

Guardrail	Operation	Timing	Description
Analyze Issue - Allowed Projects Only	analyze_issue_with_seer	Request	Restricts AI issue analysis to issues from whitelisted projects
Create DSN - Allowed Projects Only	create_dsn	Request	Restricts DSN creation to whitelisted projects
Block Project Creation	create_project	Request	Prevents project creation operations entirely
Block Team Creation	create_team	Request	Prevents team creation operations entirely
Find DSNs - Allowed Projects Only	find_dsns	Request	Restricts DSN discovery to whitelisted projects
Find Projects - Allowed Projects Only	find_projects	Response	Filters project list to show only whitelisted projects
Find Releases - Allowed Projects Only	find_releases	Response	Filters release list to show only releases from whitelisted projects
Find Teams - Allowed Teams Only	find_teams	Response	Filters team list to show only whitelisted teams
Get Issue Details - Allowed Projects Only	get_issue_details	Request	Restricts issue detail access to issues from whitelisted projects
Search Issues - Allowed Projects Only	search_issues	Response	Filters issue search results to whitelisted projects only
Update Issue - Allowed Projects Only	update_issue	Request	Restricts issue updates to issues from whitelisted projects
Update Project - Allowed Projects Only	update_project	Request	Restricts project updates to whitelisted projects
Allowed Organizations Only	(all operations)	Request	Restricts Sentry access to whitelisted organizations across all operations
Allowed Projects Only (By Slug)	(all operations)	Request	Restricts access to whitelisted Sentry projects by projectSlug parameter
Allowed Projects Only (By Slug or ID)	(all operations)	Request	Restricts access to whitelisted Sentry projects by projectSlugOrId parameter

tip

Configure guardrails via the Civic UI or ask the Configurator Agent: "Add guardrails to my Sentry server."