getsentry/sentry

Developer-first error tracking and performance monitoring

Structural Verdict

How Data Flows Through the System

Frontend bootstraps with config from Django, sends API requests through authentication middleware, which routes to endpoint classes that query models and return serialized data to React components for rendering

1. Bootstrap — Frontend fetches initial configuration and user context from /api/client-config/
2. Authentication — Requests pass through authentication layer supporting API keys, tokens, and sessions
3. Authorization — Permission system validates user access to organizations, projects, and resources
4. Endpoint Processing — Base endpoint classes handle request parsing, validation, and business logic
5. Data Serialization — Models are serialized to JSON for API responses using DRF serializers
6. Frontend Rendering — React components consume API data and render UI with error tracking context

System Behavior

How the system actually operates at runtime — where data accumulates, what loops, what waits, and what controls what.

Data Pools

Feedback Loops

• Authentication Retry (retry, balancing) — Trigger: Failed authentication. Action: Retry with different auth method. Exit: Successful auth or max retries.
• Permission Check (circuit-breaker, balancing) — Trigger: Permission denied. Action: Block request and return 403. Exit: Valid permissions.
• Feature Flag Evaluation (polling, balancing) — Trigger: Feature flag check. Action: Evaluate flag state for user/org. Exit: Flag resolved.

Delays & Async Processing

• Bootstrap Loading (async-processing, ~network latency) — Frontend waits for config before initialization
• API Request Processing (async-processing, ~database query + serialization time) — Client waits for response data
• Permission Resolution (async-processing, ~milliseconds) — Request blocked until permissions validated

Control Points

• Feature Flags (feature-flag) — Controls: Access to experimental endpoints and features
• Permission Scopes (runtime-toggle) — Controls: API access levels per user role
• Development Mode (env-var) — Controls: UI development server and hot reload. Default: SENTRY_UI_DEV_ONLY
• Rate Limits (rate-limit) — Controls: API request throttling per endpoint. Default: DEFAULT_RATE_LIMIT_CONFIG

Technology Stack

Key Components

• ActivityItem (component) — Renders activity feed items with avatars, timestamps, and content bubbles static/app/components/activity/item/index.tsx
• ArithmeticBuilder (component) — Interactive UI for building mathematical expressions and queries static/app/components/arithmeticBuilder/index.tsx
• Token (class) — Base class for parsing and representing tokens in arithmetic expressions static/app/components/arithmeticBuilder/token/index.tsx
• ApiClient (class) — Main API client for handling HTTP requests and responses src/sentry/api/__init__.py
• OrganizationEndpoint (class) — Base class for API endpoints that operate within organization context src/sentry/api/bases/organization.py
• ProjectEndpoint (class) — Base class for API endpoints that operate on specific projects src/sentry/api/bases/project.py
• BaseAuthentication (class) — Handles various authentication methods including API keys, tokens, and session auth src/sentry/api/authentication.py
• bootApplication (function) — Initializes the frontend application with configuration data from the backend static/app/bootstrap/index.tsx
• Note (component) — Handles creation, editing, and display of activity notes with mentions support static/app/components/activity/note/index.tsx
• IncidentEndpoint (class) — Base endpoint for incident-related API operations with feature flag protection src/sentry/api/bases/incident.py
• OrganizationEventsEndpoint (class) — Base class for API endpoints that query and process organization event data src/sentry/api/bases/organization_events.py

Configuration

figma.config.json (json)

• codeConnect.label (string, unknown) — default: React
• codeConnect.parser (string, unknown) — default: react
• codeConnect.interactiveSetupFigmaFileUrl (string, unknown) — default: https://www.figma.com/design/eTJz6aPgudMY9E6mzyZU0B/%F0%9F%90%A6-Components?node-id=8157-12490&p=f&t=boeFn5xr6XF6ljEJ-0
• codeConnect.include (array, unknown) — default: **/*.{tsx,jsx}
• codeConnect.paths.@sentry/scraps/* (array, unknown) — default: static/app/components/core/*

vercel.json (json)

• $schema (string, unknown) — default: https://openapi.vercel.sh/vercel.json
• version (number, unknown) — default: 2
• rewrites (array, unknown) — default: [object Object],[object Object],[object Object],[object Object]
• headers (array, unknown) — default: [object Object]
• github.silent (boolean, unknown) — default: true

src/sentry/api/endpoints/organization_events_spans_performance.py (python-dataclass)

• suspect_op_group_columns (list[str], unknown)
• suspect_op_group_sort (list[str], unknown)
• suspect_example_functions (list[str], unknown)

src/sentry/api/endpoints/organization_events_spans_performance.py (python-dataclass)

• id (str, unknown)
• start_timestamp (float, unknown)
• finish_timestamp (float, unknown)
• exclusive_time (float, unknown)
• trace_id (str, unknown)

Related Dashboard Repositories

Frequently Asked Questions

Analyzed on March 31, 2026 by CodeSea. Written by Karolina Sarna.